ByteDance: Seedance 1.0 Pro

A Seedance 1.0 Pro szövegből vagy nyitóképből generál néma videót. Írja le a cselekvést és a kamerát, vagy animáljon egy meglévő kompozíciót, 2–12 másodperces időtartammal, 24 fps képkockasebességgel, valamint a kimeneti képkivágás és felbontás kifejezett beállításaival.

Ailoot Ultra · Videó POST /v1/videos doubao-seedance-1-0-pro-250528

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A Seedance 1.0 Pro szövegből vagy kép által vezérelt jelenetből generál videót. A doubao-seedance-1-0-pro-250528 azonosító mindkét bemeneti módot támogatja, így a kiindulópont lehet írott elképzelés vagy meglévő vizuális kompozíció. Új jelenethez használjon szöveges leírást, vagy adjon meg képet, ha a témát, az elrendezést és a nyitóképet vizuálisan kell rögzíteni. Ez az 1.0 profil néma videót készít; a szinkronizált hang a külön ismertetett 1.5 Pro profilhoz tartozik.

Szövegből videó készítésekor egy összefüggő jelenetben határozza meg a témát, a környezetet, a mozgást, a képkivágást és a kamerát. A dokumentált példa fokozatosan halad egy százszorszépmezőtől egy olyan virág közelképéig, amelynek szirmain harmat látható. Ez a felépítés más fokozatos bemutatásokhoz is használható: mutassa be a környezetet, közelítsen a témához, majd a fontos részletnél zárjon. Termékkoncepcióhoz a cselekvés mellett az anyagot és a megvilágítást is írja le, és a rövid plánban megvalósítható útvonalat adjon a kamerának.

Képből videó készítésekor a referenciát a content egy image_url elemében helyezze el, és magyarázza el, minek kell változnia ehhez a kiinduló képhez képest. Egy előkészített portré meghatározhatja a személyt és a képkivágást, miközben a leírás kis fordulást, mozgó hajat vagy finom kameratávolítást kér. Egy álló termékkép rögzítheti a tárgyat és a hátteret, miközben az utasítás szabályozott bemutatást kér. A kért mozgás legyen összeegyeztethető a forráskompozícióval; egy tárgy egyik oldaláról készült kép nem ad pontos nézetet az összes többi, nem látható oldaláról.

A képmező elérhető URL-t vagy Base64 képadatokat tartalmazó adat-URL-t fogad el. A dokumentált formátumok JPEG, PNG, WEBP, BMP, TIFF és GIF. A képeknek 30 MB-nál kisebbnek kell lenniük; a szélesség és magasság arányának szigorúan 0.4 és 2.5 közé, mindkét méretnek pedig szigorúan 300 és 6000 pixel közé kell esnie. A kívánt képkivágású, tiszta forrásképet készítse elő, ne támaszkodjon olyan bélyegképre, amelyből már hiányoznak a meghatározó részletek. Képből videó generálásához az útmutató adaptive (adaptív) képkivágást ajánl a referencia arányainak követésére.

Az 1.0 dokumentált időtartama kettőtől tizenkét másodpercig terjed, a képkockasebesség pedig 24 fps. A kimeneti beállítások 480p, 720p és 1080p szinteket tartalmaznak, a Pro alapértéke az 1080p; az útmutató referenciakép esetén kizárja az 1080p-t. A rögzített képarányok között szerepel a 16:9, 4:3, 1:1, 3:4, 9:16 és 21:9. Kép által vezérelt plánhoz képbemenettel kompatibilis kombinációt válasszon, ne vigye át változatlanul a szövegből videó készítés összes beállítását. Mielőtt elhelyezi a klipet egy elrendezésben, ellenőrizze a ténylegesen visszaadott képkivágást.

