ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro generuje němé video z textu nebo úvodního obrázku. Popište akci a kameru nebo oživte existující kompozici, s délkou 2–12 sekund, 24 fps a výslovným nastavením kompozice a rozlišení výstupu.

Ailoot Ultra · Tvorba videa POST /v1/videos doubao-seedance-1-0-pro-250528

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Seedance 1.0 Pro generuje video z textu nebo ze scény vedené obrázkem. Selektor doubao-seedance-1-0-pro-250528 podporuje oba vstupní režimy, takže výchozím bodem může být písemný koncept nebo existující vizuální kompozice. Textové zadání použijte pro vytvoření nové scény, obrázek dodejte tehdy, když má objekt, uspořádání a úvodní pohled určit vizuální předloha. Tento profil 1.0 vytváří němé video; synchronizovaný zvuk patří samostatně popsanému profilu 1.5 Pro.

Pro generování videa z textu určete objekt, prostředí, pohyb, kompozici a kameru v jedné souvislé scéně. Dokumentovaný příklad postupně přechází od pole sedmikrásek k detailu květiny s kapkami rosy na okvětních lístcích. Tato struktura se hodí i pro jiné odhalení: představte prostředí, přibližte se k objektu a zakončete záběr důležitým detailem. U produktového konceptu popište materiál a osvětlení i akci a dejte kameře proveditelnou trasu v rámci krátkého záběru.

Pro generování videa z obrázku vložte předlohu do položky image_url v poli content a vysvětlete, co se má změnit oproti tomuto výchozímu pohledu. Připravený portrét může určit osobu a výřez, zatímco zadání popisuje malé otočení, pohyb vlasů nebo jemný odjezd kamery. Produktová fotografie může stanovit předmět a pozadí, zatímco prompt žádá řízené odhalení. Přizpůsobte požadovaný pohyb zdrojové kompozici; obrázek jedné strany předmětu neposkytuje neviděný přesný pohled na každou další stranu.

Pole obrázku přijímá dostupnou URL nebo datovou URL s obrazovými daty Base64. Dokumentované formáty jsou JPEG, PNG, WEBP, BMP, TIFF a GIF. Obrázky musí být menší než 30 MB, s poměrem šířky k výšce přísně mezi 0.4 a 2.5 a každým rozměrem přísně mezi 300 a 6000 pixely. Připravte čitelný zdroj v zamýšleném výřezu místo spoléhání na náhled, v němž určující detaily již chybějí. Pro generování videa z obrázku příručka doporučuje kompozici adaptive, která sleduje proporce předlohy.

Dokumentovaná délka pro 1.0 je dvě až dvanáct sekund a snímková frekvence je 24 fps. Nastavení výstupu zahrnuje úrovně 480p, 720p a 1080p, s 1080p jako výchozí hodnotou Pro; příručka vylučuje 1080p ve scénáři s referenčním obrázkem. Pevné poměry zahrnují 16:9, 4:3, 1:1, 3:4, 9:16 a 21:9. Pro záběr vedený obrázkem zvolte kombinaci s ním slučitelnou místo přenesení všech nastavení generování z textu beze změny. Před umístěním klipu do rozvržení zkontrolujte skutečně vrácenou kompozici.

Nastavení seedu a vodoznaku jsou dokumentována spolu s camerafixed. Pokyn pro pevnou kameru není podporován ve scénáři s referenčním obrázkem a tam, kde se uplatňuje, příručka nezaručuje dokonale nehybnou kameru. Pokyny parametrů vložené do promptu mají přednost před samostatnými volitelnými poli. Zachovejte jedno rozhodující nastavení délky, rozlišení a poměru stran a slaďte s ním popis kamery. Tím se zabrání tomu, aby zadání scény nepozorovaně přepsalo nastavení zvolená pro požadavek.

Spotřeba se měří v tokenech videa: výstupní šířka × výstupní výška × snímková frekvence × délka výstupního videa / 1024. Dokončená úloha tuto veličinu hlásí jako usage.completion_tokens. Uchovejte hlášenou spotřebu spolu s hotovým klipem a požadovanými nastaveními.

Průběh nejprve vrací identifikátor úlohy a po zpracování umístění dokončeného videa. Uchovejte identifikátor při kontrole stavů queued nebo running; úloha se stavem succeeded poskytuje content.video_url a informace o spotřebě. Dokumentovaná doba uchování vygenerovaných souborů je sedm dní. Uložte dokončený klip, zdrojový obrázek a přesný prompt jako záznam verze a poté zkontrolujte vzhled objektu, pohyb, návaznost na obrázek a závěrečnou kompozici v celém výsledku.

Ailoot Ultra · Tvorba videa POST /v1/videos doubao-seedance-1-0-pro-250528

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

Úvod

Přijímané vstupy: Text · Obrázky
Výsledky: Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Tvorba videa POST /v1/videos

