Modelos de geração de imagens Azure OpenAI

Use este guia para começar a chamar as APIs REST de geração de imagens do Azure OpenAI no Microsoft Foundry Models usando Python.

Pré-requisitos

• Uma subscrição do Azure. Crie um gratuitamente.
• Python versão 3.8 ou posterior.
• As seguintes bibliotecas Python instaladas: os, requests, json.
• Um recurso Azure OpenAI criado numa região suportada. Ver disponibilidade por região.
• Depois, precisas de implementar um modelo em série gpt-image com o teu recurso Azure. Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Configuração

Recuperar chave e endpoint

Para conseguir ligar com sucesso às APIs Azure OpenAI, precisa da seguinte informação sobre o seu recurso Azure OpenAI:

Aceda ao seu recurso no portal Azure. No painel de navegação, selecione Chaves e Endpoint em Gestão de Recursos. Copie o valor do Endpoint e um valor da chave de acesso. Pode usar o valor KEY 1 ou KEY 2 . Ter sempre duas chaves permite alternar e regenerar chaves de forma segura sem causar interrupção no serviço.

Variáveis ambientais

Cria e atribui variáveis persistentes de ambiente para a tua chave e endpoint.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')
[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Criar uma nova aplicação Python

Crie um novo ficheiro de Python chamado quickstart.py. Abre o novo ficheiro no teu editor ou IDE preferido.

1. Substitua o conteúdo da quickstart.py pelo seguinte código. Muda o valor de prompt para o teu texto preferido. Também define deployment para o nome de implementação que escolheste quando implementaste o modelo de geração de imagem.

   import os
   import requests
   import base64
   from PIL import Image
   from io import BytesIO
   
   # set environment variables
   endpoint = os.getenv("AZURE_OPENAI_ENDPOINT")
   subscription_key = os.getenv("AZURE_OPENAI_API_KEY")
   
   deployment = "gpt-image-1.5" # the name of your GPT-image series deployment
   api_version = "2025-04-01-preview" # or later version
   
   def decode_and_save_image(b64_data, output_filename):
     image = Image.open(BytesIO(base64.b64decode(b64_data)))
     image.show()
     image.save(output_filename)
   
   def save_all_images_from_response(response_data, filename_prefix):
     for idx, item in enumerate(response_data['data']):
       b64_img = item['b64_json']
       filename = f"{filename_prefix}_{idx+1}.png"
       decode_and_save_image(b64_img, filename)
       print(f"Image saved to: '{filename}'")
   
   base_path = f'openai/deployments/{deployment}/images'
   params = f'?api-version={api_version}'
   
   generation_url = f"{endpoint}{base_path}/generations{params}"
   generation_body = {
     "prompt": "girl falling asleep",
     "n": 1,
     "size": "1024x1024",
     "quality": "medium",
     "output_format": "png",
     # "background": "transparent",  # "auto" or "transparent" (GPT-image-1 only; requires PNG output)
     # "output_compression": 100,  # 0-100 compression level (JPEG output only)
   }
   generation_response = requests.post(
     generation_url,
     headers={
       'Api-Key': subscription_key,
       'Content-Type': 'application/json',
     },
     json=generation_body
   ).json()
   save_all_images_from_response(generation_response, "generated_image")
   
   # In addition to generating images, you can edit them.
   edit_url = f"{endpoint}{base_path}/edits{params}"
   edit_body = {
     "prompt": "girl falling asleep",
     "n": 1,
     "size": "1024x1024",
     "quality": "medium"
   }
   files = {
     "image": ("generated_image_1.png", open("generated_image_1.png", "rb"), "image/png"),
     # You can use a mask to specify which parts of the image you want to edit.
     # The mask must be the same size as the input image.
     # "mask": ("mask.png", open("mask.png", "rb"), "image/png"),
   }
   edit_response = requests.post(
     edit_url,
     headers={'Api-Key': subscription_key},
     data=edit_body,
     files=files
   ).json()
   save_all_images_from_response(edit_response, "edited_image")
   

   O script faz uma chamada de API de geração de imagem síncrona.

   Importante

   Lembra-te de remover a chave do teu código quando terminares e nunca publicar a chave publicamente. Para produção, utilize uma forma segura de armazenar e aceder às suas credenciais. Para mais informações, veja Azure Key Vault.

2. Execute a aplicação com o python comando:

   python quickstart.py
   

   Espere alguns momentos para receber a resposta.

Produção

A saída de uma chamada de API de geração de imagem bem-sucedida assemelha-se ao seguinte exemplo. O b64_json campo contém os dados de imagem de saída codificados em base64.

{ 
    "created": 1698116662, 
    "data": [ 
        { 
            "b64_json": "<base64 image data>"
        }
    ]
} 

Uma resposta bem-sucedida inclui:

• Um created selo temporal (tempo padrão Unix)
• Um data array com pelo menos um objeto de imagem - Ou um b64_json valor (dados de imagem codificados base64) para cada imagem gerada

Erros comuns

As APIs de Imagem vêm com um filtro de moderação de conteúdos. Se o serviço reconhecer o seu prompt como conteúdo prejudicial, não gera uma imagem. Para mais informações, consulte Filtragem de conteúdo. Para exemplos de respostas a erros, consulte o guia prático de geração de imagens.

O sistema devolve um estado de operação de Failed e o error.code valor na mensagem é definido para contentFilter. Aqui está um exemplo:

{
    "created": 1698435368,
    "error":
    {
        "code": "contentFilter",
        "message": "Your task failed as a result of our safety system."
    }
}

Também é possível que a própria imagem gerada seja filtrada. Neste caso, a mensagem de erro é definida para Generated image was filtered as a result of our safety system.. Aqui está um exemplo:

{
    "created": 1698435368,
    "error":
    {
        "code": "contentFilter",
        "message": "Generated image was filtered as a result of our safety system."
    }
}

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados a ele.

• Portal Azure
• CLI do Azure

Use este guia para começar a gerar imagens com o SDK Azure OpenAI para Python.

Código-fonte da biblioteca | Pacote | Exemplos

Pré-requisitos

• Uma subscrição do Azure. Crie um gratuitamente.
• Python versão 3.8 ou posterior.
• Um recurso Azure OpenAI criado numa região compatível. Ver disponibilidade por região.
  • Acede ao endpoint de recursos do Azure OpenAI e às chaves no portal Azure.
• Um modelo de geração de imagem implementado:
  • Série GPT-image-1: Implementar um modelo da série gpt-image-1. Requer registo de acesso limitado.

Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Configuração

Recuperar chave e endpoint

Para conseguir ligar com sucesso às APIs Azure OpenAI, precisa da seguinte informação sobre o seu recurso Azure OpenAI:

Aceda ao seu recurso no portal Azure. No painel de navegação, selecione Chaves e Endpoint em Gestão de Recursos. Copie o valor do Endpoint e um valor da chave de acesso. Pode usar o valor KEY 1 ou KEY 2 . Ter sempre duas chaves permite alternar e regenerar chaves de forma segura sem causar interrupção no serviço.

Variáveis ambientais

Cria e atribui variáveis persistentes de ambiente para a tua chave e endpoint.

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE" 

[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_API_KEY', 'REPLACE_WITH_YOUR_KEY_VALUE_HERE', 'User')
[System.Environment]::SetEnvironmentVariable('AZURE_OPENAI_ENDPOINT', 'REPLACE_WITH_YOUR_ENDPOINT_HERE', 'User')

export AZURE_OPENAI_API_KEY="REPLACE_WITH_YOUR_KEY_VALUE_HERE"
export AZURE_OPENAI_ENDPOINT="REPLACE_WITH_YOUR_ENDPOINT_HERE"

Instale o SDK Python

Abra um prompt de comandos e navegue até à pasta do seu projeto. Instale o SDK Python da OpenAI usando o seguinte comando:

pip install openai

Instale também as seguintes bibliotecas:

pip install requests
pip install pillow 

Gerar imagens

Criar um novo ficheiro Python, quickstart.py. Abra-o no teu editor ou IDE preferido.

Substitua o conteúdo da quickstart.py pelo seguinte código.

from openai import AzureOpenAI
import os
import base64
from PIL import Image

client = AzureOpenAI(
    api_version="2025-04-01-preview",  
    api_key=os.environ["AZURE_OPENAI_API_KEY"],  
    azure_endpoint=os.environ['AZURE_OPENAI_ENDPOINT']
)

result = client.images.generate(
    model="gpt-image-1", # the name of your GPT-image series deployment
    prompt="a close-up of a bear walking through the forest",
    n=1,
    size="1024x1024",
    quality="high",
    output_format="png",
    # background="transparent",  # Set to "transparent" for transparent backgrounds (GPT-image-1 only; requires PNG)
    # output_compression=100,  # 0-100 compression level (JPEG output only)
)

# Set the directory for the stored image
image_dir = os.path.join(os.curdir, 'images')

# If the directory doesn't exist, create it
if not os.path.isdir(image_dir):
    os.mkdir(image_dir)

# Initialize the image path (note the filetype should be png)
image_path = os.path.join(image_dir, 'generated_image.png')

# GPT-image-1 models always return base64-encoded image data
image_base64 = result.data[0].b64_json
generated_image = base64.b64decode(image_base64)
with open(image_path, "wb") as image_file:
    image_file.write(generated_image)

# Display the image in the default image viewer
image = Image.open(image_path)
image.show()

1. Certifique-se de que as AZURE_OPENAI_ENDPOINT variáveis de ambiente e AZURE_OPENAI_API_KEY estão definidas.
2. Muda o valor de prompt para o teu texto preferido.
3. Mude o valor de model para o nome do seu modelo de série de imagens GPT implementado.

Execute a aplicação com o python comando:

python quickstart.py

Espere alguns momentos para receber a resposta.

Produção

Azure OpenAI armazena a imagem de saída no ficheiro generated_image.png no diretório especificado. O script também mostra a imagem no seu visualizador de imagens predefinido.

Uma resposta bem-sucedida inclui:

• Um created carimbo temporal
• Um data array com pelo menos um objeto imagem
• Um b64_json campo com dados de imagem codificados base64 (modelos GPT-image-1 retornam sempre base64)

Erros comuns

As APIs de Imagem vêm com um filtro de moderação de conteúdos. Se o serviço reconhecer o seu prompt como conteúdo prejudicial, não gera uma imagem. Para mais informações, consulte Filtragem de conteúdo.

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados a ele.

• Portal Azure
• CLI do Azure

Use este guia para começar a gerar imagens com o SDK Azure OpenAI para C#.

código-fonte da biblioteca | Pacote (NuGet) | Exemplos

Pré-requisitos

• Uma subscrição Azure - Crie uma gratuitamente
• O SDK .NET 7
• Um recurso Azure OpenAI criado numa região suportada (ver Disponibilidade de Região). Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Pré-requisitos do Microsoft Entra ID

Para a autenticação sem chave recomendada com o Microsoft Entra ID, precisa:

• Instale o CLI do Azure usado para autenticação sem chave com Microsoft Entra ID.
• Atribui a Cognitive Services User função à tua conta de utilizador. Pode atribuir funções no portal Azure em Controlo de Acesso (IAM)>Adicionar atribuição de funções.

Configuração

1. Crie uma nova pasta image-quickstart e vá à pasta de início rápido com o seguinte comando:

   mkdir image-quickstart && cd image-quickstart
   

2. Crie uma nova aplicação de consola com o seguinte comando:

   dotnet new console
   

3. Instale a biblioteca cliente OpenAI.NET com o comando dotnet add package:

   dotnet add package Azure.AI.OpenAI --version 1.0.0-beta.6
   

4. Para a autenticação sem chave recomendada com Microsoft Entra ID, instale o pacote Azure.Identity com:

   dotnet add package Azure.Identity
   

5. Para a autenticação sem chave recomendada com Microsoft Entra ID, inicie sessão em Azure com o seguinte comando:

   az login
   

Recuperar informação de recursos

Precisa de obter a seguinte informação para autenticar a sua aplicação com o seu recurso Azure OpenAI:

Execute o início rápido

O código de exemplo neste quickstart utiliza o Microsoft Entra ID para a autenticação sem chave recomendada. Se preferir usar uma chave API, pode substituir o DefaultAzureCredential objeto por um AzureKeyCredential objeto.

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 

AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));

