ByteDance: Seedance 1.0 Pro

Seedance 1.0 Pro generuoja vaizdo įrašą be garso iš teksto arba pradinio vaizdo. Aprašykite veiksmą ir kamerą arba animuokite esamą kompoziciją; galimos 2–12 sekundžių trukmės, 24 fps dažnis ir aiškūs išvesties kadravimo bei raiškos valdikliai.

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

Apie modelį

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

Seedance 1.0 Pro generuoja vaizdo įrašą iš teksto arba pagal vaizdą kuriamos scenos. Identifikatorius doubao-seedance-1-0-pro-250528 palaiko abu įvesties režimus, todėl pradinis pagrindas gali būti rašytinė idėja arba esama vaizdinė kompozicija. Naują sceną kurkite pagal tekstinį aprašą, o vaizdą pateikite tada, kai objektą, išdėstymą ir pradinį vaizdą reikia nustatyti vizualiai. Šis 1.0 profilis kuria vaizdo įrašą be garso; sinchronizuotas garsas priklauso atskirai aprašytam 1.5 Pro profiliui.

Generuodami vaizdo įrašą iš teksto, vienoje nuoseklioje scenoje nurodykite objektą, aplinką, judėjimą, kadravimą ir kamerą. Dokumentuotame pavyzdyje palaipsniui pereinama nuo ramunių lauko prie stambaus žiedo su rasa ant vainiklapių plano. Tokia struktūra tinka ir kitiems atskleidimams: parodykite aplinką, artėkite prie objekto ir užbaikite svarbia detale. Gaminio idėjai aprašykite ne tik veiksmą, bet ir medžiagą bei apšvietimą, o kamerai nurodykite per trumpą planą įveikiamą kelią.

Generuodami vaizdo įrašą iš vaizdo, pateikite atskaitos pavyzdį image_url tipo content elemente ir paaiškinkite, kas turi pasikeisti nuo pradinio vaizdo. Paruoštas portretas gali nustatyti asmenį ir iškarpą, o apraše galima nurodyti nedidelį pasisukimą, judančius plaukus ar švelnų kameros atsitraukimą. Statiškas gaminio vaizdas gali nustatyti objektą ir foną, o užklausos tekstas – paprašyti valdomo atskleidimo. Prašomas judėjimas turi derėti su pradine kompozicija; vienos objekto pusės vaizdas neparodo, kaip tiksliai atrodo kitos, jame nematomos objekto pusės.

Vaizdo laukas priima pasiekiamą URL arba duomenų URL su Base64 vaizdo duomenimis. Dokumentuoti formatai yra JPEG, PNG, WEBP, BMP, TIFF ir GIF. Vaizdai turi būti mažesni nei 30 MB, pločio ir aukščio santykis – griežtai tarp 0.4 ir 2.5, o kiekvienas matmuo – griežtai tarp 300 ir 6000 pikselių. Paruoškite aiškų pradinį vaizdą su norima iškarpa, užuot pasikliovę miniatiūra, kurioje jau nebėra išskirtinių detalių. Generuojant vaizdo įrašą iš vaizdo, vadove rekomenduojamas prie atskaitos pavyzdžio proporcijų prisitaikantis kadravimas.

Dokumentuota 1.0 trukmė – nuo dviejų iki dvylikos sekundžių, kadrų dažnis – 24 fps. Išvesties valdikliai apima 480p, 720p ir 1080p lygius; Pro numatytoji raiška – 1080p, tačiau vadove 1080p neleidžiama naudojant atskaitos vaizdą. Fiksuoti formatai apima 16:9, 4:3, 1:1, 3:4, 9:16 ir 21:9. Vaizdu grindžiamam planui rinkitės su vaizdais suderinamą derinį, užuot nepakeitę perkėlę visas vaizdo generavimo iš teksto nuostatas. Prieš dėdami klipą į maketą patikrinkite faktiškai grąžintą kadravimą.

Seed ir vandenženklio valdikliai dokumentuojami kartu su camerafixed. Fiksuotos kameros nurodymas nepalaikomas naudojant atskaitos vaizdą, o ten, kur jis taikomas, vadovas negarantuoja visiškai nejudančios kameros. Į užklausos tekstą įterpti parametrų nurodymai turi pirmenybę prieš atskirus neprivalomus laukus. Išlaikykite vieną pagrindinę trukmės, raiškos ir santykio nuostatą, o kameros aprašą suderinkite su ja. Taip išvengiama scenos aprašo, nepastebimai pakeičiančio užklausai parinktas nuostatas.

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.

Darbo eiga pirmiausia grąžina užduoties identifikatorių, o po apdorojimo – užbaigto vaizdo įrašo vietą. Išsaugokite identifikatorių tikrindami, ar užduotis laukia eilėje arba vykdoma; sėkmingai užbaigta užduotis pateikia content.video_url ir naudojimo informaciją. Dokumentuotas sugeneruotų failų saugojimas – septynios dienos. Išsaugokite užbaigtą klipą, pradinį vaizdą ir tikslų užklausos tekstą kaip versijos įrašą, tada visame rezultate patikrinkite objekto išvaizdą, judėjimą, vaizdo tęstinumą ir baigiamąją kompoziciją.

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

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

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-250528	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.0044 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.2112 į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-250528","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-250528

Metodų kelių pseudonimai

/v1/videos/generations

Susiję ID iškvietimui

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

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