Azure OpenAI-modellen voor het genereren van beelden

Gebruik deze handleiding om aan de slag te gaan met het oproepen van de Azure OpenAI in de REST-API's voor afbeeldingsgeneratie van Microsoft Foundry Models met behulp van Python.

Voorwaarden

• Een Azure-abonnement. Maak er gratis een.
• Python versie 3.8 of hoger.
• De volgende Python bibliotheken zijn geïnstalleerd: os, requests, json.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio. Zie beschikbaarheid van regio's.
• Vervolgens moet u een model van de gpt-image-serie implementeren met uw Azure resource. Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

Installatie

Sleutel en eindpunt ophalen

Als u de Azure OpenAI-API's wilt aanroepen, hebt u de volgende informatie nodig over uw Azure OpenAI-resource:

Ga naar uw resource in de Azure-portal. Selecteer sleutels en eindpunt in het navigatiedeelvenster onder Resourcebeheer. Kopieer de eindpuntwaarde en een toegangssleutelwaarde. U kunt de waarde KEY 1 of KEY 2 gebruiken. Als u altijd twee sleutels hebt, kunt u sleutels veilig roteren en opnieuw genereren zonder een serviceonderbreking te veroorzaken.

Omgevingsvariabelen

Maak en wijs permanente omgevingsvariabelen toe voor uw sleutel en eindpunt.

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"

Een nieuwe Python-toepassing maken

Maak een nieuw Python-bestand met de naam quickstart.py. Open het nieuwe bestand in de gewenste editor of IDE.

1. Vervang de inhoud van quickstart.py door de volgende code. Wijzig de waarde van prompt naar uw gewenste tekst. Stel deployment ook in op de implementatienaam die u hebt gekozen bij het uitrollen van het beeldgeneratiemodel.

   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")
   

   Het script doet een synchrone API-aanroep voor beeldgeneratie.

   Belangrijk

   Vergeet niet om de sleutel uit uw code te verwijderen wanneer u klaar bent en plaats uw sleutel nooit openbaar. Gebruik in de productieomgeving een veilige manier om uw referenties op te slaan en te openen. Zie Azure Key Vault voor meer informatie.

2. Voer de toepassing uit met de python opdracht:

   python quickstart.py
   

   Wacht even om het antwoord te krijgen.

Uitvoer

De uitvoer van een geslaagde API-aanroep voor het genereren van afbeeldingen ziet eruit als in het volgende voorbeeld. Het b64_json veld bevat de met base64 gecodeerde uitvoerafbeeldingsgegevens.

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

Een geslaagd antwoord omvat:

• Een created tijdstempel (Unix-tijdsperiode)
• Een data array met ten minste één afbeeldingsobject - een b64_json waarde (base64-gecodeerde afbeeldingsgegevens) voor elke gegenereerde afbeelding

Veelvoorkomende fouten

De afbeeldings-API's worden geleverd met een filter voor inhoudsbeheer. Als de service uw prompt herkent als schadelijke inhoud, wordt er geen afbeelding gegenereerd. Zie Inhoudsfiltering voor meer informatie. Zie de handleiding voor het genereren van afbeeldingen voor voorbeelden van foutreacties.

Het systeem retourneert een bewerkingsstatus van Failed en de error.code waarde in het bericht is ingesteld op contentFilter. Hier volgt een voorbeeld:

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

Het is ook mogelijk dat de gegenereerde afbeelding zelf wordt gefilterd. In dit geval is het foutbericht ingesteld op Generated image was filtered as a result of our safety system.. Hier volgt een voorbeeld:

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

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources verwijderd die eraan zijn gekoppeld.

• Azure portal
• Azure CLI

Gebruik deze handleiding om aan de slag te gaan met het genereren van afbeeldingen met de Azure OpenAI SDK voor Python.

Bibliotheekbroncode | Pakket | Voorbeelden

Voorwaarden

• Een Azure-abonnement. Maak er gratis een.
• Python versie 3.8 of hoger.
• Een Azure OpenAI-resource die is gemaakt in een compatibele regio. Zie beschikbaarheid van regio's.
  • Open het Azure OpenAI-resource-eindpunt en -sleutels in de Azure-portal.
• Een uitgerold afbeeldingsgeneratiemodel:
  • GPT-image-1-serie: Een gpt-image-1-serie model inzetten. Vereist beperkte toegangsregistratie.

Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