Para executar o quickstart, siga estes passos:

1. Substitua o conteúdo de Program.cs pelo seguinte código e atualize os valores provisórios pelos seus próprios.

   using Azure;
   using Azure.AI.OpenAI;
   using OpenAI.Images;
   using static System.Environment;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_ENDPOINT") ?? "https://<your-resource-name>.openai.azure.com/";
   string key = Environment.GetEnvironmentVariable("AZURE_OPENAI_API_KEY") ?? "<your-key>";
   
   // Use the recommended keyless credential instead of the AzureKeyCredential credential.
   AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new DefaultAzureCredential()); 
   //AzureOpenAIClient openAIClient = new AzureOpenAIClient(new Uri(endpoint), new AzureKeyCredential(key));
   
   // This must match the custom deployment name you chose for your model
   ImageClient chatClient = openAIClient.GetImageClient("gpt-image-1");
   
   var imageGeneration = await chatClient.GenerateImageAsync(
           "a happy monkey sitting in a tree, in watercolor",
           new ImageGenerationOptions()
           {
               Size = GeneratedImageSize.W1024xH1024
           }
       );
   
   Console.WriteLine(imageGeneration.Value.ImageUri);
   

2. Execute a aplicação usando o comando dotnet run ou o botão run no topo de Visual Studio:

   dotnet run
   

