OpenAI: DALL·E 3
DALL·E 3 genereert afbeeldingen op basis van een geschreven scènebriefing. Gebruik de exacte model-ID openai/dall-e-3 of de alias dall-e-3 met de beeldgeneratiemethode en sla vervolgens elke geretourneerde afbeeldings-URL met het bijbehorende resultaat op. Een gedocumenteerd startverzoek produceert één afbeelding van 1024x1024 uit tekst.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
DALL·E 3 is het tekst-naar-beeldmodel van OpenAI. Gebruik een geschreven briefing om een illustratie, een scèneconcept of een visuele richting voor een ontwerp te maken. Beschrijf het onderwerp, de omgeving, de compositie, de belichting en de uitwerking in de prompt. Een conceptbriefing kan bijvoorbeeld vragen om een bezorgfiets naast een kleine winkel bij schemering, gezien vanaf de straat, met een duidelijk onderwerp op de voorgrond en een ingetogen kleurenpalet.
Stuur POST /v1/images/generations met een application/json-body. De exacte openbare model-ID is openai/dall-e-3; de toegelaten alias dall-e-3 selecteert dezelfde modelkaart. De gedocumenteerde startstructuur bevat model, prompt, n:1 en size:"1024x1024". n is een optioneel geheel getal en heeft 1 als standaardwaarde. Stuur stream:false of laat stream weg voor het volledige JSON-resultaat. Gebruik een niet-lege tekstprompt en houd dit verzoek gericht op één volledige beeldbriefing. De aangeboden methode is beeldgeneratie uit tekst.
Maak de eisen die van belang zijn voor de plaatsing expliciet. Een redactionele illustratie kan het centrale idee en de objecten benoemen die het uitdrukken. Een scèneconcept kan de camerapositie, het tijdstip en de delen van de compositie aangeven die ruimte om zich heen nodig hebben. Houd exacte bewoording die in de afbeelding moet verschijnen gescheiden van de scènebeschrijvingen en controleer vervolgens de weergegeven letters en visuele opstelling voordat je het geselecteerde resultaat gebruikt.
Het generatieantwoord is JSON met een created-tijdstempel en een data-array. Het gedocumenteerde resultaatitem bevat url en kan revised_prompt, prompt_filter_results en content_filter_results bevatten. Bewaar die velden met het volledige antwoord en download de afbeelding van elke geretourneerde ondertekende Ailoot-URL. Ondertekende Ailoot-bestandslinks zijn 24 uur geldig vanaf uitgifte. Bewaar de exacte geretourneerde URL, inclusief de querytekenreeks, totdat het bestand is opgeslagen; bepaal het formaat van de opgeslagen afbeelding aan de hand van het daadwerkelijke antwoord of de bestandsbytes.
Behandel het geretourneerde afbeeldingsbestand als de bruikbare ontwerpasset en de JSON als het bijbehorende generatierecord. Beoordeel de afbeelding aan de hand van de aangeleverde briefing voordat je die in een pagina, presentatie of toepassing plaatst. Als het antwoord onvolledig is of de verzenduitkomst onzeker is, bewaar dan de oorspronkelijke verzoekidentificatie en geretourneerde informatie terwijl je de bestaande poging controleert, in plaats van alleen om het ontbrekende resultaat terug te krijgen een nieuwe afbeelding te maken. Gebruik dezelfde API-sleutel voor GET /v1/media/assets?family=image om opgeslagen resultaten op te halen en volg elke next_cursor. De asset-ID staat in elke geretourneerde /v1/media/assets/{asset_id}/content-URL en in het mediabibliotheekrecord. Lees GET /v1/media/assets/{asset_id} voor elk geselecteerd record en download de exacte content_url. Als het bestandsverzoek 404 met code link_expired retourneert, lees je dezelfde asset opnieuw om een vernieuwde link op te halen. Voor het vernieuwen van een assetlink is geen nieuw beeldgeneratieverzoek nodig.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Aan de slag
DALL·E 3 genereert afbeeldingen op basis van een geschreven scènebriefing. Gebruik de exacte model-ID openai/dall-e-3 of de alias dall-e-3 met de beeldgeneratiemethode en sla vervolgens elke geretourneerde afbeeldings-URL met het bijbehorende resultaat op. Een gedocumenteerd startverzoek produceert één afbeelding van 1024x1024 uit tekst.
- Toegestane invoer
- Tekst
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Images POST /v1/images/generations
- Invoertypen
text- Uitvoertypen
image- Uitvoerformaat
- Afbeeldingsbestand
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten openai/dall-e-3 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten false | Standaardfalse |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten 1 | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten 1024x1024 | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parameteroptional | Contractstream, n, size |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieEstimated generation cost | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Invoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.32768 schatting vóór generatie This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Resultaten ophalen en opslaan
Ailoot Ultra · Images
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasnamen
Modelaliasnamen
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Aan de slag
DALL·E 3 genereert afbeeldingen op basis van een geschreven scènebriefing. Gebruik de exacte model-ID openai/dall-e-3 of de alias dall-e-3 met de beeldgeneratiemethode en sla vervolgens elke geretourneerde afbeeldings-URL met het bijbehorende resultaat op. Een gedocumenteerd startverzoek produceert één afbeelding van 1024x1024 uit tekst.
- Toegestane invoer
- Tekst
- Resultaten
- Afbeeldingen
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Images POST /v1/images/generations
- Invoertypen
text- Uitvoertypen
image- Uitvoerformaat
- Afbeeldingsbestand
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten dall-e-3 | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten false | Standaardfalse |
Veldn | Typeinteger | VereisteOptioneel | Waarden en limieten 1 | Standaard— |
Veldsize | Typestring | VereisteOptioneel | Waarden en limieten 1024x1024 | Standaard— |
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt |
Parameteroptional | Contractstream, n, size |
Parametermaterial_types | Contracttext |
Parameterconditions | ContractUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarieven
Zo worden de uiteindelijke kosten berekend
De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Geschatte tarieven ter vergelijking
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Verwachte hoeveelheid | Kosten |
|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Verwachte hoeveelheid— | Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens |
| ConfiguratieEstimated generation cost | Tariefstaffel— | Verwachte hoeveelheidschatting voor één generatie | Kosten Invoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.32768 schatting vóór generatie This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Resultaten ophalen en opslaan
Ailoot Ultra · Images
Download elke teruggegeven afbeelding of sla de Base64-inhoud ervan op
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Sla elke voltooide afbeelding op; haal elke teruggegeven URL op of decodeer de bijbehorende Base64-inhoud.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasnamen
Modelaliasnamen
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · OpenAI: DALL·E 3
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Welke velden gebruikt het verzoek?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size