Compartir a través de


Generación de imágenes mediante IA con .NET

En este Inicio rápido, aprenderás a crear una app de consola .NET para generar imágenes utilizando un modelo OpenAI o Azure OpenAI DALLe AI, que están específicamente diseñados para generar imágenes basadas en indicaciones de texto.

Requisitos previos

Requisitos previos

Nota:

También puede usar kernel semántico para realizar las tareas de este artículo. Semantic Kernel es un SDK ligero y de código abierto que te permite crear agentes de IA e integrar los últimos modelos de IA en tus aplicaciones .NET.

Clonación del repositorio de ejemplo

Puede crear su propia aplicación siguiendo los pasos descritos en las secciones siguientes, o bien puede clonar el repositorio de GitHub que contiene las aplicaciones de ejemplo completadas para todas las guías de inicio rápido. Si planea usar Azure OpenAI, el repositorio de ejemplo también se estructura como una plantilla de la CLI para desarrolladores de Azure que puede aprovisionar un recurso de Azure OpenAI automáticamente.

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

Creación de la aplicación

Siga los siguientes pasos para crear una aplicación de consola .NET que se conecte a un modelo de IA.

  1. En un directorio vacío de su ordenador, utilice el comando dotnet new para crear una nueva aplicación de consola:

    dotnet new console -o ImagesAI
    
  2. Cambia el directorio a la carpeta app:

    cd ImagesAI
    
  3. Instale los paquetes necesarios:

    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 la aplicación en Visual Studio Code o en el editor que prefiera.

    code .
    

Crear el servicio de IA

El repositorio de GitHub de ejemplo se estructura como una plantilla de Azure Developer CLI (azd), que azd puede usar para aprovisionar automáticamente el servicio y el modelo de Azure OpenAI.

  1. Desde un terminal o símbolo del sistema, vaya al src\quickstarts\azure-openai directorio del repositorio de ejemplo.

  2. Ejecute el comando azd up para aprovisionar los recursos de Azure OpenAI. Puede tardar varios minutos en crear el servicio Azure OpenAI e implementar el modelo.

    azd up
    

    azd también configura los secretos de usuario necesarios para la aplicación de ejemplo, como el punto de conexión de Azure OpenAI y el nombre del modelo.

Configuración de la aplicación

  1. Vaya a la raíz de su proyecto de .NET desde una terminal o línea de comandos.

  2. Ejecute los siguientes comandos para configurar la clave de API de OpenAI como un secreto para la aplicación de ejemplo:

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

Adición del código de la aplicación

  1. En el archivo Program.cs, agregue el código siguiente para conectarse y autenticarse en el 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 busca las credenciales de autenticación de sus herramientas locales. Si no usa la plantilla de azd para aprovisionar el recurso de Azure OpenAI, deberá asignar el rol de Azure AI Developer a la cuenta que usó para iniciar sesión en Visual Studio o en la CLI de Azure. Para obtener más información, consulte Autenticación de Servicios de Azure AI con .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}");
    

    El código anterior:

    • Lee los valores de configuración esenciales de los secretos de usuario del proyecto para conectarse al modelo AI
    • Crea un ImageClient para conectarse al modelo de IA
    • Envía una solicitud al modelo que describe la imagen deseada
    • Imprime la URL de la imagen generada en la salida de la consola
  2. Use el comando dotnet run para ejecutar la aplicación:

    dotnet run
    

    Navegue a la URL de la imagen en la salida de la consola para ver la imagen generada. Personalice el contenido del texto de la solicitud para crear nuevas imágenes o modificar la original.

Limpieza de recursos

Cuando ya no necesite la aplicación o los recursos de ejemplo, quite la implementación correspondiente y todos los recursos.

azd down

Pasos siguientes