Produção

Os dados da imagem codificados em base64 são impressos na consola.

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes apagar o recurso. Antes de eliminar o recurso, deve primeiro eliminar quaisquer modelos implementados.

• Portal Azure
• CLI do Azure

Use este guia para começar a gerar imagens com o Azure OpenAI SDK para Java.

Código-fonte da biblioteca | Artifact (Maven) | Amostras

Pré-requisitos

• Uma subscrição Azure - Crie uma gratuitamente
• A versão atual do Kit de Desenvolvimento Java (JDK)
• Instala Apache Maven.
• Um recurso Azure OpenAI criado numa região suportada (ver Disponibilidade de Região). Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Pré-requisitos do Microsoft Entra ID

Para a autenticação sem chave recomendada com o Microsoft Entra ID, precisa:

• Instale o CLI do Azure usado para autenticação sem chave com Microsoft Entra ID.
• Atribui a Cognitive Services User função à tua conta de utilizador. Pode atribuir funções no portal Azure em Controlo de Acesso (IAM)>Adicionar atribuição de funções.

Configuração

1. Crie uma nova pasta image-quickstart e vá à pasta de início rápido com o seguinte comando:

   mkdir image-quickstart && cd image-quickstart
   

2. Instala Apache Maven. Depois corre mvn -v para confirmar a instalação bem-sucedida.

