modely

ByteDance: Seedance 2.0

Markdown · JSON

ByteDance: Seedance 2.0

ByteDance Seedance 2.0 spojuje nativní generování zvuku a videa s obrazovými, video a zvukovými referencemi. Režírujte nové scény, upravujte existující záznam nebo prodlužujte sekvenci; standardní verze zahrnuje dokumentovaný výstup 1080p a 10bitový 4K.

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.0 je standardní model ByteDance Seed pro multimodální tvorbu zvuku a videa. Spojuje text, obrázky, videa a zvuk v architektuře společného generování, se samostatnými tvůrčími postupy pro scény vedené referencemi, úpravy a prodlužování videa. Hodí se tam, kde zadání potřebuje souvislý výkon i konkrétní vizuální nebo zvukové informace z připravených materiálů.

Multimodální reference a režijní ovládání

Obrázky mohou definovat vzhled objektu, vizuální styl a kompozici. Video reference mohou vést akci, pohyb kamery a efekty. Zvuk může řídit barvu hlasu, hudbu nebo dialog. Definujte roli každého materiálu a potom popište scénu, která má vzniknout. Výrobce zdůrazňuje ovládání přednesu, osvětlení, stínů a kamerového jazyka.

Pro produktový příběh připravte obrázek produktu, referenci pohybu kamery a zvukový pokyn. Zadání může znít: „Zachovej modrou skleněnou vázu z Image 1. Použij pomalý boční pojezd z Video 1. Váza stojí na sluncem osvětlené polici a zní jemná instrumentální hudba podle Audio 1.“ Zamýšleným výstupem je nově inscenovaná scéna spojující vybrané referenční informace.

Referenční vstupy mohou kombinovat obraz a zvuk, obraz a video, video a zvuk nebo všechny tři. Samotný zvuk a text se zvukem bez obrázku či videa nejsou podporovány. Dokumentovány jsou také tradiční převod textu na video, generování z prvního snímku a z prvního i posledního snímku. Jsou-li důležité pevné počáteční a koncové kompozice, použijte vyhrazený postup koncových bodů: označení referenčního obrázku jako koncového bodu v omni-reference zadání je pouze nepřímým vedením.

Úprava záznamu

Model může nahradit objekt, přidat nebo odstranit předměty, změnit prvky a překreslit či opravit části videa. Popište konkrétní změnu a identifikujte zdrojový záznam. U přidání zahrňte čas a polohu výskytu; u odstranění nebo nahrazení určete objekt přesně a pojmenujte, co má zůstat.

Například: „Nahraď stolní lampu ve videu Video 1 mosaznou lampou z Image 1. Zachovej pohyb kamery, uspořádání stolu a směr osvětlení.“ Požadovaným výsledkem je upravená verze scény se zamýšlenou náhradou. Zkontrolujte nezměněné oblasti i nový objekt, zvláště při zakrývání, pohybu a změnách záběru.

Prodlužování a spojování sekvence

Seedance 2.0 může prodloužit video dopředu nebo dozadu a propojit až tři dodané klipy generovanými přechody. Určete časový směr a novou událost. U spojovacího úseku seřaďte klipy a popište přechod mezi každou dvojicí, například kameru vstupující v jednom záběru do dveří a přicházející do dalšího prostředí.

Jednoduché prodloužení obvykle vrací pokračování rozvinuté kolem zdrojového záznamu; pokud má konečný výsledek také zopakovat původní segment, zahrňte jasný pokyn. Při dokončování spojení dvou či tří klipů může dokumentovaný postup zahrnout původní materiál i nový přechodový obsah. To se hodí pro rozvíjení začátku nebo konce či propojení připravených scén bez neurčité spojovací akce.

Výstup standardní verze a 4K

Standardní verze dokumentuje MP4 při 24 fps a délky od 4 do 15 sekund. Výstupní úrovně jsou 480p, 720p a 1080p s 8bitovou barevnou hloubkou a 4K s 10bitovou barevnou hloubkou. Podporované poměry jsou 21:9, 16:9, 4:3, 1:1, 3:4 a 9:16. Dokumentovány jsou také adaptivní rámování a automatická volba délky. Verze Fast má vlastní užší specifikaci výstupu 480p/720p.