A seed és watermark vezérlők a camerafixed mellett szerepelnek a dokumentációban. A rögzített kamerára vonatkozó utasítás referenciakép esetén nem támogatott, ahol pedig alkalmazható, az útmutató nem garantál tökéletesen mozdulatlan kamerát. Az utasításba ágyazott paraméterbeállítások elsőbbséget élveznek a külön opcionális mezőkkel szemben. Az időtartamnak, felbontásnak és képaránynak egyetlen mérvadó beállítását tartsa meg, és ehhez igazítsa a kamera leírását. Így a jelenetleírás nem bírálja felül észrevétlenül a kéréshez kiválasztott beállításokat.

A használatot videótokenekben mérik: kimeneti szélesség × kimeneti magasság × képkockasebesség × kimeneti időtartam / 1024. Az elkészült feladat ezt a mennyiséget usage.completion_tokens értékként jelenti. A jelentett használatot őrizze meg az elkészült klippel és a kért beállításaival együtt.

A munkafolyamat először feladatazonosítót, a feldolgozás után pedig az elkészült videó helyét adja vissza. Őrizze meg az azonosítót, miközben ellenőrzi a queued vagy running állapotot; a succeeded állapotú feladat content.video_url értéket és használati információkat ad. A generált fájlok dokumentált megőrzési ideje hét nap. Az elkészült klipet, a forrásképet és a pontos utasítást mentse el a módosítások nyilvántartásaként, majd a teljes eredményen ellenőrizze a téma megjelenését, a mozgást, a képi folytonosságot és a zárókompozíciót.

Ailoot Ultra · Videó POST /v1/videos doubao-seedance-1-0-pro-250528

doubao-seedance-1-0-pro-250528

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

Kezdő lépések

Elfogadott bemenetek: Szöveg · Képek
Eredmények: Videó

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Videó POST /v1/videos

Bemenet: text, image
Kimenet: video

Mező	Típus	Követelmény	Értékek és korlátok	Alapértelmezett
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok doubao-seedance-1-0-pro-250528	Alapértelmezett—
Mező`content`	Típus`array`	KövetelményKötelező	Értékek és korlátok Feltételek: Natív szöveg- és médiaobjektumok; a külső tömb nem lehet üres. Ez az általános Ailoot-konstruktor nem ellenőrzi a beágyazott csomópontok típusát.	Alapértelmezett—
Mező`duration`	Típus`integer`	KövetelményOpcionális	Értékek és korlátok Minimum: 2 Maximum: 12 Feltételek: Az elsődleges 1.x séma 2–12 értéket ad meg; a későbbi közös leírás az 1.5 esetén 4–12 vagy -1 értéket nevez meg. A példa a mindkettőben dokumentált 5 értéket használja.	Alapértelmezett5
Mező`resolution`	Típus`string`	KövetelményOpcionális	Értékek és korlátok Feltételek: A megerősített szövegből videó módhoz tartozó értékek 480p és 1080p. Referenciakép megadásakor az 1080p kizárt. A közös 720p felsorolási érték ellentmond a modellspecifikus leírásnak, ezért a 720p támogatása mindkét módban tisztázatlan.	Alapértelmezett1080p
Mező`ratio`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Feltételek: Jelenettől és modelltől függő alapértelmezések; a képbemenet dokumentációja az adaptive értéket ajánlja.	Alapértelmezett—
Mező`service_tier`	Típus`string`	KövetelményOpcionális	Értékek és korlátok default, flex Feltételek: default=online, flex=offline; a létrehozás előtt válasszon.	Alapértelmezettdefault
Mező`seed`	Típus`integer`	KövetelményKötelező	Értékek és korlátok Minimum: -1 Maximum: 4 294 967 295	Alapértelmezett-1
Mező`camerafixed`	Típus`boolean`	KövetelményKötelező	Értékek és korlátok Feltételek: Az Ailoot megköveteli; a dokumentáció szerint referenciakép esetén a kameravezérlés nem támogatott, és hatása nem garantált.	Alapértelmezettfalse
Mező`watermark`	Típus`boolean`	KövetelményKötelező	Értékek és korlátok	Alapértelmezettfalse
Mező`execution_expires_after`	Típus`integer`	KövetelményKötelező	Értékek és korlátok Minimum: 3600 Maximum: 259 200 Egység: másodperc	Alapértelmezett172 800

Bemeneti anyagok kombinációi

