ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro vytvára video bez zvuku z textu alebo úvodného obrázka. Opíšte činnosť a kameru alebo rozhýbte existujúcu kompozíciu s trvaním 2–12 sekúnd, 24 fps a samostatnými nastaveniami formátu a rozlíšenia výstupu.

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

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.

Seedance 1.0 Pro vytvára video z textu alebo zo scény určenej obrázkom. Identifikátor doubao-seedance-1-0-pro-250528 podporuje oba vstupné režimy, takže východiskom môže byť písomný koncept alebo existujúca vizuálna kompozícia. Textové zadanie použite na vytvorenie novej scény; obrázok dodajte vtedy, keď chcete hlavný objekt, usporiadanie a úvodný pohľad určiť vizuálne. Tento profil 1.0 vytvára video bez zvuku; synchronizovaný zvuk patrí do samostatne opísaného profilu 1.5 Pro.

Pri tvorbe videa z textu určte hlavný objekt, prostredie, pohyb, kompozíciu a kameru v jednej súvislej scéne. Zdokumentovaný príklad postupne prechádza z poľa margarét na detail kvetu s rosou na lupienkoch. Táto štruktúra sa hodí aj na iné postupné odhalenia: predstavte prostredie, priblížte sa k hlavnému objektu a skončite na dôležitom detaile. Pri produktovom koncepte okrem činnosti opíšte aj materiál a osvetlenie a kamere určte uskutočniteľnú dráhu v rámci krátkeho záberu.

Pri tvorbe videa z obrázka vložte referenciu ako položku obsahu image_url a vysvetlite, čo sa má oproti úvodnému pohľadu zmeniť. Pripravený portrét môže určiť osobu a výrez, kým zadanie opíše malé otočenie, pohyb vlasov alebo jemné vzďaľovanie kamery. Produktová fotografia môže určiť predmet a pozadie, kým prompt žiada kontrolované odhalenie. Požadovaný pohyb musí zodpovedať východiskovej kompozícii; obrázok jednej strany predmetu neposkytuje nevidený presný pohľad na všetky ostatné strany.

Pole pre obrázok prijíma dostupnú URL alebo dátovú URL obsahujúcu obrazové dáta Base64. Zdokumentované formáty sú JPEG, PNG, WEBP, BMP, TIFF a GIF. Obrázky musia byť menšie ako 30 MB, pomer šírky k výške musí byť striktne medzi 0.4 a 2.5 a každý rozmer striktne medzi 300 a 6000 pixelmi. Pripravte jasný podklad s požadovaným výrezom namiesto spoliehania sa na miniatúru, v ktorej už chýbajú určujúce detaily. Pri tvorbe videa z obrázka príručka odporúča adaptívny formát, ktorý sleduje proporcie referencie.

Zdokumentované trvanie pre 1.0 je dve až dvanásť sekúnd a snímková frekvencia je 24 fps. Nastavenia výstupu zahŕňajú úrovne 480p, 720p a 1080p, pričom predvolenou hodnotou Pro je 1080p; príručka vylučuje 1080p pri použití referenčného obrázka. Pevné formáty zahŕňajú 16:9, 4:3, 1:1, 3:4, 9:16 a 21:9. Pre záber vychádzajúci z obrázka zvoľte kombináciu kompatibilnú s obrázkom namiesto nezmeneného preberania všetkých nastavení pre tvorbu z textu. Pred vložením klipu do rozloženia skontrolujte skutočnú vrátenú kompozíciu.

Nastavenia seed a watermark sú zdokumentované spolu s camerafixed. Pokyn pre pevnú kameru sa pri použití referenčného obrázka nepodporuje a tam, kde sa uplatňuje, príručka nezaručuje dokonale nehybnú kameru. Pokyny pre parametre vložené do promptu majú prednosť pred samostatnými voliteľnými poľami. Pre trvanie, rozlíšenie a pomer strán určte jedno záväzné nastavenie a zlaďte s ním opis kamery. Predídete tak tomu, aby zadanie scény nepozorovane prepísalo nastavenia zvolené pre požiadavku.

Spotreba sa meria vo videotokenoch: šírka výstupu × výška výstupu × snímková frekvencia × trvanie výstupu / 1024. Dokončená úloha vykazuje túto veličinu ako usage.completion_tokens. Vykázanú spotrebu uchovajte spolu s hotovým klipom a jeho požadovanými nastaveniami.

Pracovný postup najskôr vráti identifikátor úlohy a po spracovaní umiestnenie dokončeného videa. Identifikátor uchovajte počas kontroly stavu vo fronte alebo prebiehajúceho spracovania; úspešne dokončená úloha poskytne content.video_url a informácie o spotrebe. Zdokumentovaná doba uchovávania vygenerovaného súboru je sedem dní. Hotový klip, zdrojový obrázok a presný prompt uložte ako záznam danej verzie, potom v celom výsledku skontrolujte vzhľad hlavného objektu, pohyb, nadväznosť na obrázok a záverečnú kompozíciu.

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

doubao-seedance-1-0-pro-250528

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

Úvod

Povolené vstupy: Text · Obrázky
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Generovanie videa POST /v1/videos