Výstup 4K používá kódování H.265/HEVC. Desetibitové kódování zachovává další tonální stupně a plynulejší barevné přechody, což je důležité u materiálu s jemnými světelnými či barevnými gradienty. Ověřte, že zamýšlené přehrávací a editační prostředí umí tento formát dekódovat; některé prohlížeče a zařízení jej přímo nepřehrají. Kompatibilní kontejner sám nezaručuje kompatibilní dekódování videa.

Model může generovat synchronizovaný zvuk nebo tiché video a vrátit poslední generovaný snímek pro následující scénu. Generovaný zvuk je monofonní. Rodina 2.0 nepodporuje samostatný dvoufázový režim náhledu Draft, takže tuto náhledovou funkci nelze odvozovat od jiné verze Seedance.

Příprava referencí a podstatná omezení

Dokumentovaná referenční kapacita je až devět obrázků, tři videa a tři zvukové klipy. Přímé nahrávání referenčních obrázků nebo videí se skutečnými lidskými tvářemi není v tomto dokumentovaném profilu výrobce přijímáno; portrétní práce používá podporovaný postup portrétních podkladů. Každý video i zvukový klip musí mít délku 2–15 sekund. Všechny video reference dohromady se musí vejít do 15 sekund a všechny zvukové reference mají vlastní celkový limit 15 sekund. Video soubory používají MP4 nebo MOV při 24–60 fps, do 200 MB na soubor; zvukové soubory používají WAV nebo MP3, do 15 MB na soubor. Uvedené obrazové formáty jsou JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC a HEIF. Obrázky musí být jednotlivě menší než 30 MB a tělo požadavku nesmí překročit 64 MB. V dokumentovaném profilu referenčních vstupů musí šířka i výška obrázku ležet přísně mezi 300 a 6 000 pixely, s poměrem šířky k výšce přísně mezi 0,4 a 2,5. Referenční videa umožňují 300–6 000 pixelů v každém rozměru a poměry 0,4–2,5 včetně, s celkem 407 696–8 295 044 pixely. Videa MP4 nebo MOV používají obraz H.264/AVC nebo H.265/HEVC a zvuk AAC nebo MP3.

Soubory záměrně seřaďte a odkazujte na každý typem média a číslem: Image 1, Video 1 a Audio 1. Číslo sleduje pořadí mezi soubory daného typu. Vysvětlete, které rysy přenést a který zdrojový obsah nemá definovat novou scénu. Dokumentované jazyky zadání zahrnují angličtinu, španělštinu, indonéštinu, portugalštinu a japonštinu. Mluvený jazyk v dialogu udržujte jednotný; příručka doporučuje nemíchat jazyky s výjimkou vlastních jmen. U práce vedené hlasem oddělte mluvčího, přesnou repliku a pokyn k přednesu.

První a poslední obrázek připravte s kompatibilním rámováním. Nesoulad vstupního obrázku a výstupních rozměrů může způsobit ořez nebo náhlou vizuální změnu; shodné rozměry a adaptivní rámování jsou dokumentovaná řešení. Popis soustřeďte na událost a role referencí. Výrobce varuje, že dlouhé prompty mohou rozptýlit informace a vést k ignorování podrobností. Výsledný pohyb, návaznost referencí, zvukové provedení a spoje mezi scénami kontrolujte jako samostatné části tvůrčího výsledku.

Plánování záběrů a vedení textu

U složité scény uspořádejte zadání jako Shot 1, Shot 2 a Shot 3 a postupně určete kameru, akci objektu, polohu a zvuk. Příručka doporučuje jeden pohyb kamery na záběr a upřednostnění pomalých navazujících akcí. Přesné časové značky jednotlivých záběrů jsou nestabilní, proto je pořadí událostí lepším ovládáním než vynucování několika přesných časových oken.