3. Crie um novo pom.xml ficheiro na raiz do seu projeto e copie o seguinte código para ele:

   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <groupId>com.azure.samples</groupId>
        <artifactId>quickstart-image-generation</artifactId>
        <version>1.0.0-SNAPSHOT</version>
        <build>
            <sourceDirectory>src</sourceDirectory>
            <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.7.0</version>
                <configuration>
                <source>1.8</source>
                <target>1.8</target>
                </configuration>
            </plugin>
            </plugins>
        </build>
        <dependencies>    
            <dependency>
                <groupId>com.azure</groupId>
                <artifactId>azure-ai-openai</artifactId>
                <version>1.0.0-beta.3</version>
            </dependency>
            <dependency>
                <groupId>com.azure</groupId>
                <artifactId>azure-core</artifactId>
                <version>1.53.0</version>
            </dependency>
            <dependency>
                <groupId>com.azure</groupId>
                <artifactId>azure-identity</artifactId>
                <version>1.15.1</version>
            </dependency>
            <dependency>
                <groupId>org.slf4j</groupId>
                <artifactId>slf4j-simple</artifactId>
                <version>1.7.9</version>
            </dependency>
        </dependencies>
    </project>
   

4. Instale o SDK Azure OpenAI e as dependências.

   mvn clean dependency:copy-dependencies
   

5. Para a autenticação sem chave recomendada com Microsoft Entra ID, inicie sessão em Azure com o seguinte comando:

   az login
   

Recuperar informação de recursos

Precisa de obter a seguinte informação para autenticar a sua aplicação com o seu recurso Azure OpenAI:

Executa a aplicação

O código de exemplo neste quickstart utiliza o Microsoft Entra ID para a autenticação sem chave recomendada. Se preferir usar uma chave API, pode substituir o DefaultAzureCredential objeto por um AzureKeyCredential objeto.

OpenAIAsyncClient client = new OpenAIClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildAsyncClient();

