ByteDance: Seedance 1.5 Pro
Seedance 1.5 Pro vytvára video z textu alebo obrázka a dokáže vytvoriť synchronizované hlasy, efekty a hudbu na pozadí. Zvuk možno zapnúť alebo vypnúť; zdokumentovaný profil ponúka scény v trvaní 4–12 sekúnd, adaptívny formát a spracovanie online alebo flex.
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.5 Pro vytvára video z textu alebo obrázka a dokáže generovať zvuk spolu s obrazom. Konkrétny identifikátor je doubao-seedance-1-5-pro-251215. Nastavenie zvuku ho odlišuje od profilov Seedance 1.0 bez zvuku: generate_audio=true žiada synchronizovaný zvuk, kým false žiada video bez zvuku. Písomný opis scény použite pre nový koncept alebo obrázkom určte úvodný hlavný objekt a kompozíciu.
Vizuálnu činnosť a zvuk opíšte ako súčasti tej istej scény. Určte hlavný objekt, prostredie, pohyb a kameru, potom vysvetlite zamýšľané hlasy, zvukové efekty alebo hudbu na pozadí. Portrétna scéna môže zobrazovať človeka, ktorý otvára oči, zatiaľ čo sa kamera pomaly vzďaľuje a v okolí znie vietor. Pri produktovej scéne spojte zvuk s viditeľnou udalosťou, napríklad s otvorením veka alebo dotykom predmetu s povrchom, namiesto pridávania nesúvisiaceho zoznamu efektov.
Model dokáže z promptu a vizuálneho obsahu vytvoriť hlasy, efekty a hudbu na pozadí. Príručka odporúča vkladať hovorené dialógy do dvojitých úvodzoviek. Reč musí byť dostatočne krátka vzhľadom na požadovanú činnosť a pauzy; pri viacerých postavách rozlíšte, kto hovorí. Skontrolujte skutočné znenie, priradenie hlasov a synchronizáciu s obrazom. Zvukový pokyn usmerňuje generované podanie; v zdokumentovanej požiadavke tohto profilu nejde o samostatný nahraný hlasový referenčný vstup.
Tvorba videa z obrázka používa položku image_url spolu s textom. Dodajte dostupnú URL obrázka alebo dátovú URL Base64 vo formáte JPEG, PNG, WEBP, BMP, TIFF či GIF. Zdokumentované limity obrázka sú menej ako 30 MB, oba rozmery striktne medzi 300 a 6000 pixelmi a pomer šírky k výške striktne medzi 0.4 a 2.5. Jasne pripravte požadovaný výrez a hlavný objekt, potom opíšte pohyb vychádzajúci z tejto kompozície. Príklad s obrázkom používa adaptívny pomer strán, ktorý sleduje referenciu.
Príručka trvania pre tento profil uvádza celé sekundy od štyroch do dvanástich alebo -1, pri ktorom model vyberie trvanie v danom rozsahu. Predvolené trvanie je päť sekúnd. Seedance 1.5 Pro má predvolené rozlíšenie 720p a zachovaná tabuľka profilu uvádza 480p a 720p; samostatná prevádzková príručka neponúka 1080p pre 1.5 Pro. Pevné pomery strán zahŕňajú 16:9, 4:3, 1:1, 3:4, 9:16 a 21:9; zdokumentovanou predvolenou hodnotou pre 1.5 je adaptive. Skontrolujte skutočné trvanie a proporcie klipu namiesto považovania požadovaných hodnôt za už vrátený výsledok.
Požiadavka sprístupňuje dve úrovne spracovania. service_tier=default volí online spracovanie, kým flex volí offline spracovanie pre prácu, ktorá znesie väčšie oneskorenie. Po odoslaní úlohy sa úroveň nedá zmeniť. Vyberte ju podľa časových potrieb pracovného postupu a uchovajte voľbu v zázname požiadavky. Režim zvuku a úroveň spracovania sú samostatné voľby: klip bez zvuku sa automaticky nestáva offline úlohou a zapnutie zvuku nevolí úroveň spracovania.
Pokyny pre seed, watermark a kameru udržujte v zhode so scénou. Príkazy pre parametre vložené do textu majú prednosť pred samostatnými voliteľnými parametrami. Nastavenie pevnej kamery je pri použití referenčného obrázka vylúčené a tam, kde sa uplatňuje, nezaručuje nehybný obraz. Pri animácii vychádzajúcej z obrázka vysvetlite zamýšľaný pohyb priamo; nepredpokladajte, že nastavenie kamery odstráni potrebu opísať záber.
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. Zapnutý alebo vypnutý zvuk a spracovanie online alebo flex zostávajú v účtovaní podľa spotreby odlišnými kategóriami.
Odoslanie vráti identifikátor asynchrónnej úlohy. Sledujte úlohu až do dokončenia a potom uložte video poskytnuté v content.video_url. Zdokumentovaná doba uchovávania vygenerovaného súboru je sedem dní. Platnosť sa meria od vytvorenia, má predvolenú hodnotu 172800 sekúnd a prijíma hodnoty od 3600 do 259200 sekúnd; nedokončenej úlohe po uplynutí nastaveného intervalu vyprší platnosť. Finálny klip, pôvodný obrázok a presné obrazové aj zvukové zadanie uchovajte spolu, potom v celom výsledku skontrolujte činnosť, identitu, nadväznosť pohybu kamery a zladenie zvuku.
Ailoot Ultra · Generovanie videa POST /v1/videos doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215Úvod
Seedance 1.5 Pro vytvára video z textu alebo obrázka a dokáže vytvoriť synchronizované hlasy, efekty a hudbu na pozadí. Zvuk možno zapnúť alebo vypnúť; zdokumentovaný profil ponúka scény v trvaní 4–12 sekúnd, adaptívny formát a spracovanie online alebo flex.
- 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-5-pro-251215 | 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 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 480p, 720p Podmienky: Seedance 1.5 Pro podporuje 480p a 720p; 1080p je vylúčené. Zdokumentované predvolené rozlíšenie je 720p. | Predvolené720p |
Poleratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Podmienky: Zdokumentovaný predvolený pomer strán Seedance 1.5 Pro je adaptive. Voľby pevných pomerov strán zostávajú nezmenené. | Predvolenéadaptive |
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 |
Polegenerate_audio | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Synchronizovaný zvuk vložený do vygenerovaného videa iba pri 1.5. | Predvolenétrue |
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, generate_audio |
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 | Generovať audio | Úroveň služby | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Generovať audio— | Úroveň služby— | Úč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áciaÚroveň služby: offline spracovanie (flex). Výstup so synchronizovaným zvukom. | Sadzobník— | Odhadované množstvo— | Generovať audioS audiom | Úroveň službyflex | Účtovacia jednotkaza 1K video tokenov | Poplatok Výstup · Odhad iba na porovnanie $0.0024 za 1K video tokenov |
| KonfiguráciaÚroveň služby: offline spracovanie (flex). Výstup bez synchronizovaného zvuku. | Sadzobník— | Odhadované množstvo— | Generovať audioBez audia | Úroveň službyflex | Účtovacia jednotkaza 1K video tokenov | Poplatok Výstup · Odhad iba na porovnanie $0.0012 za 1K video tokenov |
| KonfiguráciaÚroveň služby: online spracovanie (default). Výstup so synchronizovaným zvukom. | Sadzobník— | Odhadované množstvo— | Generovať audioS audiom | Úroveň službydefault | Účtovacia jednotkaza 1K video tokenov | Poplatok Výstup · Odhad iba na porovnanie $0.0048 za 1K video tokenov |
| KonfiguráciaÚroveň služby: online spracovanie (default). Výstup bez synchronizovaného zvuku. | Sadzobník— | Odhadované množstvo— | Generovať audioBez audia | Úroveň službydefault | Účtovacia jednotkaza 1K video tokenov | Poplatok Výstup · Odhad iba na porovnanie $0.0024 za 1K video tokenov |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Generovať audio— | Úroveň služby— | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.1152 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-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}
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-5-pro-251215
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · ByteDance: Seedance 1.5 Pro
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·doubao-seedance-1-5-pro-251215:text,image→video- Aké polia používa požiadavka?
POST /v1/videos·doubao-seedance-1-5-pro-251215:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after,generate_audio- Aké limity platia?
POST /v1/videos·doubao-seedance-1-5-pro-251215:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200