Vstup: text, image
Výstup: video

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity doubao-seedance-1-0-pro-250528	Výchozí—
Pole`content`	Typ`array`	PožadavekPovinné	Hodnoty a limity Podmínky: Nativní textové a multimediální objekty; vnější pole musí být neprázdné. Tento obecný konstruktor Ailoot nekontroluje typy vnořených uzlů.	Výchozí—
Pole`duration`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: 2 Maximum: 12 Podmínky: Primární schéma 1.x uvádí 2–12; pozdější společný popis uvádí pro 1.5 hodnoty 4–12 nebo -1. Příklad používá hodnotu 5, dokumentovanou v obou případech.	Výchozí5
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Podmínky: Potvrzené hodnoty pro převod textu na video jsou 480p a 1080p. Vstup s referenčním obrázkem vylučuje 1080p. Společný výčet 720p je v rozporu s popisem konkrétního modelu, takže podpora 720p zůstává v obou režimech nevyjasněná.	Výchozí1080p
Pole`ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Podmínky: Výchozí hodnoty závisí na scéně a modelu; dokumentace obrazového vstupu doporučuje adaptive.	Výchozí—
Pole`service_tier`	Typ`string`	PožadavekVolitelné	Hodnoty a limity default, flex Podmínky: default=online, flex=offline; zvolte před vytvořením.	Výchozídefault
Pole`seed`	Typ`integer`	PožadavekPovinné	Hodnoty a limity Minimum: -1 Maximum: 4 294 967 295	Výchozí-1
Pole`camerafixed`	Typ`boolean`	PožadavekPovinné	Hodnoty a limity Podmínky: Ailoot jej vyžaduje; ovládání kamery při použití referenčního obrázku je podle dokumentace nepodporované a jeho účinek není zaručen.	Výchozífalse
Pole`watermark`	Typ`boolean`	PožadavekPovinné	Hodnoty a limity	Výchozífalse
Pole`execution_expires_after`	Typ`integer`	PožadavekPovinné	Hodnoty a limity Minimum: 3 600 Maximum: 259 200 Jednotka: sekundy	Výchozí172 800

Kombinace vstupních materiálů

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktcamerafixed, content, execution_expires_after, model, seed, watermark
Parametr`optional`	Kontraktduration, resolution, ratio, service_tier
Parametr`material_types`	Kontrakttext, image
Parametr`additional_properties`	Kontrakttrue
Parametr`validation_scope`	KontraktAiloot kontroluje typy povinných polí, neprázdný model a neprázdné pole content. Ostatní pole požadavku se zachovávají pro vybraný model.
Parametr`image_constraints`	Kontrakt{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null}

Aliasy metody: /v1/videos/generations

Životní cyklus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/videos/generations/{request_id}/content

Vytvořte pouze jednou a uchovejte vrácené veřejné id/polling_url.

Dotazujte se na původní úlohu; po dosažení stavu succeeded stáhněte skutečný obsah spravovaný službou z content.video_url.

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í	Účtovací jednotka	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	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ů
KonfiguraceUltra	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza 1K videotokenů	Poplatek Výstup · Odhad pouze pro srovnání $0.0044 za 1K videotokenů
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.2112 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

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 · Tvorba videa

curl · vytvořte videocurl · načtěte původní úlohucurl · stáhněte vlastní video

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json

set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
    if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
    p=urlsplit(u)
    if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
  index=$((index + 1))
done < asset-urls.txt

Přijímání a ukládání výsledků

Ailoot Ultra · Tvorba videa

Nativní JSON s veřejným id/polling_url. Po zveřejnění obsahuje content.video_url podepsané URL spravované službou Ailoot; před zveřejněním jsou vybrané výstupní URL prázdné.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Uchovejte každou skutečnou URL v content.video_url; index musí označovat skutečně vrácený výstup.

Pokud je nutné ověřit původní odpověď

Zachovejte původní odpověď, hlavičky a id a dotazujte se na tuto operaci; vytvoření s neznámým výsledkem nikdy znovu neodesílejte.

Pole odpovědi

Pole	Typ
Pole`id`	Typstring
Pole`provider_task_id`	Typstring
Pole`polling_url`	Typstring
Pole`status`	Typstring when supplied
Pole`content.video_url`	Typstring\|string[]
Pole`usage`	Typobject when supplied

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď400 · `invalid_request_error`	PodmínkaNeplatný JSON/model, typy povinných polí nebo index obsahu.	Další krok
Odpověď401 · `authentication_error`	PodmínkaNeplatný klíč API Ailoot.	Další krok
Odpověď404 · `not_found_error`	PodmínkaÚloha či výstup chybí nebo nepatří stejnému uživateli, klíči API či skupině.	Další krok
Odpověď502 · `result_pending_check`	PodmínkaPůvodní odeslání či stav jsou neúplné; zachovejte původní ID, znovu neodesílejte.	Další krok
Odpověď503 · `result_pending_check`	PodmínkaPůvodní médium, trasa či vyúčtování se kontrolují; pokračujte v původní operaci.	Další krok

Aliasy

Aliasy modelu

Ailoot Ultra doubao-seedance-1-0-pro-250528

Aliasy cest metod

/v1/videos/generations

Související ID modelů

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
Jaká pole požadavek používá?: POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
Jaké limity platí?: POST /v1/videos · doubao-seedance-1-0-pro-250528: duration.minimum: 2; duration.maximum: 12; seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 1.0 Pro