OpenAIAsyncClient client = new OpenAIClientBuilder()
    .endpoint(endpoint)
    .credential(new AzureKeyCredential(key))
    .buildAsyncClient();

Produção

O URL da imagem gerada é impresso na consola.

Image location URL that provides temporary access to download the generated image is <SAS URL>.
Completed getImages.

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes apagar o recurso. Antes de eliminar o recurso, deve primeiro eliminar quaisquer modelos implementados.

• Portal Azure
• CLI do Azure

Use este guia para começar a gerar imagens com o Azure OpenAI SDK para JavaScript.

Documentação de referência | Código-fonte | Package (npm) | Samples

Pré-requisitos

• Uma subscrição Azure - Crie uma gratuitamente
• Versões LTS de Node.js
• CLI do Azure usado para autenticação sem palavra-passe num ambiente de desenvolvimento local, cria o contexto necessário iniciando sessão com o CLI do Azure.
• Um recurso Azure OpenAI criado numa região suportada (ver Disponibilidade de Região). Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Pré-requisitos do Microsoft Entra ID

Para a autenticação sem chave recomendada com o Microsoft Entra ID, precisa:

• Instale o CLI do Azure usado para autenticação sem chave com Microsoft Entra ID.
• Atribui a Cognitive Services User função à tua conta de utilizador. Pode atribuir funções no portal Azure em Controlo de Acesso (IAM)>Adicionar atribuição de funções.

Configuração

1. Crie uma nova pasta image-quickstart e vá à pasta de início rápido com o seguinte comando:

   mkdir image-quickstart && cd image-quickstart
   

2. Crie o package.json com o seguinte comando:

   npm init -y
   

3. Instale a biblioteca cliente OpenAI para JavaScript com:

   npm install openai
   

4. Para a autenticação sem palavra-passe recomendada :

   npm install @azure/identity
   

Recuperar informação de recursos

Precisa de obter a seguinte informação para autenticar a sua aplicação com o seu recurso Azure OpenAI:

Gerar imagens

Produção

A imagem gerada é guardada em generated_image.png no diretório atual.

== Image Generation ==
Image saved to generated_image.png

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes apagar o recurso. Antes de eliminar o recurso, deve primeiro eliminar quaisquer modelos implementados.

• Portal Azure
• CLI do Azure

Use este guia para começar a gerar imagens com o Azure OpenAI SDK para JavaScript.

Documentação de referência | Código-fonte | Package (npm) | Samples

Pré-requisitos

• Uma subscrição Azure - Crie uma gratuitamente
• Versões LTS de Node.js
• TypeScript
• CLI do Azure usado para autenticação sem palavra-passe num ambiente de desenvolvimento local, cria o contexto necessário iniciando sessão com o CLI do Azure.
• Um recurso Azure OpenAI criado numa região suportada (ver Disponibilidade de Região). Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Pré-requisitos do Microsoft Entra ID

Para a autenticação sem chave recomendada com o Microsoft Entra ID, precisa:

• Instale o CLI do Azure usado para autenticação sem chave com Microsoft Entra ID.
• Atribui a Cognitive Services User função à tua conta de utilizador. Pode atribuir funções no portal Azure em Controlo de Acesso (IAM)>Adicionar atribuição de funções.

Configuração

1. Crie uma nova pasta image-quickstart e vá à pasta de início rápido com o seguinte comando:

   mkdir image-quickstart && cd image-quickstart
   

2. Crie o package.json com o seguinte comando:

   npm init -y
   

3. Atualize o package.json para ECMAScript com o seguinte comando:

   npm pkg set type=module
   

4. Instale a biblioteca cliente OpenAI para JavaScript com:

   npm install openai
   

5. Para a autenticação sem palavra-passe recomendada :

   npm install @azure/identity
   

Recuperar informação de recursos

Precisa de obter a seguinte informação para autenticar a sua aplicação com o seu recurso Azure OpenAI:

Gerar imagens

Produção

A imagem gerada é guardada em generated_image.png no diretório atual.

== Image Generation ==
Image saved to generated_image.png

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes apagar o recurso. Antes de eliminar o recurso, deve primeiro eliminar quaisquer modelos implementados.

• Portal Azure
• CLI do Azure

Use este guia para começar a gerar imagens com o SDK OpenAI do Azure para Go.

Código-fonte da biblioteca | Pacote | Exemplos

