ByteDance: Seedance 1.0 Pro Fast

Seedance 1.0 Pro Fast yra atskirai įvardytas Fast profilis vaizdo įrašams be garso generuoti iš teksto ar vaizdo. Jis priima scenos aprašą arba vaizdu grindžiamą kompoziciją; išvesties trukmė – 2–12 sekundžių, dažnis – 24 fps, o kadravimą nustato aiškūs valdikliai.

Ailoot Ultra · Vaizdo įrašai POST /v1/videos doubao-seedance-1-0-pro-fast-251015

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

Seedance 1.0 Pro Fast yra Fast profilis, kurio identifikatorius – doubao-seedance-1-0-pro-fast-251015. Jis generuoja vaizdo įrašą be garso iš rašytinės scenos ar vaizdu grindžiamos pradinės kompozicijos. Tikslus identifikatorius skiria šį profilį nuo Seedance 1.0 Pro; žodis Fast nenustato garantuoto atskiros užduoties užbaigimo laiko. Įvesties režimą rinkitės pagal tai, kas turi nustatyti sceną, o grąžintą klipą vertinkite pagal tą aprašą.

Tekstu grindžiamas planas prasideda nuo glaustos sekos: objekto ir aplinkos, veiksmo, kameros kelio ir galutinio vaizdo. Pristatydami gaminį aprašykite ant paviršiaus esantį objektą, šviesą ant jo medžiagos ir trumpą judesį, kuris baigiasi ties rodoma savybe. Kurdami vietovės idėją pereikite nuo plataus bendro plano prie atpažįstamo akcento. Neprašykite viename trumpame klipe atlikti kelių nesusijusių scenų, kurių visus objektus ir aplinkas tektų pristatyti nuo pradžių.

Vaizdu grindžiamas planas prasideda nuo image_url elemento content masyve ir tekstinio judėjimo nurodymo. Tame vaizde paruoškite iškarpą, foną ir objekto išdėstymą, tada nurodykite, kurie elementai juda ir kaip elgiasi kamera. Taip statiška kompozicija gali virsti trumpa animuota scena. Tai naudinga portretui, ant stalo esančiam objektui ar paruoštai vaizdinei idėjai, tačiau visame faktiškame rezultate vis tiek reikia patikrinti tapatybę, formą ir judėjimą.

Vaizdų įvestys gali naudoti pasiekiamą URL arba Base64 duomenų URL. Dokumentuoti formatai yra JPEG, PNG, WEBP, BMP, TIFF ir GIF; vaizdas turi būti mažesnis nei 30 MB, abu matmenys – griežtai tarp 300 ir 6000 pikselių, o pločio ir aukščio santykis – griežtai tarp 0.4 ir 2.5. Rinkitės aiškų pradinį vaizdą, kuriame matyti objekto detalės. Vaizdų vadove rekomenduojamas prisitaikantis kadravimas, todėl paruošto vaizdo proporcijos turėtų atitikti norimą animuoti kompoziciją.

1.0 profilyje dokumentuojama nuo dviejų iki dvylikos sekundžių trukmė 24 fps dažniu. Pro Fast numatytoji raiška yra 1080p, o išsaugotoje išvesties lentelėje nurodyti 480p, 720p ir 1080p lygiai. Operacijų vadove 1080p neleidžiama naudojant atskaitos vaizdą. Fiksuoti kraštinių santykiai apima 16:9, 4:3, 1:1, 3:4, 9:16 ir 21:9. Rinkitės pasirinktai įvesties rūšiai tinkamą raišką ir formatą, užuot manę, kad visi deriniai yra tarpusavyje pakeičiami.

Seed ir vandenženklio parinktys padeda aiškiai nustatyti užklausos nuostatas. Sveikojo skaičiaus seed intervalas – nuo -1 iki 2^32-1; -1 prašo atsitiktinumo. Fiksuotos kameros nurodymas priklauso nuo sąlygų: vadove jis neleidžiamas naudojant atskaitos vaizdą, o ten, kur palaikomas, vaizdinis poveikis negarantuojamas. Į tekstą įterptos parametrų komandos turi pirmenybę prieš atskirus neprivalomus parametrus. Suderinkite šiuos nurodymus, ypač taisydami užklausos tekstą, kurio scenos apraše kitaip galėtų likti sena trukmės ar raiškos komanda.

Naudojimas matuojamas vaizdo žetonais: išvesties plotis × išvesties aukštis × kadrų dažnis × išvesties trukmė / 1024. Užbaigta užduotis pateikia šį kiekį kaip usage.completion_tokens. Išsaugokite pateiktą naudojimą kartu su užbaigtu klipu ir užklausoje nurodytomis nuostatomis.

