Quickstart: Afbeeldingen genereren met Azure OpenAI in Azure AI Foundry-modellen

Gebruik deze handleiding om aan de slag te gaan met het genereren van installatiekopieën met Azure OpenAI in uw browser met Azure AI Foundry.

Vereiste voorwaarden

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

Ga naar Azure AI Foundry

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

Maak of selecteer een nieuw project op de landingspagina van Azure AI Foundry. Navigeer naar de pagina Modellen en eindpunten in het linkernavigatievenster. Selecteer Model implementeren en kies vervolgens een van de DALL-E-modellen in de lijst. Voltooi het implementatieproces.

Selecteer Openen in speeltuin op de pagina van het model.

Het genereren van installatiekopieën uitproberen

Begin met het verkennen van de mogelijkheden van Azure OpenAI met een no-code-benadering via de afbeeldingen-speeltuin. 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 speeltuin Afbeeldingen 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.

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Probeer voorbeelden in de GitHub-opslagplaats azure OpenAI-voorbeelden.
• Zie de API-verwijzing

Gebruik deze handleiding om aan de slag te gaan met het aanroepen van de REST API's voor Azure OpenAI in Azure AI Foundry Models voor beeldgeneratie met behulp van Python.

Vereiste voorwaarden

• Een Azure-abonnement. Maak gratis een account.
• Python 3.8 of nieuwere versie.
• 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 gpt-image-1-serie of dalle3 model implementeren met uw Azure-resource. Zie Een resource maken en een model implementeren met Azure OpenAI voor meer informatie.

Configuratie

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"

Maak een nieuwe Python-applicatie

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

Uitvoer

De uitvoer van een geslaagde API-aanroep voor het genereren van afbeeldingen ziet eruit als in het volgende voorbeeld. Het url veld bevat een URL waar u de gegenereerde afbeelding kunt downloaden. De URL blijft 24 uur actief.

{ 
    "created": 1698116662, 
    "data": [ 
        { 
            "url": "<URL_to_generated_image>",
            "revised_prompt": "<prompt_that_was_used>" 
        }
    ]
} 

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. Raadpleeg de handleiding voor afbeeldingengeneratie voor voorbeelden van foutreacties.

Het systeem retourneert een bewerkingsstatus van Failed en de error.code waarde in het bericht is ingesteld op contentFilter. Hier is 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 installatiekopieën zelf worden gefilterd. In dit geval is het foutbericht ingesteld op Generated image was filtered as a result of our safety system.. Hier is een voorbeeld:

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

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Probeer voorbeelden in de GitHub-opslagplaats azure OpenAI-voorbeelden.
• Zie de API-verwijzing

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

Broncode van bibliotheek | Pakket | Voorbeelden

Vereiste voorwaarden

• Een Azure-abonnement. Maak gratis een account.
• Python 3.8 of nieuwere versie.
• Een Azure OpenAI-resource die is gemaakt in een compatibele regio. Zie beschikbaarheid van regio's.
• Vervolgens moet u een dalle3 model implementeren met uw Azure-resource. Zie Een resource maken en een model implementeren met Azure OpenAI voor meer informatie.

Configuratie

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 met DALL-E

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 requests
from PIL import Image
import json

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

result = client.images.generate(
    model="dalle3", # the name of your DALL-E 3 deployment
    prompt="a close-up of a bear walking throughthe forest",
    n=1
)

json_response = json.loads(result.model_dump_json())

# 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')

# Retrieve the generated image
image_url = json_response["data"][0]["url"]  # extract image URL from response
generated_image = requests.get(image_url).content  # download the image
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. Voer uw eindpunt-URL en -sleutel in de juiste velden in.
2. Wijzig de waarde van prompt de gewenste tekst.
3. Wijzig de waarde van model het geïmplementeerde DALL-E 3-model in de naam van het geïmplementeerde DALL-E 3-model.

De toepassing uitvoeren met de opdracht python:

python quickstart.py

Wacht even om het antwoord te krijgen.

Uitvoer

Azure OpenAI slaat de uitvoerafbeelding op in het generated_image.png-bestand in de opgegeven map. In het script wordt ook de afbeelding weergegeven in de standaardafbeeldingsviewer.

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.

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Probeer voorbeelden in de GitHub-opslagplaats azure OpenAI-voorbeelden.
• Zie de API-verwijzing

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

Voorbeelden van broncodepakket | voor bibliotheken (NuGet) |

Vereiste voorwaarden

• Een Azure-abonnement - Een gratis abonnement maken
• De .NET 7 SDK
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie beschikbaarheid van regio's). Zie Een resource maken en een model implementeren 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 Azure Portal onder Toegangsbeheer (IAM)>Roltoewijzing toevoegen.

Inrichten

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

   mkdir vision-quickstart && cd vision-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 installeert u het Azure.Identity-pakket met:

   dotnet add package Azure.Identity
   

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

   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 vervang de waarden van de tijdelijke aanduidingen 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("dalle-3");
   
   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 dotnet run opdracht of de knop Uitvoeren bovenaan Visual Studio:

   dotnet run
   

Uitvoer

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

<SAS URL>

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Bekijk de GitHub-opslagplaats azure OpenAI-voorbeelden voor meer voorbeelden.

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

Voorbeelden van broncodeartefact (Maven) |

Vereiste voorwaarden

• Een Azure-abonnement - Een gratis abonnement maken
• De huidige versie van de Java Development Kit (JDK)
• Installeer Apache Maven.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie beschikbaarheid van regio's). Zie Een resource maken en een model implementeren 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 Azure Portal onder Toegangsbeheer (IAM)>Roltoewijzing toevoegen.