Pré-requisitos

• Uma subscrição Azure - Crie uma gratuitamente
• Go 1.8+
• Um recurso Azure OpenAI criado numa região suportada (ver Disponibilidade de Região). Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Pré-requisitos do Microsoft Entra ID

Para a autenticação sem chave recomendada com o Microsoft Entra ID, precisa:

• Instale o CLI do Azure usado para autenticação sem chave com Microsoft Entra ID.
• Atribui a Cognitive Services User função à tua conta de utilizador. Pode atribuir funções no portal Azure em Controlo de Acesso (IAM)>Adicionar atribuição de funções.

Configuração

1. Crie uma nova pasta dall-e-quickstart e vá à pasta de início rápido com o seguinte comando:

   mkdir dall-e-quickstart && cd dall-e-quickstart
   

2. Para a autenticação sem chave recomendada com Microsoft Entra ID, inicie sessão em Azure com o seguinte comando:

   az login
   

Recuperar informação de recursos

Precisa de obter a seguinte informação para autenticar a sua aplicação com o seu recurso Azure OpenAI:

Execute o início rápido

O código de exemplo neste quickstart utiliza o Microsoft Entra ID para a autenticação sem chave recomendada. Se preferir usar uma chave API, pode substituir a NewDefaultAzureCredential implementação por NewKeyCredential.

azureOpenAIEndpoint := os.Getenv("AZURE_OPENAI_ENDPOINT")
credential, err := azidentity.NewDefaultAzureCredential(nil)
client, err := azopenai.NewClient(azureOpenAIEndpoint, credential, nil)

azureOpenAIEndpoint := os.Getenv("AZURE_OPENAI_ENDPOINT")
azureOpenAIKey := os.Getenv("AZURE_OPENAI_API_KEY")
credential := azcore.NewKeyCredential(azureOpenAIKey)
client, err := azopenai.NewClientWithKeyCredential(azureOpenAIEndpoint, credential, nil)

Produção

O URL da imagem gerada é impresso na consola.

Image generated, HEAD request on URL returned 200
Image URL: <SAS URL>

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados a ele.

• Portal Azure
• CLI do Azure

Use este guia para começar a chamar as APIs de geração de imagens do Azure OpenAI no Microsoft Foundry Models com PowerShell.

Pré-requisitos

• Uma subscrição do Azure. Crie um gratuitamente.
• Para esta tarefa, recomenda-se a versão mais recente do PowerShell 7 porque os exemplos usam novas funcionalidades que não estão disponíveis no Windows PowerShell 5.1.
• Um recurso Azure OpenAI criado numa região suportada (ver Disponibilidade de Região). Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Pré-requisitos do Microsoft Entra ID

Para a autenticação sem chave recomendada com o Microsoft Entra ID, precisa:

• Instale o CLI do Azure usado para autenticação sem chave com Microsoft Entra ID.
• Atribui a Cognitive Services User função à tua conta de utilizador. Pode atribuir funções no portal Azure em Controlo de Acesso (IAM)>Adicionar atribuição de funções.

Recuperar informação de recursos

Precisa de obter a seguinte informação para autenticar a sua aplicação com o seu recurso Azure OpenAI:

Gerar imagens

1. Para a autenticação sem chave recomendada com Microsoft Entra ID, inicie sessão em Azure com o seguinte comando:

   az login
   

2. Obtenha um token de autenticação Azure OpenAI e defina-o como variável de ambiente para a sessão atual do PowerShell:

   $Env:DEFAULT_AZURE_CREDENTIAL_TOKEN = az account get-access-token --resource https://cognitiveservices.azure.com --query accessToken -o tsv
   

3. Crie um novo ficheiro PowerShell chamado quickstart.ps1. Depois abre-o no teu editor ou IDE preferido.