Installatie

Sleutel en eindpunt ophalen

Als u de Azure OpenAI-API's wilt aanroepen, hebt u de volgende informatie nodig over uw Azure OpenAI-resource:

Ga naar uw resource in de Azure-portal. Selecteer sleutels en eindpunt in het navigatiedeelvenster onder Resourcebeheer. Kopieer de eindpuntwaarde en een toegangssleutelwaarde. U kunt de waarde KEY 1 of KEY 2 gebruiken. Als u altijd twee sleutels hebt, kunt u sleutels veilig roteren en opnieuw genereren zonder een serviceonderbreking te veroorzaken.

Omgevingsvariabelen

Maak en wijs permanente omgevingsvariabelen toe voor uw sleutel en eindpunt.

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"

De Python SDK installeren

Open een opdrachtprompt en blader naar de projectmap. Installeer de OpenAI Python SDK met behulp van de volgende opdracht:

pip install openai

Installeer ook de volgende bibliotheken:

pip install requests
pip install pillow 

Afbeeldingen genereren

Maak een nieuw Python-bestand quickstart.py. Open deze in uw favoriete editor of IDE.

Vervang de inhoud van quickstart.py door de volgende code.

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. Zorg ervoor dat de AZURE_OPENAI_ENDPOINT en AZURE_OPENAI_API_KEY omgevingsvariabelen zijn ingesteld.
2. Wijzig de waarde van prompt naar uw gewenste tekst.
3. Wijzig de waarde van model naar de naam van uw geïmplementeerde GPT-afbeeldingenreeksmodel.

Voer de toepassing uit met de python opdracht:

python quickstart.py

Wacht even om het antwoord te krijgen.

Uitvoer

Azure OpenAI slaat de uitvoerafbeelding op in het bestand generated_image.png in de opgegeven map. Het script toont ook de afbeelding in uw standaard fotoviewer.

Een geslaagd antwoord omvat:

• Een created tijdstempel
• Een data matrix met ten minste één afbeeldingsobject
• Een b64_json veld met base64-gecodeerde afbeeldingsgegevens (GPT-image-1-modellen retourneren altijd base64)

Veelvoorkomende fouten

De afbeeldings-API's worden geleverd met een filter voor inhoudsbeheer. Als de service uw prompt herkent als schadelijke inhoud, wordt er geen afbeelding gegenereerd. Zie Inhoudsfiltering voor meer informatie.

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources verwijderd die eraan zijn gekoppeld.

• Azure portal
• Azure CLI

Gebruik deze handleiding om aan de slag te gaan met het genereren van afbeeldingen met de Azure OpenAI SDK voor C#.

Bibliotheekbroncode | Package (NuGet) | Voorbeelden

Voorwaarden

• Een Azure-abonnement - Maak er gratis een
• De .NET 7 SDK
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie Region-beschikbaarheid). Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

vereisten voor Microsoft Entra ID

Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID moet u het volgende doen:

• Installeer de Azure CLI die wordt gebruikt voor sleutelloze verificatie met Microsoft Entra ID.
• Wijs de Cognitive Services User rol toe aan uw gebruikersaccount. U kunt rollen toewijzen in de Azure-portal onder Toegang beheer (IAM)>Roltoewijzing toevoegen.

Instellen

1. Maak een nieuwe map image-quickstart en ga naar de snelstartmap met de volgende opdracht:

   mkdir image-quickstart && cd image-quickstart
   

2. Maak een nieuwe consoletoepassing met de volgende opdracht:

   dotnet new console
   

3. Installeer de OpenAI .NET clientbibliotheek met de opdracht dotnet add package:

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

4. Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID, installeer het Azure.Identity pakket met:

   dotnet add package Azure.Identity
   

5. Meld u aan bij Azure voor de aanbevolen sleutelloze authenticatie met Microsoft Entra ID met de volgende opdracht:

   az login
   

Resourcegegevens ophalen

U moet de volgende informatie ophalen om uw toepassing te verifiëren met uw Azure OpenAI-resource:

De quickstart uitvoeren

De voorbeeldcode in deze quickstart maakt gebruik van Microsoft Entra ID voor de aanbevolen sleutelloze verificatie. Als u liever een API-sleutel gebruikt, kunt u het DefaultAzureCredential object vervangen door een AzureKeyCredential object.

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

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

