feat(genai): add image generation samples (1)

genai/api/GenAI.Samples.Tests/ImageGeneration/ImageGenMultimodalFlashLocaleAwareWithTxtTest.cs

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using System.IO;
+using System.Threading.Tasks;
+using Xunit;
+
+[Collection(nameof(GenAIFixture))]
+public class ImageGenMultimodalFlashLocaleAwareWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ImageGenMultimodalFlashLocaleAwareWithTxt _sample;
+
+    public ImageGenMultimodalFlashLocaleAwareWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ImageGenMultimodalFlashLocaleAwareWithTxt();
+    }
+
+    [Fact]
+    public async Task TestImgGenMmFlashLocaleAwareWithTxt()
+    {
+        FileInfo response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotNull(response);
+        Assert.True(response.Length > 0);
+    }
+}

genai/api/GenAI.Samples.Tests/ImageGeneration/ImageGenMultimodalFlashMultipleImgsWithTxtTest.cs

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Xunit;
+
+[Collection(nameof(GenAIFixture))]
+public class ImageGenMultimodalFlashMultipleImgsWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ImageGenMultimodalFlashMultipleImgsWithTxt _sample;
+
+    public ImageGenMultimodalFlashMultipleImgsWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ImageGenMultimodalFlashMultipleImgsWithTxt();
+    }
+
+    [Fact]
+    public async Task TestImgGenMmFlashMultipleImgsWithTxt()
+    {
+        List<string> response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotEmpty(response);
+    }
+}

genai/api/GenAI.Samples.Tests/ImageGeneration/ImageGenMultimodalFlashWithTxtTest.cs

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using System.IO;
+using System.Threading.Tasks;
+using Xunit;
+
+[Collection(nameof(GenAIFixture))]
+public class ImageGenMultimodalFlashWithTxtTest
+{
+    private readonly GenAIFixture _fixture;
+    private readonly ImageGenMultimodalFlashWithTxt _sample;
+
+    public ImageGenMultimodalFlashWithTxtTest(GenAIFixture fixture)
+    {
+        _fixture = fixture;
+        _sample = new ImageGenMultimodalFlashWithTxt();
+    }
+
+    [Fact]
+    public async Task TestImgGenMmFlashWithTxt()
+    {
+        FileInfo response = await _sample.GenerateContent(_fixture.ProjectId);
+        Assert.NotNull(response);
+        Assert.True(response.Length > 0);
+    }
+}