Inrichten

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

   mkdir vision-quickstart && cd vision-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-dall-e</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 met de volgende opdracht aan bij Azure voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID:

   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.

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Bekijk de GitHub-opslagplaats met Azure OpenAI-voorbeelden voor meer voorbeelden

Gebruik deze handleiding om aan de slag te gaan met het genereren van installatiekopieën met de Azure OpenAI SDK voor JavaScript.

Referentiedocumentatie | Broncode | Pakket (npm) | Voorbeelden

Vereiste voorwaarden

• Een Azure-abonnement - Een gratis abonnement maken
• LTS-versies van Node.js
• Azure CLI die wordt gebruikt voor verificatie zonder wachtwoord in een lokale ontwikkelomgeving, maakt de benodigde context door u aan te melden met de Azure CLI.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie beschikbaarheid van regio's). Zie Een resource maken en een model implementeren 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 Azure Portal onder Toegangsbeheer (IAM)>Roltoewijzing toevoegen.

Inrichten

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 met DALL-E

Uitvoer

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

== Batch Image Generation ==
Image generation result URL: <SAS URL>
Image generation result URL: <SAS URL>

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Bekijk de GitHub-opslagplaats azure OpenAI-voorbeelden voor meer voorbeelden.

Gebruik deze handleiding om aan de slag te gaan met het genereren van installatiekopieën met de Azure OpenAI SDK voor JavaScript.

Referentiedocumentatie | Broncode | Pakket (npm) | Voorbeelden

Vereiste voorwaarden

• Een Azure-abonnement - Een gratis abonnement maken
• LTS-versies van Node.js
• TypeScript
• Azure CLI die wordt gebruikt voor verificatie zonder wachtwoord in een lokale ontwikkelomgeving, maakt de benodigde context door u aan te melden met de Azure CLI.
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie beschikbaarheid van regio's). Zie Een resource maken en een model implementeren 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 Azure Portal onder Toegangsbeheer (IAM)>Roltoewijzing toevoegen.

Inrichten

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 de 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 met DALL-E

Uitvoer

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

== Batch Image Generation ==
Image generation result URL: <SAS URL>
Image generation result URL: <SAS URL>

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Bekijk de GitHub-opslagplaats azure OpenAI-voorbeelden voor meer voorbeelden.

Gebruik deze handleiding om aan de slag te gaan met het genereren van installatiekopieën met de Azure OpenAI SDK voor Go.

Broncode van bibliotheek | Pakket | Voorbeelden

Vereiste voorwaarden

• Een Azure-abonnement - Een gratis abonnement maken
• Go 1.8+
• Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio (zie beschikbaarheid van regio's). Zie Een resource maken en een model implementeren 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 Azure Portal onder Toegangsbeheer (IAM)>Roltoewijzing toevoegen.

Inrichten

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 met de volgende opdracht aan bij Azure voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID:

   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>

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.
• Bekijk de GitHub-opslagplaats azure OpenAI-voorbeelden voor meer voorbeelden.

Gebruik deze handleiding om aan de slag te gaan met het aanroepen van de API's voor afbeeldingsgeneratie van Azure OpenAI binnen Azure AI Foundry Models met PowerShell.

Vereiste voorwaarden

• Een Azure-abonnement. Maak gratis een account.
• 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 beschikbaarheid van regio's). Zie Een resource maken en een model implementeren 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 Azure Portal onder Toegangsbeheer (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 met de volgende opdracht aan bij Azure voor de aanbevolen sleutelloze verificatie met Microsoft Entra ID:

   az login
   

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

3. Vervang de inhoud van quickstart.ps1 door de volgende code. Voer uw eindpunt-URL en -sleutel in de juiste velden in. Wijzig de waarde van prompt de gewenste tekst.

    # Azure OpenAI metadata variables
    $openai = @{
        api_base    = $Env:AZURE_OPENAI_ENDPOINT 
        api_version = '2023-06-01-preview' # This can change in the future.
    }
   
    # 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]@{
        prompt = $prompt
        size   = '1024x1024'
        n      = 1
    } | ConvertTo-Json
   
    # Call the API to generate the image and retrieve the response
    $url = "$($openai.api_base)/openai/images/generations:submit?api-version=$($openai.api_version)"
   
    $submission = Invoke-RestMethod -Uri $url -Headers $headers -Body $body -Method Post -ContentType 'application/json' -ResponseHeadersVariable submissionHeaders
   
    $operation_location = $submissionHeaders['operation-location'][0]
    $status = ''
    while ($status -ne 'succeeded') {
        Start-Sleep -Seconds 1
        $response = Invoke-RestMethod -Uri $operation_location -Headers $headers
        $status   = $response.status
    }
   
    # 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'
   
    # Retrieve the generated image
    $image_url = $response.result.data[0].url  # extract image URL from response
    $generated_image = Invoke-WebRequest -Uri $image_url -OutFile $image_path  # download the image
    return $image_path
   

   Belangrijk

   Gebruik voor productie een veilige manier om uw referenties op te slaan en te openen, zoals Het PowerShell-geheimbeheer met Azure Key Vault. Zie dit beveiligingsartikel voor meer informatie over referentiebeveiliging.

4. Voer het script uit met behulp van PowerShell:

   ./quickstart.ps1
   

   Het script wordt herhaald totdat de gegenereerde installatiekopieën gereed zijn.

Uitvoer

PowerShell vraagt de installatiekopieën van Azure OpenAI aan en slaat de uitvoerafbeelding op in het generated_image.png-bestand in de opgegeven map. 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.

De hulpbronnen 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

Volgende stappen

• Verken de Afbeeldings-API's grondiger met de handleiding voor de Afbeeldings-API.

• Probeer voorbeelden in de GitHub-opslagplaats azure OpenAI-voorbeelden.