Voer de volgende stappen uit om de quickstart uit te voeren:

1. Vervang de inhoud van Program.cs door de volgende code en werk de waarden van de tijdelijke aanduidingen bij met uw eigen waarden.

   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. Voer de toepassing uit met behulp van de opdracht dotnet run of de knop Uitvoeren bovenaan Visual Studio:

   dotnet run
   

Uitvoer

De met base64 gecodeerde afbeeldingsgegevens worden afgedrukt naar de console.

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource verwijderen. Voordat u de resource verwijdert, moet u eerst geïmplementeerde modellen verwijderen.

• Azure portal
• Azure CLI

Gebruik deze handleiding om aan de slag te gaan met het genereren van afbeeldingen met de Azure OpenAI SDK voor Java.

Bibliotheekbroncode | Artifact (Maven) | Voorbeelden

Voorwaarden

• Een Azure-abonnement - Maak er gratis een
• De huidige versie van de Java Development Kit (JDK)
• Installeer Apache Maven.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie Region-beschikbaarheid). Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

vereisten voor Microsoft Entra ID

Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID moet u het volgende doen:

• Installeer de Azure CLI die wordt gebruikt voor sleutelloze verificatie met Microsoft Entra ID.
• Wijs de Cognitive Services User rol toe aan uw gebruikersaccount. U kunt rollen toewijzen in de Azure-portal onder Toegang beheer (IAM)>Roltoewijzing toevoegen.

Instellen

1. Maak een nieuwe map image-quickstart en ga naar de snelstartmap met de volgende opdracht:

   mkdir image-quickstart && cd image-quickstart
   

2. Installeer Apache Maven. Voer vervolgens uit mvn -v om de installatie te bevestigen.

3. Maak een nieuw pom.xml bestand in de hoofdmap van uw project en kopieer de volgende code erin:

   <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. Installeer de Azure OpenAI SDK en afhankelijkheden.

   mvn clean dependency:copy-dependencies
   

5. Meld u aan bij Azure voor de aanbevolen sleutelloze authenticatie met Microsoft Entra ID met de volgende opdracht:

   az login
   

Resourcegegevens ophalen

U moet de volgende informatie ophalen om uw toepassing te verifiëren met uw Azure OpenAI-resource:

De app uitvoeren

De voorbeeldcode in deze quickstart maakt gebruik van Microsoft Entra ID voor de aanbevolen sleutelloze verificatie. Als u liever een API-sleutel gebruikt, kunt u het DefaultAzureCredential object vervangen door een AzureKeyCredential object.

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

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

Uitvoer

De URL van de gegenereerde afbeelding wordt afgedrukt naar de console.

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

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource verwijderen. Voordat u de resource verwijdert, moet u eerst geïmplementeerde modellen verwijderen.

• Azure portal
• Azure CLI

Gebruik deze handleiding om te beginnen met het genereren van afbeeldingen met de Azure OpenAI SDK voor JavaScript.

Referentiedocumentatie | Broncode | Package (npm) | Voorbeelden

Voorwaarden

• Een Azure-abonnement - Maak er gratis een
• LTS-versies van Node.js
• Azure CLI gebruikt voor verificatie zonder wachtwoord in een lokale ontwikkelomgeving, maakt u de benodigde context door u aan te melden met de Azure CLI.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie Region-beschikbaarheid). Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

vereisten voor Microsoft Entra ID

Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID moet u het volgende doen:

• Installeer de Azure CLI die wordt gebruikt voor sleutelloze verificatie met Microsoft Entra ID.
• Wijs de Cognitive Services User rol toe aan uw gebruikersaccount. U kunt rollen toewijzen in de Azure-portal onder Toegang beheer (IAM)>Roltoewijzing toevoegen.

Installatie

1. Maak een nieuwe map image-quickstart en ga naar de snelstartmap met de volgende opdracht:

   mkdir image-quickstart && cd image-quickstart
   

2. Maak de package.json opdracht met de volgende opdracht:

   npm init -y
   

3. Installeer de OpenAI-clientbibliotheek voor JavaScript met:

   npm install openai
   

4. Voor de aanbevolen verificatie zonder wachtwoord:

   npm install @azure/identity
   

Resourcegegevens ophalen