Model generuje také běžný text včetně sloganů, titulků a komiksových bublin. Lze řídit barvu, vizuální zpracování, umístění a nástup textu. Používejte běžné znaky místo vzácných znaků či zvláštních symbolů a kontrolujte znění za pohybu. U referencí objektů jasně přiřaďte každý podklad zamýšlené postavě nebo předmětu. Pohledy na produkt mohou dodat různé vizuální informace; koláže postavy z více stran mohou mást identitu tváře. Dokumentovaným doporučením pro referenci postavy je samostatný jasný portrét hlavy a snímek celé postavy.

Chování ke kontrole před střihem

Příručka dokumentuje nežádoucí titulky, loga, duplicitní postavy a odchylky stylu. Čisté zdrojové materiály, jednotná označení a výslovná omezení tato rizika snižují, ale nezaručují vymizení nežádoucího textu nebo duplicitních postav. Více než čtyři referenční osoby je uváděno jako riziko stability, odlišné od počtu přijímaných souborů.

Prodlužování videa může ve spoji vytvořit skok nebo návrat a opakovaná pokračování mohou kumulovat zhoršení kvality obrazu. Zkontrolujte hraniční snímky a omezte navrstvená prodloužení. Referenční hlas se může lišit od zdrojové barvy; vyprávění může skončit cvaknutím či náhlým utnutím, pro které je dokumentovaným řešením zvukové ztišení. Čínské znaky s více výslovnostmi, neobvyklé znaky nebo podobně tvarované znaky mohou být vysloveny chybně. U přesného animovaného efektu, například odpočítávání, je pohybová reference informativnější než samotný slovní požadavek. To jsou konkrétní důvody kontrolovat při výběru klipu zvlášť identitu, text, pohyb a zvuk.

Ailoot Ultra · Video POST /v1/videos bytedance/seedance-2.0

bytedance/seedance-2.0

ByteDance /bytedance/seedance-2.0

Úvod

ByteDance Seedance 2.0 spojuje nativní generování zvuku a videa s obrazovými, video a zvukovými referencemi. Režírujte nové scény, upravujte existující záznam nebo prodlužujte sekvenci; standardní verze zahrnuje dokumentovaný výstup 1080p a 10bitový 4K.

Přijímané vstupy
Text · Obrázky · Zvuk
Výsledky
Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Video POST /v1/videos
Vstup
text, image, audio
Výstup
video
Výstupní formát
původní bajty MP4; bez normalizace a překódování
PoleTypPožadavekHodnoty a limityVýchozí
PolemodelTypstringPožadavekPovinnéHodnoty a limity
bytedance/seedance-2.0
Výchozí—
PolepromptTypstringPožadavekPovinnéHodnoty a limityVýchozí—
PoledurationTypintegerPožadavekPovinnéHodnoty a limity
4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Výchozí—
PoleresolutionTypstringPožadavekVolitelnéHodnoty a limity
480p, 720p, 1080p, 4K
Výchozí—
Poleaspect_ratioTypstringPožadavekVolitelnéHodnoty a limity
1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21
Výchozí—
Polegenerate_audioTypbooleanPožadavekVolitelnéHodnoty a limity
false, true
Podmínky: U 480p a 720p vynechání generate_audio zvolí cenu se zvukem, zatímco false zvolí cenu bez zvuku. U 1080p a 4K platí cena daného rozlišení pro obě nastavení. Přítomnost vrácené zvukové stopy ověřte v poli has_audio výsledku.
Výchozí—
Poleframe_imagesTyparrayPožadavekVolitelnéHodnoty a limity
Minimální počet položek: 1
Maximální počet položek: 2
Vstupní obsah: Pole objektů snímků. Každý obsahuje type=image_url, image_url obsahující url a frame_type=first_frame nebo last_frame. Každá role se smí vyskytnout nejvýše jednou. Používejte veřejné HTTPS URL.
Přesné klíče: type, image_url, frame_type
Podmínky: Tyto klíče platí pro každý objekt snímku. Pro požadavek obsahující pouze text vynechte frame_images.
Výchozí—
Poleinput_referencesTyparrayPožadavekVolitelnéHodnoty a limity
Vstupní obsah: Pole objektů obrazových nebo zvukových referencí. Nastavte type na image_url nebo audio_url a zadejte odpovídající objekt URL obsahující url. Video reference stále nelze ocenit.
Podmínky: Pro režim referencí vynechte frame_images. Používejte veřejné HTTPS URL.
Výchozí—
PolesizeTypstringPožadavekVolitelné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]*$
Výchozí—
PoleseedTypintegerPožadavekVolitelnéHodnoty a limity
Minimum: -9 223 372 036 854 775 808
Maximum: 9 223 372 036 854 775 807
Výchozí—
Polecallback_urlTypstringPožadavekVolitelnéHodnoty a limity
Vzor: ^https://
Výchozí—
Polesession_idTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
PoletraceTypobjectPožadavekVolitelnéHodnoty a limityVýchozí—
PoleuserTypstringPožadavekVolitelnéHodnoty a limityVýchozí—
Kombinace vstupních materiálů