4. Substitua o conteúdo da quickstart.ps1 pelo seguinte código. Certifica-te de AZURE_OPENAI_ENDPOINT que está definido e muda o valor de prompt para o teu texto preferido.

   Para usar autenticação por chave API em vez da autenticação sem chave, defina AZURE_OPENAI_API_KEY e descomente a 'api-key' linha.

    # Azure OpenAI metadata variables
    $openai = @{
        api_base    = $Env:AZURE_OPENAI_ENDPOINT 
        deployment  = 'gpt-image-1' # set to the name of your model deployment
    }
   
    # Use the recommended keyless authentication via bearer token.
    $headers = [ordered]@{
        #'api-key' = $Env:AZURE_OPENAI_API_KEY
        'Authorization' = "Bearer $($Env:DEFAULT_AZURE_CREDENTIAL_TOKEN)"
    }
   
    # Text to describe image
    $prompt = 'A painting of a dog'
   
    # Adjust these values to fine-tune completions
    $body = [ordered]@{
        model  = $openai.deployment  # required: the name of your model deployment
        prompt = $prompt
        size   = '1024x1024'
        n      = 1
        quality = 'high'
        output_format = 'png'
        # background = 'transparent'  # 'auto' or 'transparent' (GPT-image-1 only; requires PNG output)
        # output_compression = 100    # 0-100 compression level (JPEG output only)
    } | ConvertTo-Json
   
    # Call the API to generate the image and retrieve the response
    $url = "$($openai.api_base)/openai/v1/images/generations?api-version=preview"
   
    $response = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -ContentType 'application/json'
   
    # Set the directory for the stored image
    $image_dir = Join-Path -Path $pwd -ChildPath 'images'
   
    # If the directory doesn't exist, create it
    if (-not(Resolve-Path $image_dir -ErrorAction Ignore)) {
        New-Item -Path $image_dir -ItemType Directory
    }
   
    # Initialize the image path (note the filetype should be png)
    $image_path = Join-Path -Path $image_dir -ChildPath 'generated_image.png'
   
    # Decode the base64 image and save to file
    $image_bytes = [Convert]::FromBase64String($response.data[0].b64_json)
    [IO.File]::WriteAllBytes($image_path, $image_bytes)
    return $image_path
   

   Importante

   Para produção, use uma forma segura de armazenar e aceder às suas credenciais, como The PowerShell Secret Management com Azure Key Vault. Para mais informações sobre segurança de credenciais, consulte este artigo sobre segurança .

5. Executa o script usando PowerShell:

   ./quickstart.ps1
   

   O script gera a imagem e guarda-a.

Produção

O PowerShell solicita a imagem ao Azure OpenAI e armazena a imagem de saída no ficheiro generated_image.png na pasta especificada. Para conveniência, o caminho completo do ficheiro é devolvido no final do script.

As APIs de Imagem vêm com um filtro de moderação de conteúdos. Se o serviço reconhecer o seu prompt como conteúdo prejudicial, não gera uma imagem. Para mais informações, consulte Filtragem de conteúdo.

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados a ele.

• Portal Azure
• Azure PowerShell

Use este guia para começar a gerar imagens com o Azure OpenAI no seu navegador com o Microsoft Foundry.

Pré-requisitos

• Uma subscrição do Azure. Crie um gratuitamente.
• Um recurso Azure OpenAI criado numa região suportada. Ver disponibilidade por região. Para mais informações, consulte Crie um recurso e implemente um modelo com Azure OpenAI.

Ir à Fundição

Navegue até Foundry e inicie sessão com as credenciais associadas ao seu recurso Azure OpenAI. Durante ou após o fluxo de sessão de iniciação, selecione o diretório apropriado, a subscrição do Azure e o recurso Azure OpenAI.

Na página inicial da Foundry, crie ou selecione um novo projeto. Navegue até à página Modelos + endpoints na barra lateral esquerda. Selecione Deploy modelo e depois escolha um dos modelos de geração de imagem da lista. Conclua o processo de implantação.

Na página do modelo, selecione Abrir no Playground.

Experimenta a geração de imagens

Comece a explorar as capacidades do Azure OpenAI com uma abordagem sem código através do Images playground. Introduza o prompt da sua imagem na caixa de texto e selecione Gerar. Quando a imagem gerada pela IA está pronta, ela aparece na página.

No playground Images, também pode ver exemplos de código Python e cURL, que são pré-preenchidos de acordo com as suas definições. Selecione Ver código perto do topo da página. Pode usar este código para escrever uma aplicação que complete a mesma tarefa.

Liberar recursos

Se quiseres limpar e remover um recurso do Azure OpenAI, podes eliminar o recurso ou grupo de recursos. Eliminar o grupo de recursos também elimina quaisquer outros recursos associados a ele.

• Portal Azure
• CLI do Azure