Compartilhar via

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.

Pré-requisitos

Pré-requisitos

Observação

Você também pode usar o Kernel Semântico para realizar as tarefas neste artigo. O Semantic Kernel é um SDK leve e de código aberto que permite criar agentes de IA e integrar os modelos de IA mais recentes em seus aplicativos .NET.

Criar o aplicativo

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

  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 preferência.

    code .

Criar o serviço de IA

  1. Para provisionar um serviço e um modelo do Azure OpenAI, conclua as etapas no artigo Criar e implantar um recurso do Serviço OpenAI do Azure .

  2. Em um terminal ou prompt de comando, navegue até a raiz do diretório do projeto.

  3. Execute os seguintes comandos para configurar o endpoint do Azure OpenAI e o nome do modelo para o aplicativo de exemplo:

    dotnet user-secrets init
dotnet user-secrets set AZURE_OPENAI_ENDPOINT <your-Azure-OpenAI-endpoint>
dotnet user-secrets set AZURE_OPENAI_GPT_NAME <your-Azure-OpenAI-model-name>

Configurar o aplicativo

  1. Navegue até a raiz do projeto .NET de um terminal ou prompt de comando.

  2. Execute os seguintes comandos para configurar sua chave de API OpenAI como um segredo para o aplicativo de exemplo:

    dotnet user-secrets init
dotnet user-secrets set OpenAIKey <your-OpenAI-key>
dotnet user-secrets set ModelName <your-OpenAI-model-name>

Adicionar o código do aplicativo

  1. Program.cs No arquivo, 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}");

    Observação

    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 OpenAI.Images.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. Execute 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.

Limpar os recursos

Se você não precisar mais deles, exclua o recurso do Azure OpenAI e a implantação do modelo GPT-4.

  1. No Portal do Azure, navegue até o recurso OpenAI do Azure.
  2. Selecione o recurso do Azure OpenAI e selecione Excluir.

Próximas etapas