ByteDance: Seedance 2.5
Seedance 2.5 vytváří video z textu a obrazových, video nebo zvukových referencí, s dokumentovanými postupy úprav a prodlužování. Jeho konkrétní příklad 2.5 kombinuje produktový obrázek s několika pohybovými referencemi a zapíná generovaný zvuk pro sladěnou reklamní sekvenci.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Seedance 2.5 vytváří video pomocí písemného popisu scény a multimodálních referencí. Přesný selektor doubao-seedance-2-5-260628 má vlastní dokumentovanou operaci a příklad. Tato operace popisuje generování videa, úpravy videa a prodlužování videa, s obrázky, videem, zvukem a textem jako vstupními médii. Reference použijte k předání vzhledu objektu, akce, pohybu kamery, stylu a zvuku a poté vysvětlete výsledek, který z nich chcete vytvořit.
Vstupní kombinace zahrnují samotný text, obrázky nebo video s volitelným textem, obrázky se zvukem, video se zvukem a obrázky, video a zvuk společně. Uvedené kombinace připojují zvuk k vizuálním médiím místo popisu požadavku pouze se zvukem. Uspořádejte každou položku podle její role: obrázek stanoví objekt nebo vzhled, video předvádí pohyb nebo existující scénu a zvuk poskytuje zvukovou referenci. Určete roli důležitou pro požadovaný záběr, aby reference pozadí nebyla zaměněna za hlavní postavu.
Konkrétní příklad 2.5 je produktová reklamní sekvence. Poskytuje obrázek a několik video referencí a poté popisuje úvodní ohnisko pozornosti, uspořádané rozmístění produktů, detailní záběry, zpomalenou akci a závěrečnou kompozici značky. Požadavek přiřazuje role reference_image a reference_video a používá jednotlivé reference pro kompozici, pohyb, práci kamery a působivost. Nabízí to praktickou strukturu pro koncept kampaně: naplánujte viditelné body děje, určete referenci pro každý z nich a stanovte závěrečné uspořádání.
Písemná sekvence může rozlišovat, co se děje a jak se to natáčí. Nejprve popište akci produktu a poté velikost záběru, trasu kamery, tempo a přechod k dalšímu pohledu. Pokud jedna reference definuje produkt a druhá předvádí pohyb kamery, pojmenujte tyto samostatné úlohy. U scény s několika předměty vysvětlete jejich polohy a pořadí interakcí. Zkontrolujte ve vygenerovaném výsledku skutečný tvar produktu, uspořádání a pohyb místo předpokladu, že každý referenční detail zůstane beze změny.
Při úpravě určete existující video a prvek k revizi, například prostředí, akci nebo vizuální styl, a současně uveďte návaznost, kterou je třeba zachovat. Při prodloužení popište, jak má scéna pokračovat z dodaného záznamu. Zkontrolujte spoj i novou část: vzhled objektu, směr pohybu, poloha kamery a časování zvuku ovlivňují, zda výsledek působí jako jedna scéna. Uchovejte původní video a dokončenou upravenou verzi společně, aby bylo možné změnu zkontrolovat proti zamýšlené návaznosti.
Dokumentovaný multimodální příklad 2.5 nastavuje generate_audio=true a žádá patnáctisekundovou sekvenci s kompozicí 16:9. Tyto hodnoty popisují daný příklad, nikoli univerzální strop délky nebo limit referenčních materiálů. Jasně určete zamýšlený zvuk požadované scény včetně vztahu mezi hudbou, efekty a viditelnou akcí a poté posuďte skutečný audiovizuální výstup. Zvukovou referenci a generovanou zvukovou stopu je třeba posoudit společně z hlediska zamýšleného tempa a provedení.
Vyberte délku, kompozici a rozlišení z nastavení nabízených pro tento přesný profil. Uchovejte požadovanou konfiguraci s promptem a porovnejte ji se skutečně vrácenými poli úlohy. Při přípravě hotového klipu pro cílové použití využijte vrácenou délku, rozlišení a poměr stran. V záznamu verze zachovejte přesný identifikátor profilu, aby pozdější srovnání používalo stejnou zvolenou edici.
Spotřeba tokenů videa se počítá jako (délka vstupního videa + délka výstupního videa) × výstupní šířka × výstupní výška × výstupní snímková frekvence / 1024. Požadavky obsahující vstupní video a požadavky bez vstupního videa mají samostatné účtovací kategorie. Dotaz na úlohu hlásí usage.completion_tokens a usage.total_tokens; uchovejte tyto hlášené veličiny spolu s dokončeným klipem.
Generování je asynchronní. Odeslání vrací identifikátor a nastavený průběh úlohy poskytuje stav a po úspěchu content.video_url. Uložte dokončený klip společně se zdrojovými médii a zadáním sekvence. Zkontrolujte v celém výsledku všechny naplánované body děje, interakce předmětů, vzhled postav, kompozici a sladění zvuku. Při revizi určete konkrétní nenaplněný detail a zachovejte úspěšné části scény místo nahrazení celého zadání nesouvisejícími pokyny.
Ailoot Ultra · Tvorba videa POST /v1/videos doubao-seedance-2-5-260628
doubao-seedance-2-5-260628Úvod
Seedance 2.5 vytváří video z textu a obrazových, video nebo zvukových referencí, s dokumentovanými postupy úprav a prodlužování. Jeho konkrétní příklad 2.5 kombinuje produktový obrázek s několika pohybovými referencemi a zapíná generovaný zvuk pro sladěnou reklamní sekvenci.
- Přijímané vstupy
- Text · Obrázky · Video · Zvuk
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Tvorba videa POST /v1/videos
- Vstup
text,image,video,audio- Výstup
video
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity doubao-seedance-2-5-260628 | Výchozí— |
Polecontent | Typarray | PožadavekPovinné | Hodnoty a limity Podmínky: Nativní textové a multimediální objekty; vnější pole musí být neprázdné. Tento obecný konstruktor Ailoot nekontroluje typy vnořených uzlů. | Výchozí— |
Polegenerate_audio | Typboolean | PožadavekVolitelné | Hodnoty a limity Podmínky: Příklad pro 2.5 nastavuje true, ale zkopírovaný popis volby uvádí pouze 2.0/fast/1.5; širší podpora nastavení ani výchozí hodnoty se nezaručují. | Výchozí— |
Poleduration | Typinteger | PožadavekVolitelné | Hodnoty a limity Podmínky: Doslovná hodnota 15 z příkladu pro 2.5 není maximum ani výchozí hodnota. | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: Zkopírované popisy neopravňují k odvození výchozí hodnoty ani výčtu pro 2.5. | Výchozí— |
Poleratio | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: Adaptive je výslovně omezeno na 2.0/fast/1.5; příklad pro 2.5 uvádí pouze 16:9. | Výchozí— |
Polewatermark | Typboolean | PožadavekVolitelné | Hodnoty a limity | Výchozífalse |
Poleseed | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: -1 Maximum: 4 294 967 295 | Výchozí-1 |
Poleexecution_expires_after | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: 3 600 Maximum: 259 200 Jednotka: sekundy | Výchozí172 800 |
Poleservice_tier | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: 2.0/fast vylučují offline flex; rozsah podpory pro 2.5 není stanoven. | Výchozí— |
Polesafety_identifier | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Kombinace vstupních materiálů
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktcontent, model |
Parametroptional | Kontraktgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier |
Parametrmaterial_types | Kontrakttext, image, video, audio |
Parametradditional_properties | Kontrakttrue |
Parametrvalidation_scope | KontraktAiloot kontroluje typy povinných polí, neprázdný model a neprázdné pole content. Ostatní pole požadavku se zachovávají pro vybraný model. |
Parametrmaterial_combinations | Kontrakttext, image, video, image, audio, image, video, video, audio, image, video, audio |
Parametroptional_text_with_media | Kontrakttrue |
Parametrreference_media_count_and_size_limits | Kontraktnull |
Aliasy metody: /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
Vytvořte pouze jednou a uchovejte vrácené veřejné id/polling_url.
Dotazujte se na původní úlohu; po dosažení stavu succeeded stáhněte skutečný obsah spravovaný službou z content.video_url.
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Účtovací jednotka | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceVstup obsahuje video. | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza 1K videotokenů | Poplatek Výstup · Odhad pouze pro srovnání $0.012 za 1K videotokenů |
| KonfiguraceVstup neobsahuje video. | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza 1K videotokenů | Poplatek Výstup · Odhad pouze pro srovnání $0.02 za 1K videotokenů |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.822402 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Tvorba 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
Přijímání a ukládání výsledků
Ailoot Ultra · Tvorba videa
Nativní JSON s veřejným id/polling_url. Po zveřejnění obsahuje content.video_url podepsané URL spravované službou Ailoot; před zveřejněním jsou vybrané výstupní URL prázdné.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Uchovejte každou skutečnou URL v content.video_url; index musí označovat skutečně vrácený výstup.
Pokud je nutné ověřit původní odpověď
Zachovejte původní odpověď, hlavičky a id a dotazujte se na tuto operaci; vytvoření s neznámým výsledkem nikdy znovu neodesílejte.
Pole odpovědi
| 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 další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNeplatný JSON/model, typy povinných polí nebo index obsahu. | Další krok |
Odpověď401 · authentication_error | PodmínkaNeplatný klíč API Ailoot. | Další krok |
Odpověď404 · not_found_error | PodmínkaÚloha či výstup chybí nebo nepatří stejnému uživateli, klíči API či skupině. | Další krok |
Odpověď502 · result_pending_check | PodmínkaPůvodní odeslání či stav jsou neúplné; zachovejte původní ID, znovu neodesílejte. | Další krok |
Odpověď503 · result_pending_check | PodmínkaPůvodní médium, trasa či vyúčtování se kontrolují; pokračujte v původní operaci. | Další krok |
Aliasy
Aliasy modelu
Ailoot Ultra doubao-seedance-2-5-260628
Aliasy cest metod
/v1/videos/generations
Související ID modelů
FAQ · ByteDance: Seedance 2.5
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·doubao-seedance-2-5-260628:text,image,video,audio→video- Jaká pole požadavek používá?
POST /v1/videos·doubao-seedance-2-5-260628:model,content,generate_audio,duration,resolution,ratio,watermark,seed,execution_expires_after,service_tier,safety_identifier- Jaké limity platí?
POST /v1/videos·doubao-seedance-2-5-260628:seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200