Skip to content

Add hosting integration section to text-to-image quickstart #49896

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Nov 21, 2025
Merged

Add hosting integration section to text-to-image quickstart #49896

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
6a9cdfb
Initial plan
Copilot Nov 14, 2025
38c8190
Add hosting integration section to text-to-image article with code ex…
Copilot Nov 14, 2025
8b5da8e
Update docs/ai/quickstarts/text-to-image.md
gewarren Nov 14, 2025
3b9828b
Apply suggestions from code review
gewarren Nov 14, 2025
1e6f6e8
human edits 2
gewarren Nov 19, 2025
b8f1c23
respond to feedback
gewarren Nov 21, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions docs/ai/quickstarts/snippets/text-to-image/hosting/Program.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@

// <SnippetAddImageGenerator>
// Register the image generator with dependency injection.
builder.Services.AddImageGenerator(services =>
ImageGeneratorBuilder imageBuilder = builder.Services.AddImageGenerator(services =>
{
OpenAIClient openAiClient = services.GetRequiredService<OpenAIClient>();
OpenAI.Images.ImageClient imageClient = openAiClient.GetImageClient("gpt-image-1");
Expand All @@ -21,18 +21,20 @@
});
// </SnippetAddImageGenerator>

// <SnippetConfigureOptions>
imageBuilder.ConfigureOptions(options =>
{
options.MediaType = "image/png";
}).UseLogging();
// </SnippetConfigureOptions>

WebApplication 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"
};

ImageGenerationResponse response = await generator.GenerateImagesAsync(prompt, options);
ImageGenerationResponse response = await generator.GenerateImagesAsync(prompt);
DataContent dataContent = response.Contents.OfType<DataContent>().First();

return Results.File(dataContent.Data.ToArray(), "image/png");
Copy link
Member

@ericstj ericstj Nov 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I missed on my first review, but this might slightly better:

    return Results.File(dataContent.Data.ToArray(), dataContent.MediaType);

Copy link
Member

@ericstj ericstj Nov 21, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'll submit a PR.

Expand Down
9 changes: 9 additions & 0 deletions docs/ai/quickstarts/text-to-image.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -136,6 +136,15 @@ The `Aspire.Azure.AI.OpenAI` package provides extension methods to register Azur

The <xref:Microsoft.Extensions.DependencyInjection.ImageGeneratorBuilderServiceCollectionExtensions.AddImageGenerator*> method registers the image generator as a singleton service that can be injected into controllers, services, or minimal API endpoints.

1. Add options and logging::

:::code language="csharp" source="snippets/text-to-image/hosting/Program.cs" id="SnippetConfigureOptions":::

The preceding code:

- Configures options by calling the <xref:Microsoft.Extensions.AI.ConfigureOptionsImageGeneratorBuilderExtensions.ConfigureOptions(Microsoft.Extensions.AI.ImageGeneratorBuilder,System.Action{Microsoft.Extensions.AI.ImageGenerationOptions})> extension method on the <xref:Microsoft.Extensions.AI.ImageGeneratorBuilder>. This method configures the <xref:Microsoft.Extensions.AI.ImageGenerationOptions> to be passed to the next generator in the pipeline.
- Adds logging to the image generator pipeline by calling the <xref:Microsoft.Extensions.AI.LoggingImageGeneratorBuilderExtensions.UseLogging(Microsoft.Extensions.AI.ImageGeneratorBuilder,Microsoft.Extensions.Logging.ILoggerFactory,System.Action{Microsoft.Extensions.AI.LoggingImageGenerator})> extension method.

### Use the image generator in endpoints

Once registered, you can inject `IImageGenerator` into your endpoints or services:
Expand Down