genai/api/GenAI.Samples/ImageGeneration/ImageGenMultimodalFlashLocaleAwareWithTxt.cs

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [START googlegenaisdk_imggen_mmflash_locale_aware_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading.Tasks;
+
+public class ImageGenMultimodalFlashLocaleAwareWithTxt
+{
+    public async Task<FileInfo> GenerateContent(
+        string projectId = "your-project-id",
+        string location = "global",
+        string model = "gemini-2.5-flash-image")
+    {
+        await using var client = new Client(project: projectId, location: location, vertexAI: true);
+
+        GenerateContentResponse response = await client.Models.GenerateContentAsync(
+            model: model,
+            contents: "Generate a photo of a breakfast meal.",
+            config: new GenerateContentConfig { ResponseModalities = new List<string> { "TEXT", "IMAGE" } });
+
+        var outputFilename = "example-breakfast-meal.png";
+        FileInfo fileInfo = null;
+
+        List<Part> parts = response.Candidates?[0]?.Content?.Parts ?? new List<Part>();
+
+        foreach (Part part in parts)
+        {
+            if (!string.IsNullOrEmpty(part.Text))
+            {
+                Console.WriteLine(part.Text);
+            }
+            else if (part.InlineData?.Data != null)
+            {
+                File.WriteAllBytes(outputFilename, part.InlineData.Data);
+                fileInfo = new FileInfo(Path.GetFullPath(outputFilename));
+                Console.WriteLine($"Created output image using {fileInfo.Length} bytes");
+            }
+        }
+        // Example response:
+        // Here's a photo of a breakfast meal:
+        //
+        // Created output image using 1369476 bytes
+        return fileInfo;
+    }
+}
+// [END googlegenaisdk_imggen_mmflash_locale_aware_with_txt]

genai/api/GenAI.Samples/ImageGeneration/ImageGenMultimodalFlashMultipleImgsWithTxt.cs

@@ -0,0 +1,64 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [START googlegenaisdk_imggen_mmflash_multiple_imgs_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading.Tasks;
+
+public class ImageGenMultimodalFlashMultipleImgsWithTxt
+{
+    public async Task<List<string>> GenerateContent(
+        string projectId = "your-project-id",
+        string location = "global",
+        string model = "gemini-2.5-flash-image")
+    {
+        await using var client = new Client(project: projectId, location: location, vertexAI: true);
+
+        GenerateContentResponse response = await client.Models.GenerateContentAsync(
+            model: model,
+            contents: "Generate 3 images of a cat sitting on a chair.",
+            config: new GenerateContentConfig { ResponseModalities = new List<string> { "TEXT", "IMAGE" } });
+
+        List<Part> parts = response.Candidates?[0]?.Content?.Parts ?? new List<Part>();
+
+        var generatedFiles = new List<string>();
+        int imageCounter = 1;
+
+        foreach (Part part in parts)
+        {
+            if (!string.IsNullOrEmpty(part.Text))
+            {
+                Console.WriteLine(part.Text);
+            }
+            else if (part.InlineData?.Data != null)
+            {
+                var filename = $"example-cats-0{imageCounter}.png";
+                File.WriteAllBytes(filename, part.InlineData.Data);
+                generatedFiles.Add(filename);
+                imageCounter++;
+            }
+        }
+        // Example response:
+        // Here are three images of cats sitting on chairs.
+        return generatedFiles;
+    }
+}
+// [END googlegenaisdk_imggen_mmflash_multiple_imgs_with_txt]

genai/api/GenAI.Samples/ImageGeneration/ImageGenMultimodalFlashWithTxt.cs

@@ -0,0 +1,80 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [START googlegenaisdk_imggen_mmflash_with_txt]
+
+using Google.GenAI;
+using Google.GenAI.Types;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading.Tasks;
+
+public class ImageGenMultimodalFlashWithTxt
+{
+    public async Task<FileInfo> GenerateContent(
+        string projectId = "your-project-id",
+        string location = "global",
+        string model = "gemini-2.5-flash-image")
+    {
+        await using var client = new Client(project: projectId, location: location, vertexAI: true);
+
+        var contentConfig = new GenerateContentConfig
+        {
+            ResponseModalities = new List<string> { "TEXT", "IMAGE" },
+            CandidateCount = 1,
+            SafetySettings = new List<SafetySetting>
+            {
+                new SafetySetting
+                {
+                    Method = HarmBlockMethod.PROBABILITY,
+                    Category = HarmCategory.HARM_CATEGORY_DANGEROUS_CONTENT,
+                    Threshold = HarmBlockThreshold.BLOCK_MEDIUM_AND_ABOVE
+                }
+            }
+        };
+
+        GenerateContentResponse response = await client.Models.GenerateContentAsync(
+            model: model,
+            contents: "Generate an image of the Eiffel tower with fireworks in the background.",
+            config: contentConfig);
+
+        var outputFile = "example-image-eiffel-tower.png";
+        FileInfo fileInfo = null;
+
+        List<Part> parts = response.Candidates?[0]?.Content?.Parts ?? new List<Part>();
+
+        foreach (Part part in parts)
+        {
+            if (!string.IsNullOrEmpty(part.Text))
+            {
+                Console.WriteLine(part.Text);
+            }
+            else if (part.InlineData?.Data != null)
+            {
+                File.WriteAllBytes(outputFile, part.InlineData.Data);
+                fileInfo = new FileInfo(Path.GetFullPath(outputFile));
+                Console.WriteLine($"Created output image using {fileInfo.Length} bytes");
+            }
+        }
+        // Example response:
+        // Absolutely! Here's the Eiffel Tower with fireworks:
+        // 
+        // Created output image using 1897804 bytes
+        return fileInfo;
+    }
+}
+// [END googlegenaisdk_imggen_mmflash_with_txt]