OpenAI: DALL·E 3
A DALL·E 3 írásos jelenetleírásból generál képeket. A képgenerálási metódussal használja a pontos openai/dall-e-3 modellazonosítót vagy annak dall-e-3 aliasát, majd mentse el az összes visszaadott kép-URL-t és a kapcsolódó eredményt. A dokumentált kezdő kérés szövegből egyetlen 1024x1024 méretű képet készít.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A DALL·E 3 az OpenAI szövegből képet létrehozó modellje. Írásos leírással készítsen illusztrációt, jelenetkoncepciót vagy egy terv vizuális irányát. A promptban írja le a témát, a környezetet, a kompozíciót, a világítást és a megjelenítés módját. Egy koncepcióleírás például kérhet egy kis üzlet mellett, alkonyatkor álló szállítókerékpárt, az utcáról nézve, egyértelmű előtéri témával és visszafogott színpalettával.
Küldjön POST /v1/images/generations kérést application/json törzzsel. A pontos nyilvános modellazonosító openai/dall-e-3; az elfogadott dall-e-3 alias ugyanazt a modellkártyát választja ki. A dokumentált kezdő szerkezet model, prompt, n:1 és size:"1024x1024" mezőt ad meg. Az n opcionális egész szám, alapértéke 1. A teljes JSON-eredményhez küldjön stream:false értéket, vagy hagyja el a stream mezőt. Használjon nem üres szöveges promptot, és ezt a kérést egyetlen teljes képleírásra összpontosítsa. A kínált metódus szövegből történő képgenerálás.
Fogalmazza meg egyértelműen az elhelyezés szempontjából fontos követelményeket. Egy szerkesztőségi illusztráció megnevezheti a központi gondolatot és az azt kifejező tárgyakat. Egy jelenetkoncepció meghatározhatja a kamera helyzetét, a napszakot és azt, a kompozíció mely részei körül szükséges szabad tér. A képen megjelenítendő pontos szöveget tartsa külön a jelenet leírásától, majd a kiválasztott eredmény felhasználása előtt ellenőrizze a megjelenített feliratokat és a vizuális elrendezést.
A generálási válasz JSON, created időbélyeggel és data tömbbel. A dokumentált eredményelem tartalmaz url mezőt, és revised_prompt, prompt_filter_results és content_filter_results mezőt is tartalmazhat. Ezeket a mezőket őrizze meg a teljes válasszal együtt, és töltse le a képet minden visszaadott, aláírt Ailoot URL-ről. Az Ailoot aláírt fájlhivatkozásai a kiadástól számított 24 óráig érvényesek. A fájl mentéséig tartsa meg a pontos visszaadott URL-t, a lekérdezési karakterlánccal együtt; az elmentett kép formátumát a tényleges válaszból vagy a fájl bájtjaiból állapítsa meg.
A visszaadott képfájlt kezelje felhasználható tervezési elemként, a JSON-t pedig a hozzá tartozó generálási nyilvántartásként. Mielőtt oldalba, prezentációba vagy alkalmazásba illeszti, ellenőrizze a képet a megadott leírás alapján. Ha a válasz hiányos vagy a küldés kimenetele bizonytalan, a meglévő próbálkozás ellenőrzése közben őrizze meg az eredeti kérés azonosítóját és a visszaadott adatokat, ahelyett, hogy pusztán a hiányzó eredmény visszaszerzéséért új képet hozna létre. A mentett eredmények lekéréséhez ugyanazzal az API-kulccsal küldjön GET /v1/media/assets?family=image kérést, és kövessen minden next_cursor értéket. A médiaelem azonosítója minden visszaadott /v1/media/assets/{asset_id}/content URL-ben és a médiatári rekordjában megjelenik. Minden kiválasztott rekordhoz olvassa ki a GET /v1/media/assets/{asset_id} végpontot, és töltse le annak pontos content_url tartalmát. Ha a fájlkérés 404 választ ad link_expired kóddal, olvassa ki újra ugyanazt a médiaelemet a frissített hivatkozás megszerzéséhez. A médiaelem hivatkozásának frissítéséhez nem szükséges újabb képgenerálási kérés.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Kezdő lépések
A DALL·E 3 írásos jelenetleírásból generál képeket. A képgenerálási metódussal használja a pontos openai/dall-e-3 modellazonosítót vagy annak dall-e-3 aliasát, majd mentse el az összes visszaadott kép-URL-t és a kapcsolódó eredményt. A dokumentált kezdő kérés szövegből egyetlen 1024x1024 méretű képet készít.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Képek
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Images POST /v1/images/generations
- Bemenet
text- Kimenet
image- Kimeneti formátum
- Képfájl
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok openai/dall-e-3 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok false | Alapértelmezettfalse |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok 1 | Alapértelmezett— |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok 1024x1024 | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződésstream, n, size |
Paramétermaterial_types | Szerződéstext |
Paraméterconditions | SzerződésUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításEstimated generation cost | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Bemenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.32768 becslés a generálás előtt This estimate is not an additional charge or a fixed rate for the completed generation. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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.
Eredmények fogadása és mentése
Ailoot Ultra · Images
Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ha az eredeti választ ellenőrizni kell
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Álnevek
Modell álnevei
Ailoot Ultra openai/dall-e-3, dall-e-3
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Kezdő lépések
A DALL·E 3 írásos jelenetleírásból generál képeket. A képgenerálási metódussal használja a pontos openai/dall-e-3 modellazonosítót vagy annak dall-e-3 aliasát, majd mentse el az összes visszaadott kép-URL-t és a kapcsolódó eredményt. A dokumentált kezdő kérés szövegből egyetlen 1024x1024 méretű képet készít.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Képek
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Images POST /v1/images/generations
- Bemenet
text- Kimenet
image- Kimeneti formátum
- Képfájl
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok dall-e-3 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Mezőstream | Típusboolean | KövetelményOpcionális | Értékek és korlátok false | Alapértelmezettfalse |
Mezőn | Típusinteger | KövetelményOpcionális | Értékek és korlátok 1 | Alapértelmezett— |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok 1024x1024 | Alapértelmezett— |
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paraméteroptional | Szerződésstream, n, size |
Paramétermaterial_types | Szerződéstext |
Paraméterconditions | SzerződésUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Életciklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Díj |
|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításEstimated generation cost | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Díj Bemenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.32768 becslés a generálás előtt This estimate is not an additional charge or a fixed rate for the completed generation. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
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.
Eredmények fogadása és mentése
Ailoot Ultra · Images
Töltsön le minden visszaadott képet, vagy mentse a Base64-tartalmat
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült képet; töltse le az összes visszaadott URL tartalmát, vagy dekódolja a Base64-tartalmat.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ha az eredeti választ ellenőrizni kell
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Álnevek
Modell álnevei
Ailoot Ultra openai/dall-e-3, dall-e-3
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · OpenAI: DALL·E 3
- Milyen bemenetek és eredmények érhetők el?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Mely mezőket használja a kérés?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size