ByteDance: Seedance 1.5 Pro
A Seedance 1.5 Pro szövegből vagy képből generál videót, és szinkronizált beszédhangokat, effekteket, illetve háttérzenét is létrehozhat. A hang be- vagy kikapcsolható; a dokumentált profil 4–12 másodperces jeleneteket, adaptive (adaptív) képkivágást és online vagy flex feldolgozást kínál.
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.5 Pro szövegből vagy képből generál videót, és a képpel együtt hangot is létrehozhat. A konkrét kiválasztási azonosító a doubao-seedance-1-5-pro-251215. Hangvezérlője megkülönbözteti a néma Seedance 1.0 profiloktól: a generate_audio=true szinkronizált hangot kér, míg a false néma videót. Új elképzeléshez írott jelenetet használjon, vagy képpel határozza meg a nyitóképen szereplő témát és kompozíciót.
A vizuális cselekvést és a hangot ugyanannak a jelenetnek a részeiként írja le. Határozza meg a témát, a környezetet, a mozgást és a kamerát, majd magyarázza el a tervezett beszédhangokat, hangeffekteket vagy háttérzenét. Egy portréjelenetben egy személy kinyithatja a szemét, miközben a kamera lassan távolodik, és szél fúj a környezetben. Termékjelenetnél a hangot a látható eseményhez kapcsolja, például egy fedél kinyílásához vagy egy tárgy felülettel való érintkezéséhez, ne egymástól független effektek listáját adja hozzá.
A modell az utasításból és a vizuális tartalomból beszédhangokat, effekteket és háttérzenét generálhat. Az útmutató a kimondott párbeszédet dupla idézőjelbe javasolja tenni. A beszéd legyen elég rövid a kért cselekvéshez és szünetekhez, több szereplő esetén pedig különítse el, ki beszél. Ellenőrizze a tényleges szöveget, a beszédhangok szereplőkhöz rendelését és a képpel való szinkront. A hangra vonatkozó utasítás a generált előadást irányítja; nem külön feltöltött hangreferencia-bemenet e profil dokumentált kérésében.
A képből videó készítése image_url elemet használ a szöveg mellett. Adjon meg elérhető kép-URL-t vagy Base64 adat-URL-t JPEG, PNG, WEBP, BMP, TIFF vagy GIF formátumban. A dokumentált képkorlátok: 30 MB-nál kisebb méret, mindkét képméret szigorúan 300 és 6000 pixel között, a szélesség és magasság aránya pedig szigorúan 0.4 és 2.5 között. Világosan készítse elő a tervezett képkivágást és témát, majd ebből a kompozícióból kiindulva írja le a mozgást. A képes példa adaptive (adaptív) képarányt használ a referencia követésére.
A profilspecifikus időtartam-útmutató négytől tizenkét egész másodpercig terjedő értékeket sorol fel, vagy -1-et, amellyel a modell e tartományon belül választ időtartamot. Az alapértelmezett időtartam öt másodperc. A Seedance 1.5 Pro alapértéke a 720p, a megőrzött profiltáblázat pedig 480p és 720p felbontást dokumentál; a külön műveleti útmutató nem kínál 1080p-t az 1.5 Pro számára. 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, az 1.5 dokumentált alapértéke pedig az adaptive. A tényleges klip időtartamát és arányait ellenőrizze, ne kezelje a kért értékeket már visszaadott eredményként.
A kérés két feldolgozási szintet biztosít. A service_tier=default online feldolgozást választ, míg a flex offline feldolgozást a hosszabb késleltetést elviselő munkákhoz. A szint a feladat beküldése után nem módosítható. A munkafolyamat időzítési igényeihez válassza ki, és a választást őrizze meg a kérés nyilvántartásában. A hangmód és a feldolgozási szint külön választás: a néma klip nem automatikusan offline feladat, a hang bekapcsolása pedig nem választ feldolgozási szintet.
A seed, watermark és kamerautasítások legyenek összhangban a jelenettel. A szövegbe ágyazott paraméterparancsok elsőbbséget élveznek a külön opcionális paraméterekkel szemben. A rögzített kamera vezérlője referenciakép esetén kizárt, ahol pedig alkalmazható, ott sem garantálja a kép teljes rögzítettségét. Kép által vezérelt animációnál közvetlenül írja le a tervezett mozgást, ne feltételezze, hogy egy kameravezérlő feleslegessé teszi a plán leírását.
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 bekapcsolt vagy kikapcsolt hang, valamint az online vagy flex feldolgozás külön kategóriák maradnak a használatalapú díjazásban.
A beküldés aszinkron feladatazonosítót ad vissza. Kövesse a feladatot a befejezésig, majd mentse el a content.video_url helyen megadott videót. A generált fájlok dokumentált megőrzési ideje hét nap. A lejárati beállítást a létrehozástól számítják, alapértéke 172800 másodperc, és 3600 és 259200 másodperc közötti értékeket fogad el; a befejezetlen feladat a beállított időköz után expired állapotba kerül. A végső klipet, az eredeti képet és a pontos vizuális és hangutasításokat együtt őrizze meg, majd a teljes eredményen ellenőrizze a cselekvést, az azonosságot, a kameramozgás folytonosságát és a hang illeszkedését.
Ailoot Ultra · Videó POST /v1/videos doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215
doubao-seedance-1-5-pro-251215Kezdő lépések
A Seedance 1.5 Pro szövegből vagy képből generál videót, és szinkronizált beszédhangokat, effekteket, illetve háttérzenét is létrehozhat. A hang be- vagy kikapcsolható; a dokumentált profil 4–12 másodperces jeleneteket, adaptive (adaptív) képkivágást és online vagy flex feldolgozást kínál.
- 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ípusstring | KövetelményKötelező | Értékek és korlátok doubao-seedance-1-5-pro-251215 | Alapértelmezett— |
Mezőcontent | Típusarray | 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ípusinteger | KövetelményOpcionális | Értékek és korlátok 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ípusstring | KövetelményOpcionális | Értékek és korlátok 480p, 720p Feltételek: A Seedance 1.5 Pro a 480p és 720p felbontást támogatja; az 1080p kizárt. A dokumentált alapértelmezett felbontás 720p. | Alapértelmezett720p |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Feltételek: A Seedance 1.5 Pro dokumentált alapértelmezett képaránya adaptive. A rögzített képarányválaszték változatlan. | Alapértelmezettadaptive |
Mezőservice_tier | Típusstring | 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ípusinteger | KövetelményKötelező | Értékek és korlátok Minimum: -1 Maximum: 4 294 967 295 | Alapértelmezett-1 |
Mezőcamerafixed | Típusboolean | 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ípusboolean | KövetelményKötelező | Értékek és korlátok | Alapértelmezettfalse |
Mezőexecution_expires_after | Típusinteger | KövetelményKötelező | Értékek és korlátok Minimum: 3600 Maximum: 259 200 Egység: másodperc | Alapértelmezett172 800 |
Mezőgenerate_audio | Típusboolean | KövetelményOpcionális | Értékek és korlátok Feltételek: Kizárólag 1.5 esetén: a generált videóba ágyazott szinkronizált hang. | Alapértelmezetttrue |
Bemeneti anyagok kombinációi
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződéscamerafixed, content, execution_expires_after, model, seed, watermark |
Paraméteroptional | Szerződésduration, resolution, ratio, service_tier, generate_audio |
Paramétermaterial_types | Szerződéstext, image |
Paraméteradditional_properties | Szerződéstrue |
Paramétervalidation_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éterimage_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 | Hang generálása | Szolgáltatási szint | Elszámolási egység | Díj |
|---|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Hang generálása— | Szolgáltatási szint— | 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ásOffline feldolgozású szolgáltatási szint (flex). Kimenet szinkronizált hanggal. | Díjtáblázat— | Előre jelzett mennyiség— | Hang generálásaHanggal | Szolgáltatási szintflex | Elszámolási egység1K videótokenenként | Díj Kimenet · Becslés, csak összehasonlításra $0.0024 1K videótokenenként |
| BeállításOffline feldolgozású szolgáltatási szint (flex). Kimenet szinkronizált hang nélkül. | Díjtáblázat— | Előre jelzett mennyiség— | Hang generálásaHang nélkül | Szolgáltatási szintflex | Elszámolási egység1K videótokenenként | Díj Kimenet · Becslés, csak összehasonlításra $0.0012 1K videótokenenként |
| BeállításOnline feldolgozású szolgáltatási szint (default). Kimenet szinkronizált hanggal. | Díjtáblázat— | Előre jelzett mennyiség— | Hang generálásaHanggal | Szolgáltatási szintdefault | Elszámolási egység1K videótokenenként | Díj Kimenet · Becslés, csak összehasonlításra $0.0048 1K videótokenenként |
| BeállításOnline feldolgozású szolgáltatási szint (default). Kimenet szinkronizált hang nélkül. | Díjtáblázat— | Előre jelzett mennyiség— | Hang generálásaHang nélkül | Szolgáltatási szintdefault | Elszámolási egység1K videótokenenként | Díj Kimenet · Becslés, csak összehasonlításra $0.0024 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 | Hang generálása— | Szolgáltatási szint— | Elszámolási egység— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.1152 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ó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-5-pro-251215","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800,"generate_audio":false}
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}/contentGET /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-5-pro-251215
Metódusútvonalak álnevei
/v1/videos/generations
Kapcsolódó modellazonosítók
FAQ · ByteDance: Seedance 1.5 Pro
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·doubao-seedance-1-5-pro-251215:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos·doubao-seedance-1-5-pro-251215:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after,generate_audio- Milyen korlátok érvényesek?
POST /v1/videos·doubao-seedance-1-5-pro-251215:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200