Text na video · Textové zadání. · Povinné: model, prompt, duration

Zadejte textové zadání a podporovanou délku v celých sekundách. Použijte přesnou uvedenou velikost nebo rozlišení a poměr stran, které odpovídají uvedeným rozměrům.

model: Typ: string · bytedance/seedance-2.0

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Obrázek na video · Textové zadání a obrázek snímku. · Povinné: model, prompt, duration, frame_images

frame_images je pole objektů s type=image_url, image_url obsahujícím url a frame_type. Použijte veřejnou HTTPS URL obrázku; first_frame i last_frame se smí vyskytnout každý jednou. Použijte uvedenou velikost výstupu nebo kompatibilní rozměry. Nepřidávejte video reference.

Přesné klíče: type, image_url, frame_type

model: Typ: string · bytedance/seedance-2.0

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Reference to video · Textové zadání a obrazové nebo zvukové reference. · Povinné: model, prompt, duration, input_references

input_references je pole. Každý objekt obsahuje type=image_url nebo type=audio_url a odpovídající objekt URL obsahující url. Používejte veřejné HTTPS odkazy. Vynecháním frame_images zvolíte režim referencí. Video reference nelze ocenit.

model: Typ: string · bytedance/seedance-2.0

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Parametry a životní cyklus metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt, duration
Parametrmaterial_typesKontrakttext, image, audio
Parametradditional_propertiesKontraktfalse
Parametroptional_controlsKontraktresolution, 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

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.

KonfiguraceTabulka sazebPředpokládané množstvíÚčtovací jednotkaPodmínky účtováníPoplatek
KonfiguraceZákladní sazby za tokenyTabulka sazebZákladní sazbaPředpokládané množství—Účtovací jednotka—Podmínky účtování—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ů
KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.Poplatek
Výstup · Cena tokenu videa · Odhad pouze pro srovnání $0.014 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtováníresolution: 1080pPoplatek
Výstup · Cena tokenu videa · Odhad pouze pro srovnání $0.0154 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtovánívstup: with_video_input; rozlišení: 1080pPoplatek
reference · Cena tokenu videa · Odhad pouze pro srovnání $0.0094 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtováníresolution: 4kPoplatek
Výstup · Cena tokenu videa · Odhad pouze pro srovnání $0.008 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtovánívstup: with_video_input; rozlišení: 4kPoplatek
reference · Cena tokenu videa · Odhad pouze pro srovnání $0.0048 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtovánívstup: with_video_inputPoplatek
reference · Cena tokenu videa · Odhad pouze pro srovnání $0.0086 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaTabulka sazeb—Předpokládané množství—Účtovací jednotkaza 1K videotokenůPodmínky účtovánízvuk: without_audioPoplatek
Výstup · Cena tokenu videa · Odhad pouze pro srovnání $0.014 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceOdhadovaná cena generováníTabulka sazeb—Předpokládané množstvíodhad pro jedno generováníÚčtovací jednotka—Podmínky účtování—Poplatek
Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.3024 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í →

Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové reference konfigurací videa

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.

