OpenAI: DALL·E 3
DALL·E 3 generuje obrázky z písomného zadania scény. Použite presné ID modelu openai/dall-e-3 alebo jeho alias dall-e-3 s metódou generovania obrázkov a potom uložte každú vrátenú URL obrázka a sprievodný výsledok. Zdokumentovaná východisková požiadavka vytvára z textu jeden obrázok 1024x1024.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
DALL·E 3 je model OpenAI na vytváranie obrázkov z textu. Písomným zadaním vytvorte ilustráciu, koncept scény alebo vizuálne smerovanie návrhu. V zadaní opíšte hlavný motív, prostredie, kompozíciu, osvetlenie a výtvarné spracovanie. Napríklad konceptové zadanie môže požadovať doručovací bicykel vedľa malého obchodu za súmraku, pohľad z ulice s jasným hlavným motívom v popredí a striedmou farebnou paletou.
Odošlite POST /v1/images/generations s telom application/json. Presné verejné ID modelu je openai/dall-e-3; povolený alias dall-e-3 vyberá tú istú kartu modelu. Zdokumentovaný východiskový tvar zadáva model, prompt, n:1 a size:"1024x1024". n je voliteľné celé číslo s predvolenou hodnotou 1. Pre úplný výsledok JSON odošlite stream:false alebo stream vynechajte. Použite neprázdne textové zadanie a túto požiadavku zamerajte na jedno úplné obrazové zadanie. Ponúkanou metódou je generovanie obrázkov z textu.
Výslovne určte požiadavky dôležité pre umiestnenie. Redakčná ilustrácia môže pomenovať ústrednú myšlienku a predmety, ktoré ju vyjadrujú. Koncept scény môže určiť polohu kamery, dennú dobu a časti kompozície, ktoré potrebujú okolo seba priestor. Presné znenie, ktoré sa musí objaviť na obrázku, oddeľte od opisov scény a potom pred použitím vybraného výsledku skontrolujte vykreslené nápisy a vizuálne rozmiestnenie.
Odpoveď generovania je JSON s časovou značkou created a poľom data. Zdokumentovaná položka výsledku obsahuje url a môže obsahovať revised_prompt, prompt_filter_results a content_filter_results. Tieto polia zachovajte spolu s úplnou odpoveďou a stiahnite obrázok na každej vrátenej podpísanej URL Ailoot. Podpísané odkazy na súbory Ailoot platia 24 hodín od vydania. Presnú vrátenú URL vrátane reťazca dopytu uchovajte, kým sa súbor neuloží; formát uloženého obrázka určte podľa skutočnej odpovede alebo bajtov súboru.
Vrátený obrazový súbor považujte za použiteľný dizajnový podklad a JSON za jeho sprievodný záznam generovania. Pred umiestnením na stránku, do prezentácie alebo aplikácie porovnajte obrázok s dodaným zadaním. Ak je odpoveď neúplná alebo výsledok odoslania neistý, počas kontroly existujúceho pokusu zachovajte pôvodný identifikátor požiadavky a vrátené informácie namiesto vytvárania ďalšieho obrázka iba na obnovenie chýbajúceho výsledku. Na získanie uložených výsledkov pomocou rovnakého kľúča API vykonajte GET /v1/media/assets?family=image a prejdite každú hodnotu next_cursor. ID súboru sa nachádza v každej vrátenej URL /v1/media/assets/{asset_id}/content a v jeho zázname v knižnici médií. Pre každý vybraný záznam načítajte GET /v1/media/assets/{asset_id} a stiahnite jeho presné content_url. Ak požiadavka na súbor vráti 404 s kódom link_expired, načítajte ten istý súbor znova a získajte obnovený odkaz. Obnovenie odkazu na súbor nevyžaduje ďalšiu požiadavku na generovanie obrázka.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Úvod
DALL·E 3 generuje obrázky z písomného zadania scény. Použite presné ID modelu openai/dall-e-3 alebo jeho alias dall-e-3 s metódou generovania obrázkov a potom uložte každú vrátenú URL obrázka a sprievodný výsledok. Zdokumentovaná východisková požiadavka vytvára z textu jeden obrázok 1024x1024.
- Povolené vstupy
- Text
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text- Výstup
image- Výstupný formát
- Súbor obrázka
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity openai/dall-e-3 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolenéfalse |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 1 | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1024x1024 | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciastream, n, size |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | ŠpecifikáciaUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaEstimated generation cost | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Vstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.32768 odhad pred generovaním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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.
Prijať a uložiť výsledky
Ailoot Ultra · Images
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ak treba overiť pôvodnú odpoveď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelov
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Úvod
DALL·E 3 generuje obrázky z písomného zadania scény. Použite presné ID modelu openai/dall-e-3 alebo jeho alias dall-e-3 s metódou generovania obrázkov a potom uložte každú vrátenú URL obrázka a sprievodný výsledok. Zdokumentovaná východisková požiadavka vytvára z textu jeden obrázok 1024x1024.
- Povolené vstupy
- Text
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text- Výstup
image- Výstupný formát
- Súbor obrázka
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity dall-e-3 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polestream | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolenéfalse |
Polen | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 1 | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1024x1024 | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciastream, n, size |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | ŠpecifikáciaUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Životný cyklus: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaEstimated generation cost | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Vstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.32768 odhad pred generovaním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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.
Prijať a uložiť výsledky
Ailoot Ultra · Images
Stiahnite každý vrátený obrázok alebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovať všetky dokončené výsledky
Uložte každý dokončený obrázok; stiahnite obsah z každej vrátenej URL alebo dekódujte jeho obsah Base64.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Ak treba overiť pôvodnú odpoveď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelov
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · OpenAI: DALL·E 3
- Aké vstupy a výsledky sú dostupné?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Aké polia používa požiadavka?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size