ByteDance: Seedance 2.5
Seedance 2.5 vytvára video z textu a referenčných obrázkov, videí či zvuku so zdokumentovanými postupmi úprav a predlžovania. Jeho konkrétny príklad 2.5 kombinuje obrázok produktu s viacerými pohybovými referenciami a zapína generovaný zvuk pre zladenú reklamnú sekvenciu.
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.5 vytvára video pomocou písomného opisu scény a multimodálnych referencií. Konkrétny identifikátor doubao-seedance-2-5-260628 má vlastnú zdokumentovanú operáciu a príklad. Táto operácia opisuje tvorbu, úpravy a predlžovanie videa s obrázkami, videom, zvukom a textom ako vstupnými médiami. Referenciami sprostredkujte vzhľad hlavného objektu, činnosť, pohyb kamery, štýl a zvuk a potom vysvetlite výsledok, ktorý z nich chcete vytvoriť.
Vstupné kombinácie zahŕňajú samotný text, obrázky alebo video s voliteľným textom, obrázky so zvukom, video so zvukom a obrázky, video a zvuk spolu. Uvedené kombinácie pripájajú zvuk k vizuálnym médiám; neopisujú požiadavku iba so zvukom. Každú položku usporiadajte podľa jej úlohy: obrázok určuje hlavný objekt alebo vzhľad, video predvádza pohyb alebo existujúcu scénu a zvuk poskytuje zvukovú referenciu. Uveďte, ktorá úloha je dôležitá pre požadovaný záber, aby sa referencia pozadia nezamenila za hlavnú postavu.
Konkrétny príklad 2.5 je produktová reklamná sekvencia. Dodáva obrázok a viacero referenčných videí, potom opisuje úvodný bod pozornosti, usporiadané zostavy produktov, detailné zábery, spomalenú činnosť a záverečnú kompozíciu značky. Požiadavka priraďuje roly reference_image a reference_video a používa jednotlivé referencie pre kompozíciu, pohyb, kameru a účinok. Dáva tak praktickú štruktúru pre koncept kampane: naplánujte viditeľné fázy, určte referenciu pre každú fázu a stanovte konečné usporiadanie.
Písomná sekvencia môže rozlíšiť, čo sa deje, od toho, ako sa to sníma. Najskôr opíšte, čo sa deje s produktom, potom veľkosť záberu, dráhu kamery, tempo a prechod k ďalšiemu pohľadu. Ak jedna referencia určuje produkt a druhá predvádza pohyb kamery, pomenujte tieto samostatné úlohy. Pri scéne s viacerými predmetmi vysvetlite ich polohy a poradie vzájomných interakcií. Vo vygenerovanom výsledku skontrolujte skutočný tvar produktu, usporiadanie a pohyb namiesto predpokladu, že sa každý detail referencie objaví nezmenený.
Pri úprave určte existujúce video a prvok na zmenu, napríklad prostredie, činnosť alebo vizuálny štýl, a uveďte nadväznosť, ktorú treba zachovať. Pri predĺžení opíšte, ako má scéna pokračovať z dodaných záberov. Skontrolujte spoj aj nový úsek: vzhľad hlavného objektu, smer pohybu, poloha kamery a načasovanie zvuku ovplyvňujú, či výsledok pôsobí ako jedna scéna. Pôvodné video a hotovú úpravu uchovajte spolu, aby ste mohli preveriť, či zmena zachováva zamýšľanú nadväznosť.
Zdokumentovaný multimodálny príklad 2.5 nastavuje generate_audio=true a žiada pätnásťsekundovú sekvenciu s formátom 16:9. Tieto hodnoty opisujú daný príklad, nie všeobecný horný limit trvania alebo limit referenčných podkladov. Jasne určte zvukový zámer požadovanej scény vrátane vzťahu hudby, efektov a viditeľnej činnosti, potom vyhodnoťte skutočný audiovizuálny výstup. Zvukovú referenciu a generovanú zvukovú stopu posudzujte spolu z hľadiska zamýšľaného tempa a podania.
Trvanie, kompozíciu a rozlíšenie vyberajte z nastavení ponúkaných pre tento konkrétny profil. Požadovanú konfiguráciu uchovajte s promptom a porovnajte ju so skutočne vrátenými poľami úlohy. Pri príprave hotového klipu pre cieľové použitie použite vrátené trvanie, rozlíšenie a pomer strán. V zázname verzie zachovajte presný identifikátor profilu, aby neskoršie porovnanie používalo tú istú zvolenú edíciu.
Spotreba videotokenov sa počíta ako (trvanie vstupného videa + trvanie výstupného videa) × šírka výstupu × výška výstupu × snímková frekvencia výstupu / 1024. Požiadavky so vstupným videom a bez vstupného videa patria do odlišných kategórií účtovania. Dotaz na úlohu vykazuje usage.completion_tokens a usage.total_tokens; tieto vykázané veličiny uchovajte spolu s dokončeným klipom.
Generovanie je asynchrónne. Odoslanie vráti identifikátor a nastavený postup úlohy poskytne stav a po úspešnom dokončení content.video_url. Hotový klip uložte spolu so zdrojovými médiami a zadaním sekvencie. V celom výsledku skontrolujte všetky plánované fázy, interakcie predmetov, vzhľad postáv, kompozíciu a zladenie zvuku. Pri úprave určte konkrétny nezachytený detail a zachovajte vydarené časti scény namiesto nahradenia celého zadania nesúvisiacimi pokynmi.
Ailoot Ultra · Generovanie videa POST /v1/videos doubao-seedance-2-5-260628
doubao-seedance-2-5-260628Úvod
Seedance 2.5 vytvára video z textu a referenčných obrázkov, videí či zvuku so zdokumentovanými postupmi úprav a predlžovania. Jeho konkrétny príklad 2.5 kombinuje obrázok produktu s viacerými pohybovými referenciami a zapína generovaný zvuk pre zladenú reklamnú sekvenciu.
- Povolené vstupy
- Text · Obrázky · Video · Audio
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Generovanie videa POST /v1/videos
- Vstup
text,image,video,audio- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity doubao-seedance-2-5-260628 | Predvolené— |
Polecontent | Typarray | PožiadavkaPovinné | Hodnoty a limity Podmienky: Natívne objekty textu a médií; vonkajšie pole musí byť neprázdne. Tento všeobecný konštruktor Ailoot neoveruje typy vnorených uzlov. | Predvolené— |
Polegenerate_audio | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Príklad 2.5 nastavuje true, prevzatý text voliča však uvádza iba 2.0/fast/1.5; širšia záruka nastavenia ani predvolenej hodnoty neexistuje. | Predvolené— |
Poleduration | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Doslovná hodnota 15 v príklade 2.5 nie je maximum ani predvolená hodnota. | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Z prevzatých opisov sa nevyvodzuje žiadna predvolená hodnota ani enum špecifický pre 2.5. | Predvolené— |
Poleratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Adaptive je výslovne vymedzené na 2.0/fast/1.5; príklad 2.5 používa iba 16:9. | Predvolené— |
Polewatermark | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity | Predvolenéfalse |
Poleseed | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: -1 Maximum: 4 294 967 295 | Predvolené-1 |
Poleexecution_expires_after | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 3 600 Maximum: 259 200 Jednotka: sekundy | Predvolené172 800 |
Poleservice_tier | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: 2.0/fast vylučujú offline flex; rozsah podpory pre 2.5 nie je stanovený. | Predvolené— |
Polesafety_identifier | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Kombinácie vstupných podkladov
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciacontent, model |
Parameteroptional | Špecifikáciagenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier |
Parametermaterial_types | Špecifikáciatext, image, video, audio |
Parameteradditional_properties | Špecifikáciatrue |
Parametervalidation_scope | ŠpecifikáciaAiloot kontroluje povinné typy polí a neprázdny model aj pole content. Ostatné polia požiadavky sa zachovávajú pre vybraný model. |
Parametermaterial_combinations | Špecifikáciatext, image, video, image, audio, image, video, video, audio, image, video, audio |
Parameteroptional_text_with_media | Špecifikáciatrue |
Parameterreference_media_count_and_size_limits | Špecifikácianull |
Aliasy metódy: /v1/videos/generations
Životný cyklus: 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
Vytvorte iba raz a zachovajte vrátené verejné id/polling_url.
Priebežne zisťujte stav pôvodnej úlohy; po succeeded stiahnite skutočné content.video_url vo vašom vlastníctve.
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 | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | 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áciaVstup obsahuje video. | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Poplatok Výstup · Odhad iba na porovnanie $0.012 za 1K video tokenov |
| KonfiguráciaVstup neobsahuje video. | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza 1K video tokenov | Poplatok Výstup · Odhad iba na porovnanie $0.02 za 1K video tokenov |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.822402 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 →
Príklady požiadaviek
Ailoot Ultra · Generovanie videa
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-2-5-260628","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}]}
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
Prijať a uložiť výsledky
Ailoot Ultra · Generovanie videa
Natívny JSON s verejným id/polling_url. Po zverejnení obsahuje content.video_url podpísané URL vo vlastníctve Ailoot; pred zverejnením sú vybrané URL výstupov prázdne.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
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ú URL v content.video_url; index musí označovať skutočne vrátený výstup.
Ak treba overiť pôvodnú odpoveď
Zachovajte pôvodnú odpoveď, hlavičky a id a priebežne zisťujte stav tejto operácie; vytvorenie s neznámym výsledkom nikdy znova neodosielajte.
Polia odpovede
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleprovider_task_id | Typstring |
Polepolling_url | Typstring |
Polestatus | Typstring when supplied |
Polecontent.video_url | Typstring|string[] |
Poleusage | Typobject when supplied |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNeplatný JSON/model/typy povinných polí alebo index obsahu. | Ďalší krok |
Odpoveď401 · authentication_error | PodmienkaNeplatný kľúč API služby Ailoot. | Ďalší krok |
Odpoveď404 · not_found_error | PodmienkaÚloha alebo výstup chýbajú alebo nepatria rovnakému používateľovi, kľúču API či skupine. | Ďalší krok |
Odpoveď502 · result_pending_check | PodmienkaPôvodné odoslanie alebo stav sú neúplné; zachovajte pôvodné ID a znova neodosielajte. | Ďalší krok |
Odpoveď503 · result_pending_check | PodmienkaPôvodné médium, trasa alebo zúčtovanie sa kontrolujú; pokračujte v pôvodnej operácii. | Ďalší krok |
Aliasy
Aliasy modelov
Ailoot Ultra doubao-seedance-2-5-260628
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · ByteDance: Seedance 2.5
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·doubao-seedance-2-5-260628:text,image,video,audio→video- Aké polia používa požiadavka?
POST /v1/videos·doubao-seedance-2-5-260628:model,content,generate_audio,duration,resolution,ratio,watermark,seed,execution_expires_after,service_tier,safety_identifier- Aké limity platia?
POST /v1/videos·doubao-seedance-2-5-260628:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200