Vstup: text, image
Výstup: video

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity doubao-seedance-1-0-pro-250528	Predvolené—
Pole`content`	Typ`array`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Natívne objekty textu a médií; vonkajšie pole musí byť neprázdne. Tento všeobecný konštruktor Ailoot neoveruje typy vnorených uzlov.	Predvolené—
Pole`duration`	Typ`integer`	PožiadavkaVoliteľné	Hodnoty a limity Minimum: 2 Maximum: 12 Podmienky: Primárna schéma 1.x uvádza 2–12; neskorší spoločný opis uvádza pri 1.5 hodnoty 4–12 alebo -1. Príklad používa hodnotu 5 zdokumentovanú v oboch prípadoch.	Predvolené5
Pole`resolution`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Potvrdené hodnoty pre generovanie videa z textu sú 480p a 1080p. Vstup referenčného obrázka vylučuje 1080p. Spoločná hodnota enum 720p je v rozpore s textom špecifickým pre model, preto podpora 720p zostáva v oboch režimoch nevyriešená.	Predvolené1080p
Pole`ratio`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Podmienky: Predvolené hodnoty závisia od scény a modelu; dokumentácia vstupu obrázka odporúča adaptive.	Predvolené—
Pole`service_tier`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity default, flex Podmienky: default=online, flex=offline; vyberte pred vytvorením.	Predvolenédefault
Pole`seed`	Typ`integer`	PožiadavkaPovinné	Hodnoty a limity Minimum: -1 Maximum: 4 294 967 295	Predvolené-1
Pole`camerafixed`	Typ`boolean`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Vyžaduje Ailoot; ovládanie kamery pomocou referenčného obrázka je zdokumentované ako nepodporované a účinok nie je zaručený.	Predvolenéfalse
Pole`watermark`	Typ`boolean`	PožiadavkaPovinné	Hodnoty a limity	Predvolenéfalse
Pole`execution_expires_after`	Typ`integer`	PožiadavkaPovinné	Hodnoty a limity Minimum: 3 600 Maximum: 259 200 Jednotka: sekundy	Predvolené172 800

Kombinácie vstupných podkladov

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciacamerafixed, content, execution_expires_after, model, seed, watermark
Parameter`optional`	Špecifikáciaduration, resolution, ratio, service_tier
Parameter`material_types`	Špecifikáciatext, image
Parameter`additional_properties`	Špecifikáciatrue
Parameter`validation_scope`	ŠpecifikáciaAiloot kontroluje povinné typy polí a neprázdny model aj pole content. Ostatné polia požiadavky sa zachovávajú pre vybraný model.
Parameter`image_constraints`	Špecifikácia{"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 metódy: /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

Vytvorte iba raz a zachovajte vrátené verejné id/polling_url.

Priebežne zisťujte stav pôvodnej úlohy; po succeeded stiahnite skutočné content.video_url vo vašom vlastníctve.

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	Účtovacia jednotka	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacia jednotka—	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áciaUltra	Sadzobník—	Odhadované množstvo—	Účtovacia jednotkaza 1K video tokenov	Poplatok Výstup · Odhad iba na porovnanie $0.0044 za 1K video tokenov
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacia jednotka—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.2112 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

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

curl · vytvoriť videocurl · prečítať pôvodnú úlohucurl · stiahnuť 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

Prijať a uložiť výsledky

Ailoot Ultra · Generovanie videa

Natívny JSON s verejným id/polling_url. Po zverejnení obsahuje content.video_url podpísané URL vo vlastníctve Ailoot; pred zverejnením sú vybrané URL výstupov prázdne.

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

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Zachovajte každú skutočnú URL v content.video_url; index musí označovať skutočne vrátený výstup.

Ak treba overiť pôvodnú odpoveď

Zachovajte pôvodnú odpoveď, hlavičky a id a priebežne zisťujte stav tejto operácie; vytvorenie s neznámym výsledkom nikdy znova neodosielajte.

Polia odpovede

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 ďalšie kroky

Odpoveď	Podmienka	Ďalší krok
Odpoveď400 · `invalid_request_error`	PodmienkaNeplatný JSON/model/typy povinných polí alebo index obsahu.	Ďalší krok
Odpoveď401 · `authentication_error`	PodmienkaNeplatný kľúč API služby Ailoot.	Ďalší krok
Odpoveď404 · `not_found_error`	PodmienkaÚloha alebo výstup chýbajú alebo nepatria rovnakému používateľovi, kľúču API či skupine.	Ďalší krok
Odpoveď502 · `result_pending_check`	PodmienkaPôvodné odoslanie alebo stav sú neúplné; zachovajte pôvodné ID a znova neodosielajte.	Ďalší krok
Odpoveď503 · `result_pending_check`	PodmienkaPôvodné médium, trasa alebo zúčtovanie sa kontrolujú; pokračujte v pôvodnej operácii.	Ďalší krok

Aliasy

Aliasy modelov

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

Aliasy ciest metód

/v1/videos/generations

Súvisiace ID na volanie

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

Aké vstupy a výsledky sú dostupné?: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
Aké polia používa požiadavka?: POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
Aké limity platia?: 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