ByteDance: Seedance 2.0
A ByteDance Seedance 2.0 natív hang–videó generálást kapcsol össze kép-, videó- és hangreferenciákkal. Irányíts új jeleneteket, szerkessz meglévő felvételt vagy hosszabbíts sorozatot; a standard változat dokumentált 1080p és 10 bites 4K kimenetet tartalmaz.
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 2.0 a ByteDance Seed standard modellje multimodális hang–videó alkotáshoz. Szöveget, képeket, videókat és hangot kapcsol össze közös generálási architektúrában, külön alkotói munkafolyamattal referenciaalapú jelenetekhez, videószerkesztéshez és videóhosszabbításhoz. Akkor hasznos, ha a feladatleíráshoz összefüggő előadás és előkészített anyagokból származó konkrét vizuális vagy hangi információ egyaránt kell.
Multimodális referencia és rendezői vezérlés
Képek határozhatják meg az alany megjelenését, vizuális stílust és kompozíciót. Videóreferenciák irányíthatják a cselekményt, kameramozgást és effekteket. Hang irányíthatja a hangszínt, zenét vagy párbeszédet. Határozd meg minden anyag szerepét, majd írd le a kívánt jelenetet. A gyártó az előadás, világítás, árnyékok és kameranyelv vezérlését hangsúlyozza.
Terméktörténethez készíts termékképet, kameramozgás-referenciát és hangjelzést. Egy feladatleírás: „Őrizd meg az Image 1 kék üvegvázáját. Használd a Video 1 lassú oldalirányú kamerakövetését. A váza napsütötte polcon áll, halk hangszeres zenével az Audio 1 alapján.” A kívánt kimenet újonnan beállított jelenet, amely kiválasztott referenciainformációkat kapcsol össze.
A referenciabemenetek képet és hangot, képet és videót, videót és hangot vagy mindhármat kombinálhatják. A csak hangból álló bemenet, illetve szöveg és hang kép vagy videó nélkül nem támogatott. Hagyományos szöveg–videó, első képkockás és első–utolsó képkockás generálás is dokumentált. Ha fontos a rögzített nyitó- és zárókompozíció, a dedikált végpont-munkafolyamatot használd: egy referenciakép végpontként való megnevezése omni-reference promptban csak közvetett irányítás.
Felvétel szerkesztése
A modell alanyt cserélhet, tárgyat adhat hozzá vagy távolíthat el, elemeket módosíthat és videórészeket rajzolhat újra vagy javíthat. Írd le a konkrét változást, és azonosítsd a forrásfelvételt. Hozzáadásnál add meg a megjelenési időt és pozíciót; eltávolításnál vagy cserénél pontosan nevezd meg a tárgyat és azt, minek kell megmaradnia.
Például: „Cseréld a Video 1 asztali lámpáját az Image 1 sárgaréz lámpájára. Tartsd meg a kameramozgást, asztalelrendezést és fényirányt.” A kívánt eredmény a jelenet szerkesztett változata a tervezett cserével. A változatlan területeket és új tárgyat is vizsgáld meg, különösen takarás, mozgás és snittváltás során.
Sorozat hosszabbítása és összekapcsolása
A Seedance 2.0 előre vagy visszafelé hosszabbíthat videót, és legfeljebb három megadott klipet kapcsolhat össze generált átmenetekkel. Add meg az időbeli irányt és új eseményt. Átkötésnél rendezd sorba a klipeket, és írd le az egyes párok közötti átmenetet, például ahogy a kamera az egyik snittben belép egy ajtón, a következőben pedig megérkezik az új környezetbe.
Az egyszerű hosszabbítás jellemzően a forrásfelvétel körül kialakított folytatást adja vissza; adj egyértelmű utasítást, ha a végső eredménynek az eredeti szegmenst is meg kell ismételnie. Két-három klip összekapcsolásakor a dokumentált munkafolyamat eredeti anyagot és új átmeneti tartalmat is tartalmazhat. Ez hasznos nyitás vagy lezárás kidolgozásához, illetve előkészített jelenetek összekötéséhez anélkül, hogy az összekötő cselekmény meghatározatlan maradna.
Standard kimenet és 4K
A standard változat 24 fps-es MP4-et és 4–15 másodperces időtartamokat dokumentál. Kimeneti szintjei 480p, 720p és 1080p 8 bites színmélységgel, továbbá 4K 10 bites színmélységgel. Támogatott arányok: 21:9, 16:9, 4:3, 1:1, 3:4 és 9:16. Adaptív képkivágás és automatikus időtartamválasztás is dokumentált. A Fast változat saját, szűkebb 480p/720p kimeneti specifikációval rendelkezik.
A 4K kimenet H.265/HEVC kódolást használ. A tízbites kódolás további tónusfokozatokat és simább színátmeneteket őriz meg, ami finom fény- vagy színátmeneteket tartalmazó anyagnál fontos. Ellenőrizd, hogy a tervezett lejátszási és szerkesztési környezet dekódolja-e ezt a formátumot; egyes böngészők és eszközök nem játsszák le közvetlenül. A kompatibilis konténer önmagában nem biztosít kompatibilis videódekódolást.
A modell szinkronizált hangot vagy néma videót generálhat, és visszaadhatja az utolsó generált képkockát egy későbbi jelenethez. A generált hang mono. A 2.0 család nem támogatja a külön kétlépcsős Draft-előnézet módot, ezért ezt az előnézeti funkciót nem szabad más Seedance-változatból következtetni.
Referencia-előkészítés és lényeges korlátok
A dokumentált referenciakapacitás legfeljebb kilenc kép, három videó és három hangklip. Valódi emberi arcot tartalmazó referenciaképek vagy videók közvetlen feltöltése ebben a dokumentált gyártói leírásban nem elfogadott; portrémunkához a támogatott portréanyag-munkafolyamat használatos. Minden videó- és hangklipnek 2–15 másodpercesnek kell lennie. Az összes videóreferenciának együtt 15 másodpercbe kell férnie, és az összes hangreferenciának külön 15 másodperces összkorlátja van. A videófájlok MP4-et vagy MOV-ot használnak 24–60 fps-sel, egyenként legfeljebb 200 MB-ig; a hangfájlok WAV-ot vagy MP3-at, egyenként legfeljebb 15 MB-ig. A felsorolt képformátumok JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC és HEIF. Minden kép 30 MB-nál kisebb legyen, a kéréstörzs pedig nem haladhatja meg a 64 MB-ot. A dokumentált referenciabemenetnél a képszélesség és -magasság szigorúan 300 és 6000 pixel közötti, a szélesség–magasság arány szigorúan 0.4 és 2.5 közötti. A referenciavideók mindkét mérete 300–6000 pixel és aránya 0.4–2.5 lehet, a határokat beleértve, összesen 407 696–8 295 044 pixellel. Az MP4 vagy MOV videók H.264/AVC vagy H.265/HEVC videót és AAC vagy MP3 hangot használnak.
Tudatosan rendezd sorba a fájlokat, és médiatípusukkal, valamint számukkal hivatkozz rájuk: Image 1, Video 1 és Audio 1. A szám az adott típus fájljainak sorrendjét követi. Magyarázd el, mely tulajdonságok kerüljenek át, és melyik forrástartalom ne határozza meg az új jelenetet. A dokumentált promptnyelvek között angol, spanyol, indonéz, portugál és japán szerepel. Párbeszéden belül tartsd következetesen a beszélt nyelvet; az útmutató tulajdonnevek kivételével nem ajánlja a nyelvkeverést. Hangvezérelt munkánál különítsd el a beszélőt, a pontos sort és az előadásutasítást.
Az első és utolsó képet kompatibilis kivágással készítsd elő. A bemeneti kép és kimeneti méretek eltérése vágást vagy hirtelen vizuális váltást okozhat; az egyező méretek és adaptív képkivágás dokumentált megoldások. A leírást az eseményre és referenciák szerepére összpontosítsd. A gyártó figyelmeztet, hogy a hosszú promptok szétszórhatják az információt, ezért részletek figyelmen kívül maradhatnak. A létrejött mozgást, referenciafolytonosságot, hangelőadást és jelenetcsatlakozásokat az alkotói eredmény külön részeiként ellenőrizd.
Snitttervezés és szövegirányítás
Összetett jelenethez Shot 1, Shot 2 és Shot 3 formában szervezd a feladatot, sorrendben megadva a kamerát, az alany műveletét, pozícióját és hangját. Az útmutató snittenként egy kameramozgást és lassú, összekapcsolt műveletek előnyben részesítését ajánlja. A pontos snittenkénti időbélyegek instabilak, ezért az eseménysor jobb vezérlés több pontos időablak erőltetésénél.
A modell közönséges szöveget, köztük szlogeneket, feliratokat és szövegbuborékokat is generál. Irányíthatod a szöveg színét, vizuális feldolgozását, helyét és belépését. Gyakori karaktereket használj ritka karakterek vagy speciális szimbólumok helyett, és mozgás közben ellenőrizd a megfogalmazást. Alanyreferenciáknál minden anyagot világosan köss a kívánt karakterhez vagy tárgyhoz. A terméknézetek eltérő vizuális információt adhatnak; a karakterkörbeforgatási kollázsok összezavarhatják az arcazonosságot. A dokumentált karakterreferencia-ajánlás külön tiszta portré és teljes alakos kép.
Szerkesztés előtt ellenőrizendő viselkedések
Az útmutató nem kívánt feliratokat, logókat, duplikált karaktereket és stíluseltérést dokumentál. Tiszta forrásanyag, következetes címkék és explicit korlátok csökkentik a kockázatokat, de nem garantálják a nem kívánt szöveg vagy duplikált alakok eltűnését. Négynél több referencia-személy használatát stabilitási kockázatként említi, a modell által elfogadott fájlszámtól külön kezelve.
A videóhosszabbítás ugrást vagy visszalépést okozhat a csatlakozásnál, az ismételt folytatások pedig halmozhatják a képminőség-romlást. Vizsgáld meg a határképkockákat, és korlátozd az egymásra épített hosszabbításokat. A referenciahang eltérhet a forrás hangszínétől; a narráció kattintással vagy hirtelen levágással végződhet, amelyhez a hangkiúsztatás dokumentált megoldás. A kínai többkiejtésű, ritka vagy hasonló alakú karakterek hibásan hangozhatnak el. Pontos animált effekthez, például visszaszámláláshoz a mozgásreferencia informatívabb a puszta szóbeli kérésnél. Ezek konkrét okok az azonosság, szöveg, mozgás és hang külön ellenőrzésére a klip kiválasztásakor.
Ailoot Ultra · Videó POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Kezdő lépések
A ByteDance Seedance 2.0 natív hang–videó generálást kapcsol össze kép-, videó- és hangreferenciákkal. Irányíts új jeleneteket, szerkessz meglévő felvételt vagy hosszabbíts sorozatot; a standard változat dokumentált 1080p és 10 bites 4K kimenetet tartalmaz.
- Elfogadott bemenetek
- Szöveg · Képek · Hang
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image,audio- Kimenet
video- Kimeneti formátum
- eredeti MP4-bájtok; normalizálás és átkódolás nélkül
| 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 bytedance/seedance-2.0 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményKötelező | Értékek és korlátok 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480p, 720p, 1080p, 4K | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Alapértelmezett— |
Mezőgenerate_audio | Típusboolean | KövetelményOpcionális | Értékek és korlátok false, true Feltételek: 480p és 720p esetén a generate_audio elhagyása a hangot tartalmazó árat, a false pedig a hang nélküli árat választja ki. 1080p és 4K esetén mindkét beállításra az adott felbontás ára érvényes. A visszaadott hangsávot az eredmény has_audio mezőjében ellenőrizze. | Alapértelmezett— |
Mezőframe_images | Típusarray | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 2 Bemeneti tartalom: Képkockaobjektumok tömbje. Mindegyikben type=image_url, url mezőt tartalmazó image_url és frame_type=first_frame vagy last_frame szerepel. Minden szerep legfeljebb egyszer fordulhat elő. Használjon nyilvános HTTPS URL-címeket. Pontos kulcsok: type, image_url, frame_type Feltételek: Ezek a kulcsok minden képkockaobjektumra vonatkoznak. Kizárólag szöveges kérésnél hagyja el a frame_images mezőt. | Alapértelmezett— |
Mezőinput_references | Típusarray | KövetelményOpcionális | Értékek és korlátok Bemeneti tartalom: Kép- vagy hangreferencia-objektumok tömbje. A type értéke image_url vagy audio_url legyen, és adja meg a hozzá tartozó, url mezőt tartalmazó URL-objektumot. A videóreferenciák továbbra sem árazhatók. Feltételek: A referenciaanyagokkal dolgozó módhoz hagyja el a frame_images mezőt. Használjon nyilvános HTTPS URL-címeket. | Alapértelmezett— |
Mezősize | Típusstring | KövetelményOpcionális | Értékek és korlátok 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720, 1080x1080, 1080x1440, 1080x1920, 1440x1080, 1920x1080, 2520x1080, 3840x2160, 2160x3840, 2160x2160, 2880x2160, 2160x2880, 5040x2160 Minta: ^[1-9][0-9]*x[1-9][0-9]*$ | Alapértelmezett— |
Mezőseed | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Alapértelmezett— |
Mezőcallback_url | Típusstring | KövetelményOpcionális | Értékek és korlátok Minta: ^https:// | Alapértelmezett— |
Mezősession_id | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőtrace | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőuser | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Bemeneti anyagok kombinációi
Szövegből videó · Írott utasítás. · Kötelező: model, prompt, duration
Adjon meg szöveges utasítást és támogatott, egész másodpercekben megadott időtartamot. Használjon pontosan felsorolt méretet, vagy olyan felbontást és képarányt, amely felsorolt méreteket eredményez.
model: Típus: string · bytedance/seedance-2.0
prompt: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen
Képből videó · Írott utasítás és egy képkockakép. · Kötelező: model, prompt, duration, frame_images
A frame_images objektumok tömbje, type=image_url, url mezőt tartalmazó image_url és frame_type mezőkkel. Használjon nyilvános HTTPS kép-URL-címet; a first_frame és last_frame külön-külön egyszer szerepelhet. Használjon felsorolt kimeneti méretet vagy azzal összeegyeztethető méreteket. Ne adjon hozzá videóreferenciákat.
Pontos kulcsok: type, image_url, frame_type
model: Típus: string · bytedance/seedance-2.0
prompt: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen
Reference to video · Írott utasítás és kép- vagy hangreferenciák. · Kötelező: model, prompt, duration, input_references
Az input_references egy tömb. Minden objektum type=image_url vagy type=audio_url mezőt és egy hozzá tartozó, url mezőt tartalmazó URL-objektumot tartalmaz. Használjon nyilvános HTTPS hivatkozásokat. A referenciaanyagokkal dolgozó mód kiválasztásához hagyja el a frame_images mezőt. A videóreferenciák nem árazhatók.
model: Típus: string · bytedance/seedance-2.0
prompt: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration |
Paramétermaterial_types | Szerződéstext, image, audio |
Paraméteradditional_properties | Szerződésfalse |
Paraméteroptional_controls | Szerződésresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Életciklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Elszámolási feltételek | Díj |
|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | Elszámolási feltételek— | 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ásVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videótoken ára · Becslés, csak összehasonlításra $0.014 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekresolution: 1080p | Díj Kimenet · Videótoken ára · Becslés, csak összehasonlításra $0.0154 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekbemenet: videóbemenettel; felbontás: 1080p | Díj reference · Videótoken ára · Becslés, csak összehasonlításra $0.0094 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekresolution: 4k | Díj Kimenet · Videótoken ára · Becslés, csak összehasonlításra $0.008 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekbemenet: videóbemenettel; felbontás: 4k | Díj reference · Videótoken ára · Becslés, csak összehasonlításra $0.0048 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekbemenet: videóbemenettel | Díj reference · Videótoken ára · Becslés, csak összehasonlításra $0.0086 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egység1K videótokenenként | Elszámolási feltételekhang: hang nélkül | Díj Kimenet · Videótoken ára · Becslés, csak összehasonlításra $0.014 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| 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— | Elszámolási feltételek— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.3024 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 →
A referencia-díjszabás részletei
A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.
Videóbeállítások árhivatkozásai
Á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 | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításVideótoken ára | Elszámolási feltételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videótoken ára $0.014 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Elszámolási feltételekresolution: 4k | Díj Kimenet · Videótoken ára $0.008 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Elszámolási feltételekresolution: 1080p | Díj Kimenet · Videótoken ára $0.0154 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Elszámolási feltételekhang: hang nélkül | Díj Kimenet · Videótoken ára $0.014 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Elszámolási feltételekbemenet: videóbemenettel | Díj reference · Videótoken ára $0.0086 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Elszámolási feltételekbemenet: videóbemenettel; felbontás: 4k | Díj reference · Videótoken ára $0.0048 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
| BeállításVideótoken ára | Elszámolási feltételekbemenet: videóbemenettel; felbontás: 1080p | Díj reference · Videótoken ára $0.0094 1K videótokenenként A videótoken díjtétele az elsődleges árreferencia. A kiemelt, másodpercenkénti becslések külön árreferenciák, nem jelentenek további díjat. |
Példakérések
Ailoot Ultra · Videó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
PY_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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Eredmények fogadása és mentése
Ailoot Ultra · Videó
aláírt saját tartalom-URL-címek
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Feladatállapot ellenőrzése
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
További tartalomlekérések
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Ő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 az összes ténylegesen visszaadott, Önhöz tartozó kimenetet és a hozzájuk visszaadott mért metaadatokat.
Ha az eredeti választ ellenőrizni kell
503 result_pending_check + eredeti azonosító + X-Should-Retry:false; az eredeti kérést soha ne ismételje meg
Válaszmezők
| Mező | Típus | Jelentés |
|---|---|---|
Mezőindex | Típusinteger | JelentésE videó nullától induló pozíciója a kimeneti listában. |
Mezőcontent_url | Típusstring | JelentésAláírt HTTPS letöltési URL ehhez az elkészült videóhoz. |
Mezősha256 | Típusstring | null | JelentésAz eredeti videóbájtok SHA-256 lenyomata; null, ha nem érhető el. |
Mezősize_bytes | Típusinteger | null | JelentésAz eredeti videófájl mérete bájtban; null, ha nem érhető el. |
Meződuration_ms | Típusinteger | null | JelentésA videó mért időtartama ezredmásodpercben; null, ha nem érhető el. |
Mezőwidth | Típusinteger | null | JelentésA videó szélessége pixelben; null, ha nem érhető el. |
Mezőheight | Típusinteger | null | JelentésA videó magassága pixelben; null, ha nem érhető el. |
Mezővideo_codec | Típusstring | null | JelentésVideókodek-azonosító; null, ha nincs rögzítve. |
Mezőhas_audio | Típusboolean | null | JelentésJelzi, hogy a videó tartalmaz-e hangsávot; null, ha nem mérték meg. |
Mezőaudio_codec | Típusstring | null | JelentésHangkodek-azonosító; null, ha nincs azonosító rögzítve. |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz404 · not_found_error | FeltételA videóhoz való hozzáférés nem érhető el, vagy ez a videóazonosító nem található. | Következő lépésEllenőrizze a videóhoz való hozzáférést. Meglévő videónál használja annak eredeti nyilvános azonosítóját és ugyanazt az API-kulcsot. |
Válasz401 · authentication_error | FeltételAz API-kulcs nem egyezik a hitelesített fiókkal. | Következő lépésBeküldés előtt ellenőrizze az API-kulcsot és a fiók hozzáférését. |
Válasz400 · invalid_request_error | FeltételA kérés nem olvasható, vagy a letöltési index érvénytelen. | Következő lépésJavítsa a kérés törzsét. Letöltéshez az eredeti feladat által visszaadott kimeneti indexet válasszon. |
Válasz422 · price_unavailable | FeltételA kiválasztott videóbeállítás nem árazható. | Következő lépésVálasszon támogatott videóbeállítást, és adja meg az ahhoz kötelező opciókat a javított kérés beküldése előtt. |
Válasz422 · invalid_request_error | FeltételA videóbemenet vagy az eredeti folytatási feladat érvénytelen. | Következő lépésHasználjon érvényes HTTPS bemeneteket. Folytatáshoz adja meg az elkészült eredeti videó nyilvános azonosítóját ugyanazzal az API-kulccsal. |
Válasz402 · billing_error | FeltételA rendelkezésre álló egyenleg vagy a limitek nem teszik lehetővé az összeg zárolását. | Következő lépésÚj kérés elküldése előtt ellenőrizze a rendelkezésre álló egyenleget és a limiteket. |
Válasz503 · server_error | FeltételA videó ellenőrzése, tárolása vagy a szolgáltatás elérése átmenetileg nem áll rendelkezésre. | Következő lépésVárja meg, amíg a szolgáltatás elérhető lesz. Ha már van videóazonosítója, az eredeti feladatot ellenőrizze újabb generálás létrehozása helyett. |
Válasz503 · result_pending_check | FeltételAz eredeti videóeredményt és a díjat ellenőrizni kell. | Következő lépésŐrizze meg a visszaadott videóazonosítót, és ellenőrizze azt a feladatot. Az ellenőrzés ideje alatt ne küldjön helyettesítő generálási kérést. |
Válasz503 · owned_result_unavailable | FeltételA meglévő videó letöltése átmenetileg nem érhető el. | Következő lépésEllenőrizze később ugyanazt a videófeladatot, és töltse le annak meglévő kimenetét. Egy új generálás külön műveletet hoz létre. |
Válasz409 · video_not_ready | FeltételA videótartalom nincs közzétéve. | Következő lépésEllenőrizze az eredeti feladat állapotát. Akkor töltse le, amikor completed állapotot jelent; ha failed állapotot jelent, kövesse a díjellenőrzési értesítését. |
Álnevek
Modell álnevei
Ailoot Ultra bytedance/seedance-2.0
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · ByteDance: Seedance 2.0
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Mely mezőket használja a kérés?
POST /v1/videos·bytedance/seedance-2.0:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Milyen korlátok érvényesek?
POST /v1/videos·bytedance/seedance-2.0:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807