ByteDance: Seedance 2.0
ByteDance Seedance 2.0 spája natívne generovanie zvuku a videa s obrazovými, video a zvukovými referenciami. Režírujte nové scény, upravujte existujúce zábery alebo predlžujte postupnosť; štandardná verzia zahŕňa dokumentovaný výstup 1080p a 10-bitový 4K.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Seedance 2.0 je štandardný model ByteDance Seed pre multimodálnu tvorbu zvuku a videa. Spája text, obrázky, videá a zvuk v architektúre spoločného generovania so samostatnými tvorivými postupmi pre scény vedené referenciami, úpravu videa a predĺženie videa. Je užitočný, keď zadanie potrebuje súvislý prednes aj konkrétne vizuálne alebo zvukové informácie z pripravených materiálov.
Multimodálna referencia a režijné ovládanie
Obrázky môžu definovať vzhľad subjektu, vizuálny štýl a kompozíciu. Video referencie môžu usmerňovať akciu, pohyb kamery a efekty. Zvuk môže usmerňovať farbu hlasu, hudbu alebo dialóg. Definujte úlohu každého materiálu a potom opíšte výslednú scénu. Výrobca zdôrazňuje ovládanie prednesu, osvetlenia, tieňov a jazyka kamery.
Pri produktovom príbehu pripravte obrázok produktu, referenciu pohybu kamery a zvukový podnet. Zadanie môže znieť: „Zachovajte modrú sklenenú vázu z Image 1. Použite pomalý bočný sledovací pohyb z Video 1. Váza stojí na slnkom osvetlenej polici s jemnou inštrumentálnou hudbou založenou na Audio 1.“ Zamýšľaným výstupom je novo rozvrhnutá scéna kombinujúca vybrané referenčné informácie.
Referenčné vstupy môžu kombinovať obrázok a zvuk, obrázok a video, video a zvuk alebo všetky tri. Vstup len zo zvuku a text so zvukom bez obrázka alebo videa nie sú podporované. Dokumentované sú aj tradičný prevod textu na video, generovanie z prvej snímky a generovanie z prvej a poslednej snímky. Ak sú dôležité pevné úvodné a záverečné kompozície, použite vyhradený postup koncových bodov: pomenovanie referenčného obrázka ako koncového bodu v omni-referenčnom prompte je len nepriamym usmernením.
Úprava záberov
Model môže nahradiť subjekt, pridať alebo odstrániť predmety, zmeniť prvky a prekresliť alebo opraviť časti videa. Opíšte konkrétnu zmenu a identifikujte zdrojové zábery. Pri pridaní zahrňte čas výskytu a polohu; pri odstránení alebo náhrade predmet presne určite a pomenujte, čo má zostať.
Napríklad: „Nahraďte stolovú lampu vo Video 1 mosadznou lampou z Image 1. Zachovajte pohyb kamery, usporiadanie stola a smer osvetlenia.“ Požadovaným výsledkom je upravená verzia scény so zamýšľanou náhradou. Skontrolujte nezmenené oblasti aj nový predmet, najmä počas zakrytia, pohybu a zmien záberov.
Predlžovanie a spájanie postupnosti
Seedance 2.0 môže predĺžiť video dopredu alebo dozadu a spojiť až tri dodané klipy generovanými prechodmi. Určite časový smer a novú udalosť. Pri moste usporiadajte klipy a opíšte prechod medzi každou dvojicou, napríklad vstup kamery do dverí v jednom zábere a príchod do ďalšieho prostredia.
Jednoduché predĺženie typicky vracia pokračovanie vytvorené okolo zdrojových záberov; ak má konečný výsledok opakovať aj pôvodný segment, zahrňte jasný pokyn. Pri dopĺňaní spojenia medzi dvoma alebo tromi klipmi môže dokumentovaný postup zahŕňať pôvodný materiál aj nový prechodový obsah. Je to užitočné pre vývoj začiatku alebo konca či spojenie pripravených scén bez ponechania spájajúcej akcie neurčenej.
Výstup štandardnej verzie a 4K
Štandardná verzia dokumentuje MP4 pri 24 fps a dĺžky 4 až 15 sekúnd. Výstupné úrovne sú 480p, 720p a 1080p s 8-bitovou farebnou hĺbkou a 4K s 10-bitovou farebnou hĺbkou. Podporované pomery sú 21:9, 16:9, 4:3, 1:1, 3:4 a 9:16. Dokumentované sú aj adaptívny záber a automatický výber dĺžky. Verzia Fast má vlastnú užšiu výstupnú špecifikáciu 480p/720p.
Výstup 4K používa kódovanie H.265/HEVC. Desaťbitové kódovanie zachováva dodatočné tónové stupne a plynulejšie farebné prechody, čo je dôležité pri materiáli s jemnými svetelnými alebo farebnými gradientmi. Overte, že zamýšľané prostredie prehrávania a úprav dokáže tento formát dekódovať; niektoré prehliadače a zariadenia ho priamo neprehrávajú. Kompatibilný kontajner sám nezaručuje kompatibilné dekódovanie videa.
Model môže generovať synchronizovaný zvuk alebo tiché video a vrátiť poslednú vygenerovanú snímku pre nasledujúcu scénu. Generovaný zvuk je mono. Rodina 2.0 nepodporuje samostatný dvojfázový náhľadový režim Draft, preto túto náhľadovú funkciu nemožno odvodzovať z inej verzie Seedance.
Príprava referencií a podstatné hranice
Dokumentovaná referenčná kapacita je až deväť obrázkov, tri videá a tri zvukové klipy. Priame nahrávanie referenčných obrázkov alebo videí so skutočnými ľudskými tvárami nie je v tomto dokumentovanom profile výrobcu prijímané; portrétna práca používa podporovaný postup portrétnych materiálov. Každý video a zvukový klip musí mať 2–15 sekúnd. Všetky video referencie spolu sa musia zmestiť do 15 sekúnd a všetky zvukové referencie majú vlastný celkový limit 15 sekúnd. Video súbory používajú MP4 alebo MOV pri 24–60 fps, do 200 MB každý; zvukové súbory používajú WAV alebo MP3, do 15 MB každý. Uvedené obrazové formáty sú JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC a HEIF. Obrázky musia byť každý menší než 30 MB a telo požiadavky nesmie prekročiť 64 MB. V dokumentovanom profile referenčného vstupu musia byť šírka a výška obrázka každá striktne medzi 300 a 6 000 pixelmi s pomerom šírky k výške striktne medzi 0.4 a 2.5. Referenčné videá umožňujú 300–6 000 pixelov v každom rozmere a pomery 0.4–2.5 vrátane hraníc s celkovo 407 696–8 295 044 pixelmi. Videá MP4 alebo MOV používajú video H.264/AVC alebo H.265/HEVC a zvuk AAC alebo MP3.
Súbory usporiadajte zámerne a na každý odkazujte jeho mediálnym typom a číslom: Image 1, Video 1 a Audio 1. Číslo sleduje poradie medzi súbormi daného typu. Vysvetlite, ktoré vlastnosti preniesť a ktorý zdrojový obsah nemá definovať novú scénu. Dokumentované jazyky promptov zahŕňajú angličtinu, španielčinu, indonézštinu, portugalčinu a japončinu. V dialógu zachovajte konzistentný hovorený jazyk; príručka neodporúča miešať jazyky okrem vlastných mien. Pri práci vedenej hlasom oddeľte hovoriaceho, presnú repliku a pokyn prednesu.
Prvý a posledný obrázok pripravte s kompatibilným záberom. Nesúlad vstupného obrázka a výstupných rozmerov môže viesť k orezaniu alebo náhlej vizuálnej zmene; zhodné rozmery a adaptívny záber sú dokumentované riešenia. Opis sústreďte na udalosť a referenčné úlohy. Výrobca varuje, že dlhé prompty môžu rozptýliť informácie a viesť k ignorovaniu detailov. Výsledný pohyb, kontinuitu referencií, zvukový prednes a spoje scén kontrolujte ako samostatné časti tvorivého výsledku.
Plánovanie záberov a smerovanie textu
Pri zložitej scéne usporiadajte zadanie ako Záber 1, Záber 2 a Záber 3 a v poradí určite kameru, akciu subjektu, polohu a zvuk. Príručka odporúča jeden pohyb kamery na záber a uprednostnenie pomalých nadväzujúcich akcií. Presné časové značky záberov sú nestabilné, preto je postupnosť udalostí lepším ovládaním než vynucovanie viacerých presných časových okien.
Model generuje aj bežný text vrátane sloganov, titulkov a rečových bublín. Môžete určovať farbu textu, vizuálne spracovanie, miesto a vstup. Používajte bežné znaky namiesto zriedkavých znakov alebo špeciálnych symbolov a znenie kontrolujte v pohybe. Pri referenciách subjektov jasne previažte každý materiál so zamýšľanou postavou alebo predmetom. Rôzne pohľady na produkt môžu dodať odlišné vizuálne informácie; koláže otočení postavy môžu zmiasť identitu tváre. Dokumentovaným odporúčaním referencie postavy je samostatný jasný portrét hlavy a celotelový obrázok.
Správanie na kontrolu pred zostrihom
Príručka dokumentuje nechcené titulky, logá, duplicitné postavy a odchýlky štýlu. Čistý zdrojový materiál, konzistentné označenia a explicitné obmedzenia tieto riziká znižujú, ale negarantujú zmiznutie nechceného textu alebo duplicitných postáv. Viac než štyri referenčné osoby sa uvádzajú ako riziko stability, odlišné od počtu súborov prijímaných modelom.
Predĺženie videa môže vytvoriť skok alebo návrat na spoji a opakované pokračovania môžu kumulovať zhoršenie kvality obrazu. Skontrolujte hraničné snímky a obmedzte navrstvené predĺženia. Referenčný hlas sa môže líšiť od zdrojovej farby; rozprávanie môže skončiť cvaknutím alebo náhlym ukončením, pre ktoré je dokumentovaným riešením stíšenie zvuku. Čínske viacvýslovnostné, neobvyklé alebo podobne tvarované znaky môžu byť vyslovené nesprávne. Pri presnom animovanom efekte, napríklad odpočítavaní, je pohybová referencia informatívnejšia než samotná slovná požiadavka. To sú konkrétne dôvody samostatne kontrolovať identitu, text, pohyb a zvuk pri výbere klipu.
Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0
bytedance/seedance-2.0Úvod
ByteDance Seedance 2.0 spája natívne generovanie zvuku a videa s obrazovými, video a zvukovými referenciami. Režírujte nové scény, upravujte existujúce zábery alebo predlžujte postupnosť; štandardná verzia zahŕňa dokumentovaný výstup 1080p a 10-bitový 4K.
- Povolené vstupy
- Text · Obrázky · Audio
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image,audio- Výstup
video- Výstupný formát
- pôvodné bajty MP4; bez normalizácie a prekódovania
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity bytedance/seedance-2.0 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 480p, 720p, 1080p, 4K | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Predvolené— |
Polegenerate_audio | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false, true Podmienky: Pri 480p a 720p vynechanie generate_audio vyberie cenu so zvukom a false vyberie cenu bez zvuku. Pri 1080p a 4K platí cena rozlíšenia pre obe nastavenia. Vrátenú zvukovú stopu overte v has_audio vo výsledku. | Predvolené— |
Poleframe_images | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 2 Vstupný obsah: Pole objektov snímok. Každý má type=image_url, image_url obsahujúce url a frame_type=first_frame alebo last_frame. Každá rola sa môže vyskytnúť najviac raz. Použite verejné HTTPS URL. Presné kľúče: type, image_url, frame_type Podmienky: Tieto kľúče sa vzťahujú na každý objekt snímky. Pri čisto textovej požiadavke vynechajte frame_images. | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Vstupný obsah: Pole objektov obrazových alebo zvukových referencií. Nastavte type na image_url alebo audio_url a zadajte zodpovedajúci objekt URL obsahujúci url. Video referencie sa naďalej nedajú oceniť. Podmienky: Režim referencií použijete vynechaním frame_images. Použite verejné HTTPS URL. | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 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 Vzor: ^[1-9][0-9]*x[1-9][0-9]*$ | Predvolené— |
Poleseed | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Predvolené— |
Polecallback_url | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Vzor: ^https:// | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletrace | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Kombinácie vstupných podkladov
Z textu na video · Textové zadanie. · Povinné: model, prompt, duration
Zadajte textové zadanie a podporovanú dĺžku v celých sekundách. Použite presnú uvedenú veľkosť alebo rozlíšenie a pomer strán, ktoré vedú k uvedeným rozmerom.
model: Typ: string · bytedance/seedance-2.0
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Z obrázka na video · Textové zadanie a obrázok snímky. · Povinné: model, prompt, duration, frame_images
frame_images je pole objektov s type=image_url, image_url obsahujúcim url a frame_type. Použite verejnú HTTPS URL obrázka; first_frame a last_frame sa môžu vyskytnúť každý raz. Použite uvedenú veľkosť výstupu alebo kompatibilné rozmery. Nepridávajte video referencie.
Presné kľúče: type, image_url, frame_type
model: Typ: string · bytedance/seedance-2.0
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Reference to video · Textové zadanie a obrazové alebo zvukové referencie. · Povinné: model, prompt, duration, input_references
input_references je pole. Každý objekt má type=image_url alebo type=audio_url a zodpovedajúci objekt URL obsahujúci url. Použite verejné HTTPS odkazy. Režim referencií vyberiete vynechaním frame_images. Video referencie nemožno oceniť.
model: Typ: string · bytedance/seedance-2.0
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, duration |
Parametermaterial_types | Špecifikáciatext, image, audio |
Parameteradditional_properties | Špecifikáciafalse |
Parameteroptional_controls | Špecifikáciaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Životný cyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Podmienky účtovania | Poplatok |
|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena tokenu videa · Odhad iba na porovnanie $0.014 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniaresolution: 1080p | Poplatok Výstup · Cena tokenu videa · Odhad iba na porovnanie $0.0154 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniavstup: with_video_input; rozlíšenie: 1080p | Poplatok reference · Cena tokenu videa · Odhad iba na porovnanie $0.0094 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniaresolution: 4k | Poplatok Výstup · Cena tokenu videa · Odhad iba na porovnanie $0.008 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniavstup: with_video_input; rozlíšenie: 4k | Poplatok reference · Cena tokenu videa · Odhad iba na porovnanie $0.0048 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniavstup: with_video_input | Poplatok reference · Cena tokenu videa · Odhad iba na porovnanie $0.0086 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Podmienky účtovaniazvuk: without_audio | Poplatok Výstup · Cena tokenu videa · Odhad iba na porovnanie $0.014 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.3024 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
Cenové referencie konfigurácií videa
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaCena tokenu videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena tokenu videa $0.014 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Podmienky účtovaniaresolution: 4k | Poplatok Výstup · Cena tokenu videa $0.008 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Podmienky účtovaniaresolution: 1080p | Poplatok Výstup · Cena tokenu videa $0.0154 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Podmienky účtovaniazvuk: without_audio | Poplatok Výstup · Cena tokenu videa $0.014 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Podmienky účtovaniavstup: with_video_input | Poplatok reference · Cena tokenu videa $0.0086 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Podmienky účtovaniavstup: with_video_input; rozlíšenie: 4k | Poplatok reference · Cena tokenu videa $0.0048 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
| KonfiguráciaCena tokenu videa | Podmienky účtovaniavstup: with_video_input; rozlíšenie: 1080p | Poplatok reference · Cena tokenu videa $0.0094 za 1K video tokenov Sadzba za video tokeny je hlavným cenovým údajom. Orientačné odhady za sekundu sú samostatné referenčné údaje, nie dodatočný poplatok. |
Príklady požiadaviek
Ailoot Ultra · Video
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
Prijať a uložiť výsledky
Ailoot Ultra · Video
podpísané URL obsahu vo vašom vlastníctve
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Skontrolovať stav úlohy
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
Čítanie ďalšieho obsahu
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
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Zachovajte každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.
Ak treba overiť pôvodnú odpoveď
503 result_pending_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte
Polia odpovede
| Pole | Typ | Význam |
|---|---|---|
Poleindex | Typinteger | VýznamPozícia tohto videa v zozname výstupov, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodpísaná HTTPS URL na stiahnutie tohto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOdtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný. |
Polesize_bytes | Typinteger | null | VýznamVeľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná. |
Poleduration_ms | Typinteger | null | VýznamNameraná dĺžka videa v milisekundách; null, ak nie je dostupná. |
Polewidth | Typinteger | null | VýznamŠírka videa v pixeloch; null, ak nie je dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixeloch; null, ak nie je dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, ak nie je zaznamenaný. |
Polehas_audio | Typboolean | null | VýznamČi video obsahuje zvukovú stopu; null, ak sa to nemeralo. |
Poleaudio_codec | Typstring | null | VýznamIdentifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor. |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď404 · not_found_error | PodmienkaPrístup k videu nie je dostupný alebo sa toto ID videa nenašlo. | Ďalší krokSkontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API. |
Odpoveď401 · authentication_error | PodmienkaKľúč API nezodpovedá overenému účtu. | Ďalší krokPred odoslaním skontrolujte svoj kľúč API a prístup účtu. |
Odpoveď400 · invalid_request_error | PodmienkaPožiadavku sa nepodarilo načítať alebo je index sťahovania neplatný. | Ďalší krokOpravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou. |
Odpoveď422 · price_unavailable | PodmienkaCenu vybranej konfigurácie videa nemožno určiť. | Ďalší krokVyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti. |
Odpoveď422 · invalid_request_error | PodmienkaVstup videa alebo pôvodná úloha pokračovania sú neplatné. | Ďalší krokPoužite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API. |
Odpoveď402 · billing_error | PodmienkaDostupný zostatok alebo limity neumožňujú rezerváciu. | Ďalší krokPred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity. |
Odpoveď503 · server_error | PodmienkaOverovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné. | Ďalší krokPočkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania. |
Odpoveď503 · result_pending_check | PodmienkaPôvodný výsledok videa a poplatok treba skontrolovať. | Ďalší krokZachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie. |
Odpoveď503 · owned_result_unavailable | PodmienkaStiahnutie existujúceho videa je dočasne nedostupné. | Ďalší krokNeskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu. |
Odpoveď409 · video_not_ready | PodmienkaObsah videa nebol zverejnený. | Ďalší krokSkontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku. |
Aliasy
Aliasy modelov
Ailoot Ultra bytedance/seedance-2.0
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · ByteDance: Seedance 2.0
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·bytedance/seedance-2.0:text,image,audio→video- Aké polia používa požiadavka?
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- Aké limity platia?
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