Lezen in het Engels

Delen via

De DALL-E-modellen gebruiken

  • Artikel

De DALL-E-modellen van OpenAI genereren afbeeldingen op basis van door de gebruiker verstrekte tekstprompts. In deze handleiding ziet u hoe u de DALL-E-modellen gebruikt en hun opties configureert via REST API-aanroepen.

Vereisten

  • Een Azure-abonnement. U kunt er gratis een maken.
  • Een Azure OpenAI-resource die is gemaakt in een ondersteunde regio. Zie beschikbaarheid van regio's.
    • Implementeer een dall-e-3-model met uw Azure OpenAI-resource.

De API's voor het genereren van installatiekopieën aanroepen

De volgende opdracht toont de meest eenvoudige manier om DALL-E met code te gebruiken. Als dit de eerste keer is dat u deze modellen programmatisch gebruikt, raden we u aan om te beginnen met de quickstart DALL-E.

Een POST-aanvraag verzenden naar:

https://<your_resource_name>.openai.azure.com/openai/deployments/<your_deployment_name>/images/generations?api-version=<api_version>

Vervang de volgende tijdelijke aanduidingen:

  • <your_resource_name> is de naam van uw Azure OpenAI-resource.
  • <your_deployment_name> is de naam van uw DALL-E 3-modelimplementatie.
  • <api_version> is de versie van de API die u wilt gebruiken. Bijvoorbeeld: 2024-02-01.

Vereiste headers:

  • Content-Type: application/json
  • api-key: <your_API_key>

Hoofdtekst:

Hier volgt een voorbeeld van een aanvraagbody. U geeft een aantal opties op, gedefinieerd in latere secties.

{
    "prompt": "A multi-colored umbrella on the beach, disposable camera",
    "size": "1024x1024", 
    "n": 1,
    "quality": "hd", 
    "style": "vivid"
}

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>" 
        }
    ]
}

Afwijzing van API-aanroep

Prompts en afbeeldingen worden gefilterd op basis van ons inhoudsbeleid, waardoor er een fout wordt geretourneerd wanneer een prompt of afbeelding wordt gemarkeerd.

Als uw prompt is gemarkeerd, wordt de error.code waarde in het bericht 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 installatiekopieën zelf worden gefilterd. In dit geval wordt het foutbericht ingesteld op Gegenereerde installatiekopieën die zijn gefilterd als gevolg van ons veiligheidssysteem. Hier volgt een voorbeeld:

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

Prompts voor het schrijven van installatiekopieën

Uw afbeeldingsprompts moeten de inhoud beschrijven die u in de afbeelding wilt zien en de visuele stijl van de afbeelding.

Houd er bij het schrijven van prompts rekening mee dat de API's voor het genereren van afbeeldingen worden geleverd met een con tentmodus rationfilter. Als de service uw prompt herkent als schadelijke inhoud, wordt er geen afbeelding gegenereerd. Zie Inhoudsfiltering voor meer informatie.

Tip

Zie de handleiding afbeeldingsprompts voor meer informatie over hoe u tekstprompts kunt aanpassen om verschillende soorten afbeeldingen te genereren.

API-opties opgeven

De volgende PARAMETERS voor DE API-hoofdtekst zijn beschikbaar voor het genereren van DALL-E-installatiekopieën.

Tekengrootte

Geef de grootte van de gegenereerde afbeeldingen op. Moet een van 1024x1024, 1792x1024of 1024x1792 voor DALL-E 3-modellen zijn. Vierkante afbeeldingen zijn sneller te genereren.

Stijl

DALL-E 3 biedt twee stijlopties: natural en vivid. De natuurlijke stijl lijkt meer op de standaardstijl van oudere modellen, terwijl de levendige stijl meer hyper-echte en filmische afbeeldingen genereert.

De natuurlijke stijl is nuttig in gevallen waarin DALL-E 3 overdreven of verwarrend is voor een onderwerp dat bedoeld is om eenvoudiger, onderlegd of realistischer te zijn.

De standaardwaarde is vivid.

kwaliteit

Er zijn twee opties voor afbeeldingskwaliteit: hd en standard. Met de hd-optie worden afbeeldingen met gedetailleerdere details en meer consistentie in de afbeelding gemaakt. Standaardinstallatiekopieën kunnen sneller worden gegenereerd.

De standaardwaarde is standard.

Aantal

Met DALL-E 3 kunt u niet meer dan één installatiekopieën genereren in één API-aanroep: de n parameter moet worden ingesteld op 1. Als u meerdere installatiekopieën tegelijk wilt genereren, moet u parallelle aanvragen indienen.

Antwoordindeling

De indeling waarin de gegenereerde afbeeldingen worden geretourneerd. Moet een van url (een URL die naar de afbeelding verwijst) of b64_json (de basiscode van 64 byte in JSON-indeling). De standaardwaarde is url.

Gerelateerde inhoud