Add hosting integration section to text-to-image quickstart

docs/ai/quickstarts/snippets/text-to-image/hosting/TextToImageHosting/Program.cs

@@ -0,0 +1,41 @@
+// <SnippetSetup>
+using Microsoft.Extensions.AI;
+using OpenAI;
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add the Azure OpenAI client using hosting integration
+var openai = builder.AddAzureOpenAIClient("openai");
+// </SnippetSetup>
+
+// <SnippetAddImageGenerator>
+// Register the image generator with dependency injection
+builder.Services.AddImageGenerator(services =>
+{
+    var openAiClient = services.GetRequiredService<OpenAIClient>();
+    var imageClient = openAiClient.GetImageClient("gpt-image-1");
+    #pragma warning disable MEAI001 // Type is for evaluation purposes only.
+    return imageClient.AsIImageGenerator();
+    #pragma warning restore MEAI001
+});
+// </SnippetAddImageGenerator>
+
+var app = builder.Build();
+
+// <SnippetUseImageGenerator>
+// Use the image generator in an endpoint
+app.MapPost("/generate-image", async (IImageGenerator generator, string prompt) =>
+{
+    var options = new ImageGenerationOptions
+    {
+        MediaType = "image/png"
+    };
+
+    var response = await generator.GenerateImagesAsync(prompt, options);
+    var dataContent = response.Contents.OfType<DataContent>().First();
+
+    return Results.File(dataContent.Data.ToArray(), "image/png");
+});
+// </SnippetUseImageGenerator>
+
+app.Run();

docs/ai/quickstarts/snippets/text-to-image/hosting/TextToImageHosting/Properties/launchSettings.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json.schemastore.org/launchsettings.json",
+  "profiles": {
+    "http": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "http://localhost:5219",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "https": {
+      "commandName": "Project",
+      "dotnetRunMessages": true,
+      "launchBrowser": true,
+      "applicationUrl": "https://localhost:7210;http://localhost:5219",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

docs/ai/quickstarts/snippets/text-to-image/hosting/TextToImageHosting/TextToImageHosting.csproj

@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>net9.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <NoWarn>$(NoWarn);MEAI001</NoWarn>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Aspire.Azure.AI.OpenAI" Version="13.0.0-preview.1.25560.3" />
+    <PackageReference Include="Azure.AI.OpenAI" Version="2.5.0-beta.1" />
+    <PackageReference Include="Microsoft.Extensions.AI.OpenAI" Version="10.0.0-preview.1.25560.10" />
+  </ItemGroup>
+
+</Project>

docs/ai/quickstarts/snippets/text-to-image/hosting/TextToImageHosting/appsettings.Development.json

@@ -0,0 +1,8 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  }
+}

docs/ai/quickstarts/snippets/text-to-image/hosting/TextToImageHosting/appsettings.json

@@ -0,0 +1,12 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Information",
+      "Microsoft.AspNetCore": "Warning"
+    }
+  },
+  "AllowedHosts": "*",
+  "ConnectionStrings": {
+    "openai": "Endpoint=https://your-resource-name.openai.azure.com/;Key=your-api-key"
+  }
+}

docs/ai/quickstarts/text-to-image.md

@@ -100,6 +100,56 @@ You can customize image generation by providing other options such as size, resp
 - <xref:Microsoft.Extensions.AI.ImageGenerationOptions.RawRepresentationFactory>: The callback that creates the raw representation of the image generation options from an underlying implementation.
 - <xref:Microsoft.Extensions.AI.ImageGenerationOptions.ResponseFormat>: Options are <xref:Microsoft.Extensions.AI.ImageGenerationResponseFormat.Uri>, <xref:Microsoft.Extensions.AI.ImageGenerationResponseFormat.Data>, and <xref:Microsoft.Extensions.AI.ImageGenerationResponseFormat.Hosted>.
 
+## Use hosting integration
+
+When building web applications or hosted services, you can integrate image generation using dependency injection and hosting patterns. This approach provides better lifecycle management, configuration integration, and testability.
+
+### Configure hosting services
+
+The `Aspire.Azure.AI.OpenAI` package provides extension methods to register Azure OpenAI services with your application's dependency injection container:
+
+1. Add the necessary packages to your web application:
+
+   ```dotnetcli
+   dotnet add package Aspire.Azure.AI.OpenAI --prerelease
+   dotnet add package Azure.AI.OpenAI
+   dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
+   ```
+
+1. Configure the Azure OpenAI client and image generator in your `Program.cs` file:
+
+   :::code language="csharp" source="snippets/text-to-image/hosting/TextToImageHosting/Program.cs" id="SnippetSetup":::
+
+   The `AddAzureOpenAIClient` method registers the Azure OpenAI client with dependency injection. The connection string (named `"openai"`) is retrieved from configuration, typically from `appsettings.json` or environment variables:
+
+   ```json
+   {
+     "ConnectionStrings": {
+       "openai": "Endpoint=https://your-resource-name.openai.azure.com/;Key=your-api-key"
+     }
+   }
+   ```
+
+1. Register the `IImageGenerator` service with dependency injection:
+
+   :::code language="csharp" source="snippets/text-to-image/hosting/TextToImageHosting/Program.cs" id="SnippetAddImageGenerator":::
+
+   The `AddImageGenerator` method registers the image generator as a singleton service that can be injected into controllers, services, or minimal API endpoints.
+
+### Use the image generator in endpoints
+
+Once registered, you can inject `IImageGenerator` into your endpoints or services:
+
+:::code language="csharp" source="snippets/text-to-image/hosting/TextToImageHosting/Program.cs" id="SnippetUseImageGenerator":::
+
+This hosting approach provides several benefits:
+
+- **Configuration management**: Connection strings and settings are managed through the .NET configuration system.
+- **Dependency injection**: The image generator is available throughout your application via DI.
+- **Lifecycle management**: Services are properly initialized and disposed of by the hosting infrastructure.
+- **Testability**: Mock implementations can be easily substituted for testing.
+- **Integration with .NET Aspire**: When using .NET Aspire, the `AddAzureOpenAIClient` method integrates with service discovery and telemetry.
+
 ## Best practices
 
 When implementing text-to-image generation in your applications, consider these best practices: