ByteDance: Seedance 2.0 Fast
Seedance 2.0 Fast yra Fast multimodalinis profilis vaizdo įrašams generuoti, redaguoti ir pratęsti. Jis priima tekstą, vaizdų, vaizdo ir garso atskaitos medžiagą, palaiko išvestį su sinchronizuotu garsu arba be jo ir dokumentuoja 4–15 sekundžių klipus 480p arba 720p raiška.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Seedance 2.0 Fast yra atskirai įvardytas Fast profilis, pasirenkamas pagal doubao-seedance-2-0-fast-260128. Jis palaiko vaizdo generavimą, redagavimą ir pratęsimą, naudodamas tekstą, vaizdus, vaizdo ir garso atskaitos įrašus. Profilis naudingas, kai scenos aprašui reikia daugiau nei išvaizdos apibūdinimo: esama medija taip pat gali perteikti atlikimą, kameros kalbą ir garsą. Fast pavadinimas skiria užklausos tapatybę; jis nežada, kad atskira asinchroninė užduotis bus užbaigta per nustatytą laiką.
Pradėkite nuo elemento, kuris turi nustatyti naują planą. Vien teksto pakanka naujai scenai aprašyti. Vaizdas gali nustatyti veikėją, gaminį ar kompoziciją; vaizdo įrašas gali pateikti judėjimą ar esamą seką, kurią reikia redaguoti arba tęsti. Dokumentuoti turinio deriniai apima vaizdus su garsu, vaizdo įrašą su garsu bei vaizdus, vaizdo įrašą ir garsą kartu; tekstas prie vaizdinės medžiagos yra neprivalomas. Šiuose deriniuose neaprašoma atskira vien garso užklausa, todėl garso atskaitos įrašus susiekite su vaizdiniu šaltiniu, kurį jie turi valdyti.
Masyve content ir apraše aiškiai nurodykite atskaitos medžiagos vaidmenis. image_url, video_url ir audio_url elementams galima priskirti reference_image, reference_video ir reference_audio vaidmenis. Aprašykite, kuris vaizdas pateikia objektą, kuris vaizdo įrašas pateikia kamerą ar veiksmą ir kuris garso įrašas pateikia garso takelį. Gaminio plane vaizdas gali nustatyti pakuotę, o vaizdo įrašas – parodyti judėjimą pro objektą. Nurodykite norimą pabaigą, kad trumpa seka turėtų naudingą baigiamąjį vaizdą, o ne nutrūktų veiksmo viduryje.
Redaguodami nurodykite pradinę filmuotą medžiagą, pakeitimą ir išlaikytiną tęstinumą. Keičiant foną ar apšvietimą norimas objektas ir veiksmas turi likti aiškiai apibrėžti. Pratęsdami paaiškinkite, kas vyksta toliau ir kaip naujas judėjimas siejasi su esama scena. Atskaitos medžiaga valdo generavimą; patikrinkite tikrą jungtį ir visą klipą pagal išvaizdą, judėjimo kryptį ir laiką, užuot manę, kad pratęsimas išlaiko kiekvieną atskiro kadro detalę.
Dokumentuotas 2.0 Fast intervalas – nuo keturių iki penkiolikos sveikų sekundžių; -1 leidžia modeliui pasirinkti trukmę tame intervale. Numatytoji trukmė – penkios sekundės. Išvesties raiška – 480p arba 720p; numatytoji – 720p, o 1080p neleidžiama. Rinkitės fiksuotą 16:9, 4:3, 1:1, 3:4, 9:16 ar 21:9 formatą arba prisitaikantį kadravimą. Prisitaikantis kadravimas seka atitinkamą užklausos teksto ar atskaitos medžiagos kontekstą; pagal pirmąjį kadrą kuriamas planas seka pradinį vaizdą, o multimodalinis kadravimas gali teikti vaizdo įrašui pirmenybę prieš vaizdus. Tikrą trukmę ir santykį perskaitykite grąžintuose užduoties laukuose.
Naudokite generate_audio, kad pasirinktumėte, ar generuojamas vaizdo įrašas turi sinchronizuotą garsą. Dokumentuota numatytoji reikšmė – true; false prašo tylos. Įjungus garsą profilis generuoja balsus, efektus ar foninę muziką pagal užklausos tekstą ir vaizdinį turinį, o vadove dialogą rekomenduojama rašyti dvigubose kabutėse. Nurodykite kalbėtoją ir norimą garso bei veiksmo ryšį. Kalbą peržiūrėkite su laisvai tą kalbą mokančiu klausytoju ir patikrinkite garso suderinimą visame klipe, įskaitant redaguotą ar pratęstą segmentą.
2.0 Fast vadove neleidžiami senesni frames ir camera_fixed valdikliai, taip pat nepalaikomas flex offline apdorojimas. Kameros elgesį aprašykite scenoje, o klipo trukmei naudokite duration. Seed ir vandenženklio parinktys išlieka dokumentuotos. Tas pats seed negarantuoja identiškos išvesties, todėl lygindami versijas išsaugokite užbaigtą rezultatą, užuot pasikliovę vien užklausos nuostatomis.
Vaizdo žetonų naudojimas apskaičiuojamas taip: (įvesties vaizdo įrašo trukmė + išvesties vaizdo įrašo trukmė) × išvesties plotis × išvesties aukštis × išvesties kadrų dažnis / 1024. Užklausos su įvesties vaizdo įrašu ir užklausos be jo turi atskiras apmokestinimo kategorijas. Užduoties užklausa pateikia usage.completion_tokens ir usage.total_tokens; išsaugokite šiuos pateiktus kiekius kartu su užbaigtu klipu.
Pateikus užklausą grąžinamas užduoties identifikatorius, kol užbaigtas vaizdo įrašas dar nepasiekiamas. Sekite apdorojimo būseną, tada sėkmingai užbaigus gaukite content.video_url ir kartu su rezultatu išsaugokite pateiktą trukmę, raišką, santykį, kadrų dažnį bei naudojimą. Galiojimo intervalas skaičiuojamas nuo užduoties sukūrimo, jo numatytoji reikšmė – 172 800 sekundžių, o intervalas – nuo 3 600 iki 259 200 sekundžių. Išsaugokite galutinį klipą su atskaitos medžiaga ir užklausos tekstu, tada visoje sekoje patikrinkite objekto tapatybę, kontaktą su objektais, kameros tęstinumą ir garso laiką.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-fast-260128
doubao-seedance-2-0-fast-260128Pradžia
Seedance 2.0 Fast yra Fast multimodalinis profilis vaizdo įrašams generuoti, redaguoti ir pratęsti. Jis priima tekstą, vaizdų, vaizdo ir garso atskaitos medžiagą, palaiko išvestį su sinchronizuotu garsu arba be jo ir dokumentuoja 4–15 sekundžių klipus 480p arba 720p raiška.
- Leidžiamos įvestys
- Tekstas · Vaizdai · Vaizdo įrašai · Garsas
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image,video,audio- Išvestis
video
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos doubao-seedance-2-0-fast-260128 | Numatyta— |
Laukascontent | Tipasarray | ReikalavimasPrivaloma | Reikšmės ir ribos Sąlygos: Pirminio formato teksto ir medijos objektai; išorinis masyvas turi būti netuščias. Šis bendras Ailoot konstruktorius netikrina įdėtų mazgų tipų. | Numatyta— |
Laukasgenerate_audio | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Į vaizdo įrašą įterptas sinchronizuotas garsas. | Numatytatrue |
Laukasduration | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Sveikasis skaičius 4–15 arba -1; grąžinama tikroji išvesties trukmė. | Numatyta5 |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480p, 720p Sąlygos: Aiškiai nurodyta, kad 1080p nepalaikoma 2.0/fast. | Numatyta720p |
Laukasratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Sąlygos: Prisitaikantis režimas aiškiai priskirtas 2.0/fast/1.5; 2.5 pavyzdyje pateiktas tik 16:9. | Numatytaadaptive |
Laukaswatermark | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatytafalse |
Laukasseed | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: −1 Didžiausia reikšmė: 4 294 967 295 | Numatyta−1 |
Laukasexecution_expires_after | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: 3 600 Didžiausia reikšmė: 259 200 Vienetas: sekundės | Numatyta172 800 |
Laukasservice_tier | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos default Sąlygos: 2.0/fast neleidžia neprisijungus vykdomo flex režimo; 2.5 taikymo sritis nenustatyta. | Numatytadefault |
Laukassafety_identifier | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastools | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos Sąlygos: Tik 2.0/fast; dokumentacijoje nurodyta type=web_search. | Numatyta— |
Įvesties medžiagos deriniai
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijacontent, model |
Parametrasoptional | Specifikacijagenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier, tools |
Parametrasmaterial_types | Specifikacijatext, image, video, audio |
Parametrasadditional_properties | Specifikacijatrue |
Parametrasvalidation_scope | SpecifikacijaAiloot tikrina privalomų laukų tipus, ar model eilutė netuščia ir ar content masyvas netuščias. Kiti užklausos laukai išsaugomi pasirinktam modeliui. |
Parametrasmaterial_combinations | Specifikacijatext, image, video, image, audio, image, video, video, audio, image, video, audio |
Parametrasoptional_text_with_media | Specifikacijatrue |
Parametrasreference_media_count_and_size_limits | Specifikacijanull |
Metodo pseudonimai: /v1/videos/generations
Gyvavimo ciklas: 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
Sukurkite vieną kartą ir išsaugokite grąžintus viešuosius id/polling_url.
Periodiškai tikrinkite pradinę užduotį; gavę succeeded, atsisiųskite tikrą jums priklausantį content.video_url.
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Apskaitos vienetas | Mokestis |
|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Apskaitos vienetas— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaĮvestyje yra vaizdo įrašas. | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž 1K vaizdo įrašo tokenų | Mokestis Išvestis · Įvertis tik palyginimui $0.007536 už 1K vaizdo įrašo tokenų |
| KonfigūracijaĮvestyje nėra vaizdo įrašų. | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž 1K vaizdo įrašo tokenų | Mokestis Išvestis · Įvertis tik palyginimui $0.013032 už 1K vaizdo įrašo tokenų |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Apskaitos vienetas— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.822402 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-2-0-fast-260128","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}]}
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
Pirminis JSON su viešais id/polling_url. Po paskelbimo content.video_url turi Ailoot priklausančius pasirašytus URL; prieš paskelbimą pasirinktų rezultatų URL ištuštinami.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną tikrą URL lauke content.video_url; index turi nurodyti tikrą grąžintą rezultatą.
Jei reikia patikrinti pradinį atsakymą
Išsaugokite pradinį atsakymą, antraštes ir id bei periodiškai tikrinkite tą operaciją; niekada neteikite kūrimo užklausos dar kartą, kai jos baigtis nežinoma.
Atsakymo laukai
| Laukas | Tipas |
|---|---|
Laukasid | Tipasstring |
Laukasprovider_task_id | Tipasstring |
Laukaspolling_url | Tipasstring |
Laukasstatus | Tipasstring when supplied |
Laukascontent.video_url | Tipasstring|string[] |
Laukasusage | Tipasobject when supplied |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas400 · invalid_request_error | SąlygaNetinkamas JSON/model, privalomų laukų tipai arba turinio indeksas. | Kitas žingsnis |
Atsakymas401 · authentication_error | SąlygaNegaliojantis Ailoot API raktas. | Kitas žingsnis |
Atsakymas404 · not_found_error | SąlygaUžduoties ar rezultato nėra arba jie nepriklauso tam pačiam naudotojui, API raktui ir grupei. | Kitas žingsnis |
Atsakymas502 · result_pending_check | SąlygaPradinio pateikimo ar būsenos duomenys neišsamūs; išsaugokite pradinį ID, neteikite pakartotinai. | Kitas žingsnis |
Atsakymas503 · result_pending_check | SąlygaPradinė medija, maršrutas arba atsiskaitymas tikrinami; tęskite pradinę operaciją. | Kitas žingsnis |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra doubao-seedance-2-0-fast-260128
Metodų kelių pseudonimai
/v1/videos/generations
Susiję ID iškvietimui
FAQ · ByteDance: Seedance 2.0 Fast
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·doubao-seedance-2-0-fast-260128:text,image,video,audio→video- Kokius laukus naudoja užklausa?
POST /v1/videos·doubao-seedance-2-0-fast-260128:model,content,generate_audio,duration,resolution,ratio,watermark,seed,execution_expires_after,service_tier,safety_identifier,tools- Kokie apribojimai taikomi?
POST /v1/videos·doubao-seedance-2-0-fast-260128:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200