ByteDance: Seedance 1.0 Pro Fast
Seedance 1.0 Pro Fast je samostatne pomenovaný profil Fast na tvorbu videa bez zvuku z textu alebo obrázka. Prijíma opis scény alebo kompozíciu určenú obrázkom, s výstupom v trvaní 2–12 sekúnd, 24 fps a samostatnými nastaveniami formátu.
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 Fast je profil Fast s identifikátorom doubao-seedance-1-0-pro-fast-251015. Vytvára video bez zvuku z písomného opisu scény alebo z úvodnej kompozície určenej obrázkom. Konkrétny identifikátor odlišuje tento profil od Seedance 1.0 Pro; slovo Fast neurčuje zaručený čas dokončenia jednotlivej úlohy. Vstupný režim zvoľte podľa toho, čo má určiť scénu, a vrátený klip potom porovnajte so zadaním.
Záber vychádzajúci z textu sa začína stručnou postupnosťou: hlavný objekt a prostredie, činnosť, dráha kamery a konečný pohľad. Pri odhalení produktu opíšte predmet na podložke, svetlo na jeho materiáli a krátky pohyb, ktorý skončí na predstavovanom prvku. Pri koncepte lokality prejdite zo širokého úvodného pohľadu k rozpoznateľnému ústrednému bodu. Od jedného krátkeho klipu nežiadajte niekoľko nesúvisiacich scén, ktorých objekty a prostredia sa musia vždy predstavovať od začiatku.
Záber vychádzajúci z obrázka sa začína položkou image_url v poli content a textovým pokynom pre pohyb. V obrázku pripravte výrez, pozadie a rozmiestnenie objektov, potom uveďte, ktoré prvky sa pohybujú a ako sa správa kamera. Statická kompozícia sa tak môže stať krátkou animovanou scénou. Hodí sa to pre portrét, predmet na stole alebo pripravený vizuálny koncept; skutočný výsledok však treba v celom klipe skontrolovať z hľadiska identity, tvaru a pohybu.
Obrazové vstupy môžu používať dostupnú URL alebo dátovú URL Base64. Zdokumentované formáty sú JPEG, PNG, WEBP, BMP, TIFF a GIF; obrázok musí byť menší ako 30 MB, oba rozmery striktne medzi 300 a 6000 pixelmi a podiel šírky a výšky striktne medzi 0.4 a 2.5. Zvoľte čistý podklad s viditeľnými detailmi hlavného objektu. Príručka pre obrázky odporúča adaptívny formát, preto by proporcie pripraveného podkladu mali zodpovedať kompozícii, ktorú chcete rozhýbať.
Profil 1.0 má zdokumentované trvanie dve až dvanásť sekúnd pri 24 fps. Predvoleným rozlíšením Pro Fast je 1080p a zachovaná tabuľka výstupov uvádza úrovne 480p, 720p a 1080p. Prevádzková príručka vylučuje 1080p pri použití referenčného obrázka. Pevné pomery strán zahŕňajú 16:9, 4:3, 1:1, 3:4, 9:16 a 21:9. Rozlíšenie a formát vyberte podľa zvoleného vstupného režimu namiesto predpokladu, že všetky kombinácie sú zameniteľné.
Voľby seed a watermark pomáhajú výslovne určiť nastavenia požiadavky. Rozsah celočíselnej hodnoty seed je od -1 do 2^32-1; -1 žiada náhodný výber. Pokyn pre pevnú kameru má podmienky: príručka ho vylučuje pri použití referenčného obrázka a nezaručuje vizuálny účinok tam, kde je podporovaný. Príkazy pre parametre vložené do textu prepisujú samostatné voliteľné parametre. Udržujte tieto pokyny v zhode, najmä pri úprave promptu, v ktorého opise scény by inak mohol zostať starý príkaz pre trvanie či rozlíšenie.
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.
Odoslanie vytvorí asynchrónnu úlohu. Uložte jej identifikátor, sledujte stav a po úspešnom dokončení získajte hotové video z content.video_url. Podľa dokumentácie sa vygenerované súbory uchovávajú sedem dní, preto hotový výsledok uložte spolu s promptom a prípadným vstupným obrázkom. Skontrolujte celú činnosť, pohyb kamery a konečnú kompozíciu; ak jeden detail nezodpovedá zadaniu, opíšte túto konkrétnu opravu a zachovajte časti, ktoré sa vydarili.
Ailoot Ultra · Generovanie videa POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Úvod
Seedance 1.0 Pro Fast je samostatne pomenovaný profil Fast na tvorbu videa bez zvuku z textu alebo obrázka. Prijíma opis scény alebo kompozíciu určenú obrázkom, s výstupom v trvaní 2–12 sekúnd, 24 fps a samostatnými nastaveniami formátu.
- 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é |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity doubao-seedance-1-0-pro-fast-251015 | Predvolené— |
Polecontent | Typarray | 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é— |
Poleduration | Typinteger | 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 |
Poleresolution | Typstring | 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 |
Poleratio | Typstring | 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é— |
Poleservice_tier | Typstring | PožiadavkaVoliteľné | Hodnoty a limity default, flex Podmienky: default=online, flex=offline; vyberte pred vytvorením. | Predvolenédefault |
Poleseed | Typinteger | PožiadavkaPovinné | Hodnoty a limity Minimum: -1 Maximum: 4 294 967 295 | Predvolené-1 |
Polecamerafixed | Typboolean | 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 |
Polewatermark | Typboolean | PožiadavkaPovinné | Hodnoty a limity | Predvolenéfalse |
Poleexecution_expires_after | Typinteger | 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 |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciacamerafixed, content, execution_expires_after, model, seed, watermark |
Parameteroptional | Špecifikáciaduration, resolution, ratio, service_tier |
Parametermaterial_types | Špecifikáciatext, image |
Parameteradditional_properties | Špecifikáciatrue |
Parametervalidation_scope | ŠpecifikáciaAiloot kontroluje povinné typy polí a neprázdny model aj pole content. Ostatné polia požiadavky sa zachovávajú pre vybraný model. |
Parameterimage_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.0012 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.0576 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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","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}/contentGET /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 |
|---|---|
Poleid | Typstring |
Poleprovider_task_id | Typstring |
Polepolling_url | Typstring |
Polestatus | Typstring when supplied |
Polecontent.video_url | Typstring|string[] |
Poleusage | 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-fast-251015
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Aké limity platia?
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200