U moet de volgende informatie ophalen om uw toepassing te verifiëren met uw Azure OpenAI-resource:

Afbeeldingen genereren

Uitvoer

De gegenereerde afbeelding wordt opgeslagen in generated_image.png in de huidige map.

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

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource verwijderen. Voordat u de resource verwijdert, moet u eerst geïmplementeerde modellen verwijderen.

• Azure portal
• Azure CLI

Gebruik deze handleiding om te beginnen met het genereren van afbeeldingen met de Azure OpenAI SDK voor JavaScript.

Referentiedocumentatie | Broncode | Package (npm) | Voorbeelden

Voorwaarden

• Een Azure-abonnement - Maak er gratis een
• LTS-versies van Node.js
• TypeScript
• Azure CLI gebruikt voor verificatie zonder wachtwoord in een lokale ontwikkelomgeving, maakt u de benodigde context door u aan te melden met de Azure CLI.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie Region-beschikbaarheid). Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

vereisten voor Microsoft Entra ID

Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID moet u het volgende doen:

• Installeer de Azure CLI die wordt gebruikt voor sleutelloze verificatie met Microsoft Entra ID.
• Wijs de Cognitive Services User rol toe aan uw gebruikersaccount. U kunt rollen toewijzen in de Azure-portal onder Toegang beheer (IAM)>Roltoewijzing toevoegen.

Installatie

1. Maak een nieuwe map image-quickstart en ga naar de snelstartmap met de volgende opdracht:

   mkdir image-quickstart && cd image-quickstart
   

2. Maak de package.json opdracht met de volgende opdracht:

   npm init -y
   

3. Werk package.json bij naar ECMAScript met het volgende commando:

   npm pkg set type=module
   

4. Installeer de OpenAI-clientbibliotheek voor JavaScript met:

   npm install openai
   

5. Voor de aanbevolen verificatie zonder wachtwoord:

   npm install @azure/identity
   

Resourcegegevens ophalen

U moet de volgende informatie ophalen om uw toepassing te verifiëren met uw Azure OpenAI-resource:

Afbeeldingen genereren

Uitvoer

De gegenereerde afbeelding wordt opgeslagen in generated_image.png in de huidige map.

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

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource verwijderen. Voordat u de resource verwijdert, moet u eerst geïmplementeerde modellen verwijderen.

• Azure portal
• Azure CLI

Gebruik deze handleiding om te beginnen met het genereren van afbeeldingen met de Azure OpenAI SDK voor Go.

Library-broncode | Pakket | Voorbeelden

Voorwaarden

• Een Azure-abonnement - Maak er gratis een
• Go 1.8+
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie Region-beschikbaarheid). Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

vereisten voor Microsoft Entra ID

Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID moet u het volgende doen:

• Installeer de Azure CLI die wordt gebruikt voor sleutelloze verificatie met Microsoft Entra ID.
• Wijs de Cognitive Services User rol toe aan uw gebruikersaccount. U kunt rollen toewijzen in de Azure-portal onder Toegang beheer (IAM)>Roltoewijzing toevoegen.

Installatie

1. Maak een nieuwe map dall-e-quickstart en ga naar de snelstartmap met de volgende opdracht:

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

2. Meld u aan bij Azure voor de aanbevolen sleutelloze authenticatie met Microsoft Entra ID met de volgende opdracht:

   az login
   

Resourcegegevens ophalen

U moet de volgende informatie ophalen om uw toepassing te verifiëren met uw Azure OpenAI-resource:

De quickstart uitvoeren

De voorbeeldcode in deze quickstart maakt gebruik van Microsoft Entra ID voor de aanbevolen sleutelloze verificatie. Als u liever een API-sleutel gebruikt, kunt u de NewDefaultAzureCredential implementatie vervangen door 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)

Uitvoer

De URL van de gegenereerde afbeelding wordt afgedrukt naar de console.

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

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources verwijderd die eraan zijn gekoppeld.

• Azure portal
• Azure CLI

Gebruik deze handleiding om aan de slag te gaan met het aanroepen van de Azure OpenAI API's in Microsoft Foundry Models voor het genereren van afbeeldingen met PowerShell.

Voorwaarden

• Een Azure-abonnement. Maak er gratis een.
• Voor deze taak wordt de nieuwste versie van PowerShell 7 aanbevolen omdat in de voorbeelden nieuwe functies worden gebruikt die niet beschikbaar zijn in Windows PowerShell 5.1.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie Region-beschikbaarheid). Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

