OpenAI: DALL·E 3
DALL·E 3 generuje obrázky z písemného zadání scény. Použijte přesné ID modelu openai/dall-e-3 nebo jeho alias dall-e-3 s metodou generování obrázků a poté uložte všechna vrácená URL obrázků i doprovodný výsledek. Dokumentovaný výchozí požadavek vytváří z textu jeden obrázek 1024x1024.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
DALL·E 3 je model OpenAI pro převod textu na obrázek. Písemným zadáním vytvořte ilustraci, koncept scény nebo vizuální směr návrhu. V zadání popište subjekt, prostředí, kompozici, osvětlení a zpracování. Například zadání konceptu může požadovat rozvážkové kolo vedle malého obchodu za soumraku, viděné z ulice, s jasným subjektem v popředí a střídmou barevnou paletou.
Odešlete POST /v1/images/generations s tělem application/json. Přesné veřejné ID modelu je openai/dall-e-3; povolený alias dall-e-3 vybírá stejnou kartu modelu. Dokumentovaná výchozí podoba poskytuje model, prompt, n:1 a size:"1024x1024". n je volitelné celé číslo s výchozí hodnotou 1. Pro úplný výsledek JSON odešlete stream:false nebo stream vynechte. Použijte neprázdný textový prompt a tento požadavek zaměřte na jedno úplné zadání obrázku. Nabízenou metodou je generování obrázku z textu.
Požadavky podstatné pro umístění uveďte výslovně. Redakční ilustrace může pojmenovat hlavní myšlenku a předměty, které ji vyjadřují. Koncept scény může určit polohu kamery, denní dobu a části kompozice, které potřebují prostor kolem sebe. Přesné znění, které se musí objevit v obrázku, oddělte od popisů scény a poté před použitím vybraného výsledku zkontrolujte vykreslený text a vizuální uspořádání.
Odpověď generování je JSON s časovým razítkem created a polem data. Dokumentovaná položka výsledku zahrnuje url a může obsahovat revised_prompt, prompt_filter_results a content_filter_results. Tato pole uchovejte s úplnou odpovědí a stáhněte obrázek na každém vráceném podepsaném URL Ailoot. Podepsané odkazy na soubory Ailoot platí 24 hodin od vydání. Přesné vrácené URL včetně řetězce dotazu uchovejte do uložení souboru; formát uloženého obrázku určete podle skutečné odpovědi nebo bajtů souboru.
Vrácený obrazový soubor považujte za použitelný návrhový prostředek a JSON za jeho doprovodný záznam generování. Před umístěním na stránku, do prezentace nebo aplikace porovnejte obrázek s dodaným zadáním. Pokud je odpověď neúplná nebo je výsledek odeslání nejistý, při kontrole existujícího pokusu uchovejte původní identifikátor požadavku a vrácené informace, místo abyste vytvářeli další obrázek pouze kvůli získání chybějícího výsledku. Pro načtení uložených výsledků použijte stejný klíč API k GET /v1/media/assets?family=image a projděte každý next_cursor. ID prostředku se objevuje v každém vráceném URL /v1/media/assets/{asset_id}/content a v jeho záznamu mediální knihovny. Pro každý vybraný záznam přečtěte GET /v1/media/assets/{asset_id} a stáhněte jeho přesný content_url. Pokud požadavek na soubor vrátí 404 s kódem link_expired, přečtěte tentýž prostředek znovu a získáte obnovený odkaz. Obnovení odkazu na prostředek nevyžaduje další požadavek na generování obrázku.
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ísemného zadání scény. Použijte přesné ID modelu openai/dall-e-3 nebo jeho alias dall-e-3 s metodou generování obrázků a poté uložte všechna vrácená URL obrázků i doprovodný výsledek. Dokumentovaný výchozí požadavek vytváří z textu jeden obrázek 1024x1024.
- Přijímané vstupy
- Text
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text- Výstup
image- Výstupní formát
- Soubor obrázku
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity openai/dall-e-3 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polestream | Typboolean | PožadavekVolitelné | Hodnoty a limity false | Výchozífalse |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity 1 | Výchozí— |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity 1024x1024 | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktstream, n, size |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUse 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}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceEstimated generation cost | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Vstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.32768 odhad před generováním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
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.
Přijímání a ukládání výsledků
Ailoot Ultra · Images
Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovejte všechny dokončené výsledky
Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte 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.
Pokud je nutné ověřit původní odpověď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelu
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
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ísemného zadání scény. Použijte přesné ID modelu openai/dall-e-3 nebo jeho alias dall-e-3 s metodou generování obrázků a poté uložte všechna vrácená URL obrázků i doprovodný výsledek. Dokumentovaný výchozí požadavek vytváří z textu jeden obrázek 1024x1024.
- Přijímané vstupy
- Text
- Výsledky
- Obrázky
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Images POST /v1/images/generations
- Vstup
text- Výstup
image- Výstupní formát
- Soubor obrázku
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity dall-e-3 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polestream | Typboolean | PožadavekVolitelné | Hodnoty a limity false | Výchozífalse |
Polen | Typinteger | PožadavekVolitelné | Hodnoty a limity 1 | Výchozí— |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity 1024x1024 | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktstream, n, size |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktUse 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}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceEstimated generation cost | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Vstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.32768 odhad před generováním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
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.
Přijímání a ukládání výsledků
Ailoot Ultra · Images
Stáhněte každý vrácený obrázek nebo uložte jeho obsah Base64
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Uchovejte všechny dokončené výsledky
Uložte každý dokončený obrázek; stáhněte obsah každé vrácené URL nebo dekódujte 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.
Pokud je nutné ověřit původní odpověď
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Aliasy
Aliasy modelu
Ailoot Ultra openai/dall-e-3, dall-e-3
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · OpenAI: DALL·E 3
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Jaká pole požadavek používá?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size