Gerar imagens usando a IA com o .NET

Neste guia rápido, você aprenderá a criar um aplicativo de console .NET para gerar imagens usando um modelo de IA DALLe da OpenAI ou Azure OpenAI, que são especificamente projetados para gerar imagens com base em prompts de texto.

Clone o repositório de amostra

Você pode criar seu próprio aplicativo usando as etapas nas seções a seguir ou pode clonar o repositório GitHub que contém os aplicativos de exemplo concluídos para todos os inícios rápidos. Se você planeja usar o Azure OpenAI, o repositório de exemplo também será estruturado como um modelo da CLI do Desenvolvedor do Azure que pode provisionar um recurso do Azure OpenAI para você.

git clone https://github.com/dotnet/ai-samples.git

Criar o aplicativo

Conclua as etapas a seguir para criar um aplicativo de console do .NET para se conectar a um modelo de IA.

1. Em um diretório vazio no computador, use o comando dotnet new para criar um novo aplicativo de console:

   dotnet new console -o ImagesAI
   

2. Altere o diretório para a pasta do aplicativo:

   cd ImagesAI
   

3. Instale os pacotes necessários:

   dotnet add package Azure.AI.OpenAI
   dotnet add package Microsoft.Extensions.Configuration
   dotnet add package Microsoft.Extensions.Configuration.UserSecrets
   

   dotnet add package OpenAI
   dotnet add package Microsoft.Extensions.Configuration
   dotnet add package Microsoft.Extensions.Configuration.UserSecrets
   

4. Abra o aplicativo no Visual Studio Code ou no editor de sua escolha.

   code .
   

Adicionar o código do aplicativo

1. No arquivo Program.cs, adicione o código a seguir para se conectar e autenticar ao modelo de IA.

   using Microsoft.Extensions.Configuration;
   using OpenAI.Images;
   using System.ClientModel;
   using Azure.AI.OpenAI;
   using Azure.Identity;
   
   // Retrieve the local secrets saved during the Azure deployment. If you skipped the deployment
   // because you already have an Azure OpenAI available, edit the following lines to use your information,
   // e.g. string openAIEndpoint = "https://cog-demo123.openai.azure.com/";
   var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
   string endpoint = config["AZURE_OPENAI_ENDPOINT"];
   string deployment = config["AZURE_OPENAI_DALLE_NAME"];
   
   // Create the Azure OpenAI ImageClient
   ImageClient client =
       new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential())
           .GetImageClient(deployment);
   
   // Generate the image
   GeneratedImage generatedImage = await client.GenerateImageAsync("""
       A postal card with an happy hiker waving and a beautiful mountain in the background.
       There is a trail visible in the foreground.
       The postal card has text in red saying: 'You are invited for a hike!'
       """, new ImageGenerationOptions { Size = GeneratedImageSize.W1024xH1024 });
   
   Console.WriteLine($"The generated image is ready at:\n{generatedImage.ImageUri}");
   

   Nota

   DefaultAzureCredential pesquisa credenciais de autenticação de suas ferramentas locais. Se você não estiver usando o modelo de azd para provisionar o recurso do Azure OpenAI, precisará atribuir a função Azure AI Developer à conta usada para entrar no Visual Studio ou na CLI do Azure. Para obter mais informações, consulte Autenticar-se nos serviços de IA do Azure com .NET.

   // Licensed to the .NET Foundation under one or more agreements.
   // The .NET Foundation licenses this file to you under the MIT license.
   // See the LICENSE file in the project root for more information.
   using Microsoft.Extensions.Configuration;
   using OpenAI.Images;
   // Retrieve the local secrets that were set from the command line, using:
   // dotnet user-secrets init
   // dotnet user-secrets set OpenAIKey <your-openai-key>
   var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
   string key = config["OpenAIKey"];
   string modelName = config["ModelName"];
   
   // Create the OpenAI ImageClient
   ImageClient client = new(modelName, key);
   
   // Generate the image
   GeneratedImage generatedImage = await client.GenerateImageAsync("""
       A postal card with a happy hiker waving and a beautiful mountain in the background.
       There is a trail visible in the foreground.
       The postal card has text in red saying: 'You are invited for a hike!'
       """,
       new ImageGenerationOptions 
       {
           Size = GeneratedImageSize.W1024xH1024 
       });
   
   Console.WriteLine($"The generated image is ready at:\n{generatedImage.ImageUri}");
   

   O código anterior:

   • Lê valores de configuração essenciais dos segredos do usuário do projeto para se conectar ao modelo de IA
   • Cria um ImageClient para se conectar ao modelo de IA
   • Envia um prompt para o modelo que descreve a imagem desejada
   • Imprime a URL da imagem gerada na saída do console

2. Use o comando dotnet run para executar o aplicativo:

   dotnet run
   

   Navegue até a URL da imagem na saída do console para exibir a imagem gerada. Personalize o conteúdo do texto do prompt para criar novas imagens ou modificar o original.

azd down

Próximas etapas

• Início Rápido - Criar um aplicativo de chat de IA com o .NET
• Gerar texto e conversas com Conclusões do .NET e do OpenAI do Azure