ByteDance: Seedance 1.5 Pro
ByteDance Seedance 1.5 Pro generuje video společně se synchronizovaným dialogem, zvukovými efekty a hudbou. Režírujte mluvčí, emoce, kameru a zvukovou atmosféru pro krátká dramata, namluvené reklamy a scény postav.
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.5 Pro je model ByteDance Seed pro nativní společné generování zvuku a videa. Modeluje vizuální akci, řeč a rytmus společně a umožňuje scéně zahrnout výkon postavy, synchronizovaný dialog a navrženou zvukovou krajinu. Hlavní rozdíl oproti čistě vizuálnímu videozadání spočívá v tom, že zvuk se stává součástí popisu scény: kdo mluví, jak repliku podává a co publikum slyší kolem akce.
Společné audiovizuální generování
Dokumentovaný zvukový rozsah zahrnuje zvuky prostředí, akční efekty, syntetizované zvuky, nástroje, hudbu na pozadí a vokály. Model má propojit zvuk s děním na obrazovce: předmětem narážejícím do stolu, otevíranými dveřmi nebo mluvící postavou. Použijte jej pro krátký dramatický okamžik, namluvenou produktovou reklamu nebo scénu, jejíž nálada závisí na výkonu i zvuku.
Prompt začněte objektem a pohybem, potom přidejte prostředí, kameru, vizuální styl a zvuk. Stručná scéna může znít: „Kuchař zvedne pokličku z malého hrnce, usměje se a řekne: ‚To je hotové.‘ Unikne jemný obláček páry a poté zazní tiché cinknutí pokličky položené na pult.“ Mluvená replika a efekty tím získají viditelnou příčinu.
Dialog a komentář
Model podporuje monology a rozhovory více mluvčích s pohyby rtů přizpůsobenými postavám. Příručka dokumentuje mandarínštinu, čínské dialekty včetně kantonštiny a dialektů provincií Šen-si a S’-čchuan a mluvenou angličtinu, japonštinu, korejštinu, španělštinu a indonéštinu. Dokumentované jazyky zadání jsou čínština a angličtina; jazyk promptu a jazyk požadovaný pro mluvenou repliku jsou samostatné volby.
Každého mluvčího identifikujte jednotným viditelným rysem a repliky pište do uvozovek. Zahrňte pokyny přednesu, například klidný hlas, váhavou odpověď či rychlejší tempo, a střídání replik vyjádřete výslovně. U dvou mluvčích popište, kdo mluví první a čí reakci kamera ukazuje. Krátký rozhovor odpovídající zvolenému klipu dává modelu jasnější cíl výkonu než dlouhá pasáž s neurčenými mluvčími.
Komentář lze řídit barvou hlasu, emocemi, intonací a rychlostí řeči. Hodí se, když má hlas vysvětlovat produkt a kamera zůstává na produktu nebo když vypravěč vytváří náladu bez mluvčího v obraze. Příručka popisuje zachování rozpoznatelné barvy hlasu při změně přednesu; skutečné znění, výslovnost a výkon kontrolujte společně s obrazem.
Zvukové efekty a hudba na pozadí
Efekty popisujte jako události spojené s akcí: kroky při příchodu postavy, sílící déšť za oknem nebo pohyb látky při oblékání kabátu. Hudba na pozadí se ve výchozím nastavení generuje podle promptu. Pokud na nich záleží, určete náladu, styl a rytmus a uveďte, kdy má vůči scéně začít nebo zeslábnout.
U klidné ukázky požadujte zdrženlivou hudbu a zdůrazněte zvuky manipulace s produktem. U animované scény popište okamžik akce, který má souznít s hudebním rytmem. Generovaná zvuková stopa je monofonní. Dokumentované ovládání zvuku umožňuje také tiché video, pokud projekt potřebuje samostatně připravený soundtrack.
Přechody záběrů a vedení kamery
Model podporuje změny záběrů s konzistentním vizuálním zpracováním, protizáběry pro konverzaci a pokyny k časování přechodů. Užitečná dialogová sekvence může představit dva mluvčí v polocelku, střihnout na odpovídajícího a vrátit se k reakci prvního. Při změně záběru uveďte identitu každé osoby.
Příručka pokrývá nadhled, podhled a úroveň očí; pohled přes rameno a subjektivní pohled; i celky, polocelky a detaily. Pohyb kamery popište počáteční kompozicí, směrem, rozsahem a koncovou kompozicí. Například pomalý nájezd může skončit na výrazu mluvčího při dokončení repliky. Pohyb spojte s příběhem, místo výčtu několika kamerových technik bez účelu.
Režimy, výstup a náhled
Dokumentované vstupní režimy jsou text na video, obrázek prvního snímku na video a obrázky prvního i posledního snímku na video. Připravený první obrázek stanovuje počáteční kompozici; konečný obrázek může definovat zamýšlený koncový bod. Výstupní specifikace uvádějí MP4 při 24 fps, 480p, 720p nebo 1080p a nastavení délky 4–12 sekund. Model může také vybrat délku v celých sekundách v podporovaném rozsahu. Dokumentované poměry jsou 21:9, 16:9, 4:3, 1:1, 3:4 a 9:16 s podporou adaptivního rámování.
Výrobce dokumentuje dvoufázový postup Draft: náhled 480p pro kontrolu struktury scény, výběru záběrů, pohybu a záměru promptu, následovaný konečným generováním opětovně využívajícím tvůrčí vstupy. Jde o způsob posouzení plánovaného výkonu před volbou konečného rozlišení. Samotný náhled je omezen na 480p a nepodporuje vrácení posledního snímku. ID úkolu Draft výrobce zůstává platné sedm dní od vytvoření; konečné video z něj vygenerujte v tomto období.
U obrazově vedené práce připravte zdrojový obrázek pro zamýšlené rámování: změna výstupního poměru může obrázek oříznout. Opakovaný seed vytváří podobné, nikoli zaručeně totožné snímky a pokyn pevné kamery není dokonalou zárukou uzamčení. Především posuzujte dialogový klip jako jediný audiovizuální výkon: správný mluvčí, slyšitelná replika, reakce tváře i důraz kamery musí podporovat stejnou událost.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-1-5-pro
bytedance/seedance-1-5-proÚvod
ByteDance Seedance 1.5 Pro generuje video společně se synchronizovaným dialogem, zvukovými efekty a hudbou. Režírujte mluvčí, emoce, kameru a zvukovou atmosféru pro krátká dramata, namluvené reklamy a scény postav.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image- Výstup
video- Výstupní formát
- původní bajty MP4; bez normalizace a překódování
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity bytedance/seedance-1-5-pro | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Poleduration | Typinteger | PožadavekPovinné | Hodnoty a limity 4, 5, 6, 7, 8, 9, 10, 11, 12 Minimum: 1 Maximum: 600 | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 480p, 720p, 1080p | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity 1:1, 3:4, 9:16, 9:21, 4:3, 16:9, 21:9 | Výchozí— |
Polegenerate_audio | Typboolean | PožadavekVolitelné | Hodnoty a limity false, true Podmínky: Vynechání této volby zvolí cenu se zvukem. Nastavte ji na false, chcete-li cenu bez zvuku. V poli has_audio výsledku ověřte, zda byla vrácena zvuková stopa. | Výchozí— |
Poleframe_images | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 2 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame nebo last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image_url, frame_type Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images. | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity 480x480, 480x640, 480x854, 480x1120, 640x480, 720x720, 720x960, 720x1280, 720x1680, 854x480, 960x720, 1080x1080, 1080x1440, 1080x1920, 1080x2520, 1120x480, 1280x720, 1440x1080, 1680x720, 1920x1080, 2520x1080 Vzor: ^[1-9][0-9]*x[1-9][0-9]*$ | Výchozí— |
Poleseed | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Výchozí— |
Polecallback_url | Typstring | PožadavekVolitelné | Hodnoty a limity Vzor: ^https:// | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletrace | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Kombinace vstupních materiálů
Text na video · Textové zadání. · Povinné: model, prompt, duration
Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a poměr stran nebo přesnou uvedenou velikost.
model: Typ: string · bytedance/seedance-1-5-pro
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images
frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame s volitelným last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Vyberte podporované rozlišení a poměr stran nebo přesnou uvedenou velikost.
Přesné klíče: type, image_url, frame_type
model: Typ: string · bytedance/seedance-1-5-pro
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontraktfalse |
Parametroptional_controls | Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Životní cyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Podmínky účtování | Poplatek |
|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Podmínky účtování— | 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ů |
| KonfiguraceCena tokenu videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza 1K videotokenů | Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka. | Poplatek Výstup · Cena tokenu videa · Odhad pouze pro srovnání $0.0048 za 1K videotokenů Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek. |
| KonfiguraceCena tokenu videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza 1K videotokenů | Podmínky účtovánízvuk: without_audio | Poplatek Výstup · Cena tokenu videa · Odhad pouze pro srovnání $0.0024 za 1K videotokenů Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek. |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Podmínky účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.05184 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í →
Podrobnosti referenčního tarifu
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
Cenové reference konfigurací videa
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 | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceCena tokenu videa | Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka. | Poplatek Výstup · Cena tokenu videa $0.0048 za 1K videotokenů Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek. |
| KonfiguraceCena tokenu videa | Podmínky účtovánízvuk: without_audio | Poplatek Výstup · Cena tokenu videa $0.0024 za 1K videotokenů Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek. |
Příklady požadavků
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"bytedance/seedance-1-5-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Přijímání a ukládání výsledků
Ailoot Ultra · Video
podepsané URL obsahu spravovaného službou
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Ověřit stav úlohy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Další načtení obsahu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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ždý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.
Pokud je nutné ověřit původní odpověď
503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte
Pole odpovědi
| Pole | Typ | Význam |
|---|---|---|
Poleindex | Typinteger | VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný. |
Polesize_bytes | Typinteger | null | VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná. |
Poleduration_ms | Typinteger | null | VýznamNaměřená délka videa v milisekundách; null, není-li dostupná. |
Polewidth | Typinteger | null | VýznamŠířka videa v pixelech; null, není-li dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixelech; null, není-li dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, není-li zaznamenán. |
Polehas_audio | Typboolean | null | VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno. |
Poleaudio_codec | Typstring | null | VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán. |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď404 · not_found_error | PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno. | Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API. |
Odpověď401 · authentication_error | PodmínkaKlíč API neodpovídá ověřenému účtu. | Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu. |
Odpověď400 · invalid_request_error | PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný. | Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou. |
Odpověď422 · price_unavailable | PodmínkaVybranou konfiguraci videa nelze ocenit. | Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby. |
Odpověď422 · invalid_request_error | PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné. | Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API. |
Odpověď402 · billing_error | PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci. | Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity. |
Odpověď503 · server_error | PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné. | Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování. |
Odpověď503 · result_pending_check | PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat. | Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování. |
Odpověď503 · owned_result_unavailable | PodmínkaStávající video je dočasně nedostupné ke stažení. | Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci. |
Odpověď409 · video_not_ready | PodmínkaObsah videa nebyl zveřejněn. | Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování. |
Aliasy
Aliasy modelu
Ailoot Ultra bytedance/seedance-1-5-pro
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · ByteDance: Seedance 1.5 Pro
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·bytedance/seedance-1-5-pro:text,image→video- Jaká pole požadavek používá?
POST /v1/videos·bytedance/seedance-1-5-pro:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Jaké limity platí?
POST /v1/videos·bytedance/seedance-1-5-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807