vereisten voor Microsoft Entra ID

Voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID moet u het volgende doen:

• Installeer de Azure CLI die wordt gebruikt voor sleutelloze verificatie met Microsoft Entra ID.
• Wijs de Cognitive Services User rol toe aan uw gebruikersaccount. U kunt rollen toewijzen in de Azure-portal onder Toegang beheer (IAM)>Roltoewijzing toevoegen.

Resourcegegevens ophalen

U moet de volgende informatie ophalen om uw toepassing te verifiëren met uw Azure OpenAI-resource:

Afbeeldingen genereren

1. Meld u aan bij Azure voor de aanbevolen sleutelloze authenticatie met Microsoft Entra ID met de volgende opdracht:

   az login
   

2. Haal een Azure OpenAI-verificatietoken op en stel dit in als een omgevingsvariabele voor de huidige PowerShell-sessie:

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

3. Maak een nieuw PowerShell-bestand met de naamquickstart.ps1. Open deze vervolgens in uw favoriete editor of IDE.

4. Vervang de inhoud van quickstart.ps1 door de volgende code. Zorg ervoor dat AZURE_OPENAI_ENDPOINT is ingesteld en wijzig de waarde van prompt naar de door u gewenste tekst.

   Als u API-sleutelverificatie wilt gebruiken in plaats van sleutelloze verificatie, configureert u AZURE_OPENAI_API_KEY en decommenteert u de regel 'api-key'.

    # 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
   

   Belangrijk

   Gebruik voor productie een veilige manier om uw referenties op te slaan en toegang te krijgen tot, zoals PowerShell Secret Management met Azure Key Vault. Zie dit beveiligingsartikel voor meer informatie over referentiebeveiliging.

5. Voer het script uit met behulp van PowerShell:

   ./quickstart.ps1
   

   Het script genereert de afbeelding en slaat deze op.

Uitvoer

PowerShell vraagt de afbeelding op van Azure OpenAI en slaat de uitvoerafbeelding op in het bestand generated_image.png in de opgegeven directory. Voor het gemak wordt het volledige pad voor het bestand geretourneerd aan het einde van het script.

De afbeeldings-API's worden geleverd met een filter voor inhoudsbeheer. Als de service uw prompt herkent als schadelijke inhoud, wordt er geen afbeelding gegenereerd. Zie Inhoudsfiltering voor meer informatie.

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources verwijderd die eraan zijn gekoppeld.

• Azure portal
• Azure PowerShell

Gebruik deze handleiding om afbeeldingen te genereren met Azure OpenAI in uw browser met Microsoft Foundry.

Voorwaarden

• Een Azure-abonnement. Maak er gratis een.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio. Zie beschikbaarheid van regio's. Zie Maak een resource en implementeer een model met Azure OpenAI voor meer informatie.

Ga naar Foundry

Navigeer naar Foundry en meld u aan met de inloggegevens die zijn gekoppeld aan uw Azure OpenAI-resource. Selecteer tijdens of na de aanmeldingswerkstroom de juiste map, Azure abonnement en Azure OpenAI-resource.

Maak of selecteer een nieuw project op de landingspagina van Foundry. Navigeer naar de pagina Modellen en eindpunten in het linkernavigatievenster. Selecteer Model uitrollen en kies vervolgens een van de beelden genererende modellen uit de lijst. Voltooi het implementatieproces.

Selecteer Openen in speeltuin op de pagina van het model.

Probeer afbeeldingengeneratie uit

Begin met het verkennen van Azure OpenAI-mogelijkheden met een no-code-benadering via de Images playground. Voer uw afbeeldingsprompt in het tekstvak in en selecteer Genereren. Wanneer de door AI gegenereerde afbeelding gereed is, wordt deze weergegeven op de pagina.

In de Images playground kunt u ook Python- en cURL-codevoorbeelden bekijken, die vooraf zijn ingevuld volgens uw instellingen. Selecteer Code weergeven boven aan de pagina. U kunt deze code gebruiken om een toepassing te schrijven die dezelfde taak voltooit.

Resources opschonen

Als u een Azure OpenAI-resource wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources verwijderd die eraan zijn gekoppeld.

• Azure portal
• Azure CLI