Delen via

Meer informatie over het werken met de DALL-E-modellen

  • 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

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>

waarbij geldt:

  • <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 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."
    }
}

Prompts voor het schrijven van afbeeldingen

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

Tip

Zie het promptboek Dallery DALL-E 2 voor een grondig overzicht van hoe u uw tekstprompts kunt aanpassen om verschillende soorten afbeeldingen te genereren.

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.

Prompttransformatie

DALL-E 3 bevat ingebouwde promptherschrijven om afbeeldingen te verbeteren, vooroordelen te verminderen en natuurlijke variatie van afbeeldingen te vergroten.

Voorbeeldtekstprompt Voorbeeld van gegenereerde afbeelding zonder prompttransformatie Voorbeeld van gegenereerde afbeelding met prompttransformatie
"Aquarel schilderij van de skyline van Seattle" Aquarelschilderij van de skyline van Seattle (eenvoudig). Aquarelschilderij van de skyline van Seattle, met meer details en structuur.

De bijgewerkte prompt is zichtbaar in het revised_prompt veld van het gegevensantwoordobject.

Hoewel het momenteel niet mogelijk is om deze functie uit te schakelen, kunt u speciale aanwijzingen gebruiken om uitvoer dichter bij de oorspronkelijke prompt te krijgen door het volgende toe te voegen: I NEED to test how the tool works with extremely simple prompts. DO NOT add any detail, just use it AS-IS:.

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 introduceert twee stijlopties: natural en vivid. De natural stijl lijkt meer op de standaardstijl DALL-E 2, terwijl de vivid stijl meer hyper-echte en filmische afbeeldingen genereert.

De natural stijl is handig 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. hd maakt afbeeldingen met gedetailleerdere details en meer consistentie in de afbeelding. standard installatiekopieë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.

Volgende stappen