Compartir vía

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

  • Artículo

En este inicio rápido, aprenderá a crear una aplicación de consola de .NET para generar imágenes mediante un modelo openAI o Azure OpenAI DALLe AI, diseñado específicamente para generar imágenes basadas en mensajes de texto.

Requisitos previos

  • SDK de .NET 8.0: Instalación del SDK de .NET 8.0.
  • Una clave de API de OpenAI para poder ejecutar este ejemplo.
  • En Windows, se requiere PowerShell v7+. Para validar la versión, ejecute pwsh en un terminal. Debe devolver la versión actual. Si devuelve un error, ejecute el siguiente comando: dotnet tool update --global PowerShell.

Requisitos previos

Nota

También puede usar kernel semántico para realizar las tareas de este artículo. El kernel semántico es un SDK ligero y de código abierto que permite crear agentes de inteligencia artificial e integrar los modelos de IA más recientes en las 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

Complete los pasos siguientes para crear una aplicación de consola de .NET para conectarse a un modelo de IA.

  1. En un directorio vacío del equipo, use el comando dotnet new para crear una nueva aplicación de consola:

    dotnet new console -o ImagesAI

  2. Cambie el directorio a la carpeta de la aplicación:

    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 .

Creación del 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 credenciales de autenticación desde las 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 de IA.
    • Crea un ImageClient para conectarse al modelo de IA
    • Envía un mensaje al modelo que describe la imagen deseada.
    • Imprime la dirección URL de la imagen generada en la salida de la consola.

  2. Use el comando dotnet run para ejecutar la aplicación:

    dotnet run

    Vaya a la dirección URL de la imagen en la salida de la consola para ver la imagen generada. Personalice el contenido de texto del mensaje para crear nuevas imágenes o modificar el 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