KonfiguracePodmínky účtováníPoplatek
KonfiguraceCena tokenu videaPodmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.Poplatek
Výstup · Cena tokenu videa $0.014 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaPodmínky účtováníresolution: 4kPoplatek
Výstup · Cena tokenu videa $0.008 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaPodmínky účtováníresolution: 1080pPoplatek
Výstup · Cena tokenu videa $0.0154 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaPodmínky účtovánízvuk: without_audioPoplatek
Výstup · Cena tokenu videa $0.014 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaPodmínky účtovánívstup: with_video_inputPoplatek
reference · Cena tokenu videa $0.0086 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaPodmínky účtovánívstup: with_video_input; rozlišení: 4kPoplatek
reference · Cena tokenu videa $0.0048 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

KonfiguraceCena tokenu videaPodmínky účtovánívstup: with_video_input; rozlišení: 1080pPoplatek
reference · Cena tokenu videa $0.0094 za 1K videotokenů

Sazba za video tokeny je hlavní cenovou referencí. Orientační odhady za sekundu jsou samostatné reference, nikoli další poplatek.

Příklady požadavků

Ailoot Ultra · Video

curl · vytvořte 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

Přijímání a ukládání výsledků

Ailoot Ultra · Video

podepsané URL obsahu spravovaného službou

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Ověřit stav úlohy
Získat stav původní operace pomocí GET
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
Další načtení obsahu
Uložte každý dokončený výstup, který vám patří
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
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ždý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.

Pokud je nutné ověřit původní odpověď

503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte

Pole odpovědi
PoleTypVýznam
PoleindexTypintegerVýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly.
Polecontent_urlTypstringVýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa.
Polesha256Typstring | nullVýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný.
Polesize_bytesTypinteger | nullVýznamVelikost původního videosouboru v bajtech; null, není-li dostupná.
Poleduration_msTypinteger | nullVýznamNaměřená délka videa v milisekundách; null, není-li dostupná.
PolewidthTypinteger | nullVýznamŠířka videa v pixelech; null, není-li dostupná.
PoleheightTypinteger | nullVýznamVýška videa v pixelech; null, není-li dostupná.
Polevideo_codecTypstring | nullVýznamIdentifikátor video kodeku; null, není-li zaznamenán.
Polehas_audioTypboolean | nullVýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno.
Poleaudio_codecTypstring | nullVýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán.
Chyby a další kroky
OdpověďPodmínkaDalší krok
Odpověď404 · not_found_errorPodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno.Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.
Odpověď401 · authentication_errorPodmínkaKlíč API neodpovídá ověřenému účtu.Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu.
Odpověď400 · invalid_request_errorPodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný.Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.
Odpověď422 · price_unavailablePodmínkaVybranou konfiguraci videa nelze ocenit.Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.
Odpověď422 · invalid_request_errorPodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné.Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.
Odpověď402 · billing_errorPodmínkaDostupný zůstatek nebo limity neumožňují rezervaci.Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.
Odpověď503 · server_errorPodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.
Odpověď503 · result_pending_checkPodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.
Odpověď503 · owned_result_unavailablePodmínkaStávající video je dočasně nedostupné ke stažení.Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.
Odpověď409 · video_not_readyPodmínkaObsah videa nebyl zveřejněn.Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.

Aliasy

Aliasy modelu

Ailoot Ultra bytedance/seedance-2.0

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

bytedance/seedance-2.0

FAQ · ByteDance: Seedance 2.0
Jaké vstupy a výsledky jsou dostupné?

POST /v1/videos · bytedance/seedance-2.0: text, image, audio → video

Jaká pole požadavek používá?

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

Jaké limity platí?

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

Další podrobnosti

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné
Pro pravidelné požadavky vyberte tarif se slevou.
Promo kód až 50%
Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.
Výdaje v historii
U každého požadavku se uloží model, tokeny a částka.

Vybrat předplatné · Zobrazit ceny modelů

Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace
Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.
Licence pro přeprodejce
Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.
Dokumenty na webu
Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

Požádat o licenci přeprodejce · Nabídka a licenční smlouva