OpenAI: DALL·E 3
DALL·E 3 genererar bilder utifrån en skriftlig scenbeskrivning. Använd det exakta modell-ID:t openai/dall-e-3 eller dess alias dall-e-3 med bildgenereringsmetoden och spara sedan varje returnerad bild-URL och det medföljande resultatet. En dokumenterad startförfrågan skapar en 1024x1024-bild från text.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
DALL·E 3 är OpenAI:s modell för text till bild. Använd en skriftlig beskrivning för att skapa en illustration, ett scenkoncept eller en visuell riktning för en design. Beskriv motiv, miljö, komposition, ljussättning och behandling i prompten. En konceptbeskrivning kan exempelvis begära en leveranscykel bredvid en liten butik i skymningen, sedd från gatan, med ett tydligt förgrundsmotiv och en återhållsam färgpalett.
Skicka POST /v1/images/generations med en application/json-kropp. Det exakta offentliga modell-ID:t är openai/dall-e-3; det godkända aliaset dall-e-3 väljer samma modellbeskrivning. Den dokumenterade startstrukturen innehåller model, prompt, n:1 och size:"1024x1024". n är ett valfritt heltal med standardvärdet 1. Skicka stream:false eller utelämna stream för hela JSON-resultatet. Använd en icke-tom textprompt och håll förfrågan fokuserad på en fullständig bildbeskrivning. Den erbjudna metoden är bildgenerering från text.
Ange uttryckligen de krav som har betydelse för placeringen. En redaktionell illustration kan ange huvudidén och föremålen som uttrycker den. Ett scenkoncept kan ange kamerans position, tid på dagen och vilka delar av kompositionen som behöver utrymme omkring sig. Håll exakt ordalydelse som måste synas i bilden åtskild från scenbeskrivningen och granska sedan den renderade texten och det visuella arrangemanget innan du använder det valda resultatet.
Genereringssvaret är JSON med en created-tidsstämpel och en data-array. Det dokumenterade resultatobjektet innehåller url och kan innehålla revised_prompt, prompt_filter_results och content_filter_results. Bevara dessa fält med hela svaret och hämta bilden från varje returnerad signerad Ailoot-URL. Ailoots signerade fillänkar gäller i 24 timmar från utfärdandet. Behåll exakt den returnerade URL:en, inklusive frågesträngen, tills filen är sparad; fastställ det sparade bildformatet från det faktiska svaret eller filens byte.
Behandla den returnerade bildfilen som den användbara designtillgången och JSON-svaret som dess medföljande genereringspost. Granska bilden mot den tillhandahållna beskrivningen innan den placeras på en sida, i en presentation eller i en applikation. Om svaret är ofullständigt eller utfallet av sändningen är osäkert behåller du den ursprungliga förfrågningsidentifieraren och den returnerade informationen medan du kontrollerar det befintliga försöket, i stället för att skapa en ny bild enbart för att återfå det saknade resultatet. För att hämta sparade resultat använder du samma API-nyckel för GET /v1/media/assets?family=image och följer varje next_cursor. Tillgångens ID visas i varje returnerad /v1/media/assets/{asset_id}/content-URL och i dess mediebibliotekspost. Läs GET /v1/media/assets/{asset_id} för varje vald post och hämta dess exakta content_url. Om filförfrågan returnerar 404 med koden link_expired läser du samma tillgång igen för att få en uppdaterad länk. Att uppdatera en tillgångslänk kräver ingen ny bildgenereringsförfrågan.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Start
DALL·E 3 genererar bilder utifrån en skriftlig scenbeskrivning. Använd det exakta modell-ID:t openai/dall-e-3 eller dess alias dall-e-3 med bildgenereringsmetoden och spara sedan varje returnerad bild-URL och det medföljande resultatet. En dokumenterad startförfrågan skapar en 1024x1024-bild från text.
- Godkända indata
- Text
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Images POST /v1/images/generations
- Indatatyper
text- Utdatatyper
image- Utdataformat
- Bildfil
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser openai/dall-e-3 | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältstream | Typboolean | KravValfritt | Värden & gränser false | Standardfalse |
Fältn | Typinteger | KravValfritt | Värden & gränser 1 | Standard— |
Fältsize | Typstring | KravValfritt | Värden & gränser 1024x1024 | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parameteroptional | Avtalstream, n, size |
Parametermaterial_types | Avtaltext |
Parameterconditions | AvtalUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationEstimated generation cost | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Indata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.32768 uppskattning före generering This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
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.
Ta emot och spara resultat
Ailoot Ultra · Images
Ladda ned varje returnerad bild eller spara dess Base64-innehåll
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Om det ursprungliga svaret behöver kontrolleras
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Modellalias
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Start
DALL·E 3 genererar bilder utifrån en skriftlig scenbeskrivning. Använd det exakta modell-ID:t openai/dall-e-3 eller dess alias dall-e-3 med bildgenereringsmetoden och spara sedan varje returnerad bild-URL och det medföljande resultatet. En dokumenterad startförfrågan skapar en 1024x1024-bild från text.
- Godkända indata
- Text
- Resultat
- Bilder
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Images POST /v1/images/generations
- Indatatyper
text- Utdatatyper
image- Utdataformat
- Bildfil
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser dall-e-3 | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältstream | Typboolean | KravValfritt | Värden & gränser false | Standardfalse |
Fältn | Typinteger | KravValfritt | Värden & gränser 1 | Standard— |
Fältsize | Typstring | KravValfritt | Värden & gränser 1024x1024 | Standard— |
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt |
Parameteroptional | Avtalstream, n, size |
Parametermaterial_types | Avtaltext |
Parameterconditions | AvtalUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Livscykel: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgift |
|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationEstimated generation cost | Prislista— | Prognostiserad mängduppskattning för en generering | Avgift Indata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.32768 uppskattning före generering This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Exempelbegäranden
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.
Ta emot och spara resultat
Ailoot Ultra · Images
Ladda ned varje returnerad bild eller spara dess Base64-innehåll
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behåll alla färdiga resultat
Spara varje färdig bild; hämta varje returnerad URL eller avkoda dess Base64-innehåll.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Om det ursprungliga svaret behöver kontrolleras
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Modellalias
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · OpenAI: DALL·E 3
- Vilka indata och resultat finns?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Vilka fält använder begäran?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size