Metódus paraméterei és életciklusa

Paraméter	Szerződés
Paraméter`content_type`	Szerződésapplication/json
Paraméter`required`	Szerződéscamerafixed, content, execution_expires_after, model, seed, watermark
Paraméter`optional`	Szerződésduration, resolution, ratio, service_tier
Paraméter`material_types`	Szerződéstext, image
Paraméter`additional_properties`	Szerződéstrue
Paraméter`validation_scope`	SzerződésAz Ailoot ellenőrzi a kötelező mezők típusát és a nem üres model/content tömböt. A többi kérésmezőt megőrzi a kiválasztott modell számára.
Paraméter`image_constraints`	Szerződés{"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}

Metódus álnevei: /v1/videos/generations

Életciklus: 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

Hozza létre egyszer, és őrizze meg a visszaadott nyilvános id/polling_url értékeket.

Kérdezze le az eredeti feladatot; succeeded után töltse le a tényleges saját content.video_url tartalmát.

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód: Nincs megadva Ha a gyors mód van kiválasztva
Flex mód: Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás: Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

Beállítás	Díjtáblázat	Előre jelzett mennyiség	Elszámolási egység	Díj
BeállításTokenek alapdíjai	DíjtáblázatAlapdíj	Előre jelzett mennyiség—	Elszámolási egység—	Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
BeállításUltra	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási egység1K videótokenenként	Díj Kimenet · Becslés, csak összehasonlításra $0.0044 1K videótokenenként
BeállításA generálás becsült költsége	Díjtáblázat—	Előre jelzett mennyiségbecslés egy generálásra	Elszámolási egység—	Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.2112 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Videó

curl · hozz létre videótcurl · olvasd be az eredeti feladatotcurl · töltsd le a tulajdonodban lévő videót

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

Eredmények fogadása és mentése

Ailoot Ultra · Videó

Natív JSON nyilvános id/polling_url értékekkel. Közzététel után a content.video_url az Ailoot tulajdonában lévő aláírt URL-címeket tartalmazza; közzététel előtt a kiválasztott kimeneti URL-címek üresek.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.

Őrizze meg a content.video_url mező összes tényleges URL-címét; az index egy valós visszaadott kimenetet azonosítson.

Ha az eredeti választ ellenőrizni kell

Őrizze meg az eredeti választ, fejléceket és id értéket, és azt a műveletet kérdezze le; ismeretlen kimenetelű létrehozást soha ne küldjön be újra.

Válaszmezők

Mező	Típus
Mező`id`	Típusstring
Mező`provider_task_id`	Típusstring
Mező`polling_url`	Típusstring
Mező`status`	Típusstring when supplied
Mező`content.video_url`	Típusstring\|string[]
Mező`usage`	Típusobject when supplied

Hibák és következő lépések

Válasz	Feltétel	Következő lépés
Válasz400 · `invalid_request_error`	FeltételÉrvénytelen JSON/modell, kötelező mezőtípusok vagy tartalomindex.	Következő lépés
Válasz401 · `authentication_error`	FeltételÉrvénytelen Ailoot API-kulcs.	Következő lépés
Válasz404 · `not_found_error`	FeltételA feladat/kimenet hiányzik, vagy nem ugyanahhoz a felhasználóhoz/API-kulcshoz/csoporthoz tartozik.	Következő lépés
Válasz502 · `result_pending_check`	FeltételAz eredeti beküldés/állapot hiányos; őrizze meg az eredeti azonosítót, ne küldje be újra.	Következő lépés
Válasz503 · `result_pending_check`	FeltételAz eredeti média, útvonal vagy elszámolás ellenőrzés alatt áll; folytassa az eredeti műveletet.	Következő lépés

Álnevek

Modell álnevei

Ailoot Ultra doubao-seedance-1-0-pro-250528

Metódusútvonalak álnevei

/v1/videos/generations

Kapcsolódó modellazonosítók

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

Milyen bemenetek és eredmények érhetők el?: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
Mely mezőket használja a kérés?: POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
Milyen korlátok érvényesek?: 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