Pateikus užklausą sukuriama asinchroninė užduotis. Išsaugokite jos identifikatorių, sekite būseną ir sėkmingai užbaigus gaukite vaizdo įrašą iš content.video_url. Dokumentacijoje nurodyta, kad sugeneruoti failai saugomi septynias dienas, todėl išsaugokite užbaigtą rezultatą kartu su užklausos tekstu ir bet kuriuo įvesties vaizdu. Peržiūrėkite visą veiksmą, kameros judėjimą ir galutinį kadravimą; jei kuri detalė neatitinka aprašo, nurodykite tą konkretų pataisymą, išlaikydami pavykusias dalis.

Ailoot Ultra · Vaizdo įrašai POST /v1/videos doubao-seedance-1-0-pro-fast-251015

doubao-seedance-1-0-pro-fast-251015

ByteDance /doubao-seedance-1-0-pro-fast-251015

Pradžia

Leidžiamos įvestys: Tekstas · Vaizdai
Rezultatai: Vaizdo įrašai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdo įrašai POST /v1/videos

Įvestis: text, image
Išvestis: video

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos doubao-seedance-1-0-pro-fast-251015	Numatyta—
Laukas`content`	Tipas`array`	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—
Laukas`duration`	Tipas`integer`	ReikalavimasNeprivaloma	Reikšmės ir ribos Mažiausia reikšmė: 2 Didžiausia reikšmė: 12 Sąlygos: Pagrindinė 1.x schema: 2–12; vėlesniame bendrame apraše 1.5 nurodyta 4–12 arba -1. Pavyzdyje naudojama abiejuose šaltiniuose dokumentuota 5 reikšmė.	Numatyta5
Laukas`resolution`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Patvirtintos teksto pavertimo vaizdo įrašu reikšmės yra 480p ir 1080p. Naudojant pavyzdinį paveikslėlį 1080p negalimas. Bendroji 720p išvardijimo reikšmė prieštarauja konkretaus modelio aprašui, todėl 720p palaikymas abiem režimais lieka neišaiškintas.	Numatyta1080p
Laukas`ratio`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Sąlygos: Numatytosios reikšmės priklauso nuo scenos ir modelio; įvesties paveikslėlių dokumentacijoje rekomenduojama adaptive.	Numatyta—
Laukas`service_tier`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos default, flex Sąlygos: default=online, flex=offline; pasirinkite prieš kurdami.	Numatytadefault
Laukas`seed`	Tipas`integer`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausia reikšmė: −1 Didžiausia reikšmė: 4 294 967 295	Numatyta−1
Laukas`camerafixed`	Tipas`boolean`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Privalomas Ailoot; dokumentacijoje nurodyta, kad kameros valdymas naudojant pavyzdinį paveikslėlį nepalaikomas, o poveikis negarantuojamas.	Numatytafalse
Laukas`watermark`	Tipas`boolean`	ReikalavimasPrivaloma	Reikšmės ir ribos	Numatytafalse
Laukas`execution_expires_after`	Tipas`integer`	ReikalavimasPrivaloma	Reikšmės ir ribos Mažiausia reikšmė: 3 600 Didžiausia reikšmė: 259 200 Vienetas: sekundės	Numatyta172 800

Įvesties medžiagos deriniai

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijacamerafixed, content, execution_expires_after, model, seed, watermark
Parametras`optional`	Specifikacijaduration, resolution, ratio, service_tier
Parametras`material_types`	Specifikacijatext, image
Parametras`additional_properties`	Specifikacijatrue
Parametras`validation_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.
Parametras`image_constraints`	Specifikacija{"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}

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ūracijaUltra	Įkainių lentelė—	Numatomas kiekis—	Apskaitos vienetasuž 1K vaizdo įrašo tokenų	Mokestis Išvestis · Įvertis tik palyginimui $0.0012 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.0576 į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

curl · sukurkite vaizdo įrašącurl · peržiūrėkite pirminę užduotįcurl · atsisiųskite jums priklausantį vaizdo įrašą

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

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}/content
GET /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
Laukas`id`	Tipasstring
Laukas`provider_task_id`	Tipasstring
Laukas`polling_url`	Tipasstring
Laukas`status`	Tipasstring when supplied
Laukas`content.video_url`	Tipasstring\|string[]
Laukas`usage`	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-1-0-pro-fast-251015

Metodų kelių pseudonimai

/v1/videos/generations

Susiję ID iškvietimui

doubao-seedance-1-0-pro-fast-251015

FAQ · ByteDance: Seedance 1.0 Pro Fast

Kokios įvestys ir rezultatai prieinami?: POST /v1/videos · doubao-seedance-1-0-pro-fast-251015: text, image → video
Kokius laukus naudoja užklausa?: POST /v1/videos · doubao-seedance-1-0-pro-fast-251015: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
Kokie apribojimai taikomi?: 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

ByteDance: Seedance 1.0 Pro Fast