Přejít k obsahu
UlazAI

Dokumenty pro vývojáře UlazAI

Dokumentace Seedance API: generování, stav, 1080p a ceny

Ceny Dashboard Obrazové studio

Reference Seedance 1.5 Pro

Dokumenty Seedance API

Chcete-li použít Seedance API, ověřit pomocí nosného klíče, použít POST /seedance/generate/ vytvářet pracovní místa a provádět průzkumy GET /seedance/status/{generation_id}/ dokud nebude video připraveno. UlazAI aktuálně podporuje výstup Seedance 1.5 Pro 480p, 720p a 1080p s trváním 4, 8 nebo 12 sekund.

Základní koncové body

POST /seedance/upload/

POST /seedance/generate/

GET /seedance/status/{generation_id}/

Aktuální schopnosti

Text-to-video a image-to-video

Až 2 obrázky průvodce

Volitelný nativní zvuk

Další trasy

Koupit kredity

Viz Seedance přistání

Otevřete dokument kanonického videa API

Tip

Tato stránka odpovídá na úplný vývojářský postup na první obrazovce: generování koncového bodu, dotazování stavu, podpora 1080p, ověření nosiče a cenová cesta.

Použijte /seedance/upload/ pouze v případě, že potřebujete generování videa s obrázkem. Pro běhy pouze s textem volejte /seedance/generate/ přímo a přeskočte krok nahrávání.

Rodina modelů Seedance: 1.5 Pro, 2.0 a 2.5

Seedance je model od ByteDance pro převod textu na video a obrázek na video. ByteDance uvedl na trh první Seedance v červnu 2025, propuštěn Seedance 2.0 v únoru 2026 a od té doby se zobrazuje Seedance 2.5. Každý generace posouvá stejnou základní myšlenku dále: filmový pohyb, silnější prompt-sledující, vícenásobné scény, odkazy na obrázky a videa a volitelný nativní zvuk v jednom vykreslení. Průvodce API pokrývá aktuálně podporované Verze Seedance bez nutnosti nastavení vlastní platformy ByteDance.

VerzeVydal ByteDanceCo dodává
Seedance 1.5 Pro2025Převod textu a obrazu na video, až 2 průvodní obrázky, volitelný zvuk, 480p/720p/1080p. Dnes zapojeno do UlazAI.
Seedance 2.0únor 2026Multimodální vstupy (text, obrázek, video, zvuk), vyprávění příběhů z více kamer, nativní kogenerace zvuku, delší klipy.
Seedance 2.52026Nejnovější krok ByteDance ukázal, zaměřený na rychlejší generování a další zlepšení kvality a kontroly.

Stejný kód, novější model

UlazAI veřejné API generuje pomocí bytedance/seedance-1.5-pro dnes. Důležitá část pro vývojáře: když je zde povolena novější verze Seedance, znovu použije soubor stejné Auth nositele a stejné níže uvedené koncové body generování a hlasování. Vaše integrace se nemění – mění se pouze identifikátor modelu – ano můžete nyní stavět na tomto odkazu a posouvat rodinu později.

ByteDance a ARK: oficiální model, jedna jednotná trasa

Lidé hledající Oficiální dokumentace ByteDance Seedance nebo Ark Seedance API obvykle hledají dvě různé věci: samotný model a způsob, jak jej skutečně nazvat. Seedance patří ByteDance vlastní model, publikovaný prostřednictvím ByteDance's Volcano Engine ARK platforma. Ta cesta znamená zřízení ARK účet, přístup k regionu a koncové body nezpracovaného modelu.

UlazAI před tím sedí jako vrstva API třetí strany. dostaneš jeden klíč na doručitele, hostovaný nahrání obrázku krok, sdílená kreditní peněženka a malá sada koncových bodů na této stránce – žádný ARK onboarding, žádné regionální řešení a žádné VPN nebo čínské telefonní číslo pro spojení s modelem. Pokud jste konkrétně hledali Nahrání obrázku ARK API Seedance, ekvivalentem je zde jediné volání: POST /seedance/upload/ vrátí trvalou adresu URL, na kterou vstoupíte input_urls při generování (viz koncový bod nahrávání níže).

Koncepty ARK mapované na tento API

Pokud jste již četli dokumentaci ARK ByteDance, slovní zásoba je jiná, ale kroky jsou stejné. Toto je přímý překlad:

Na ByteDance ARK Tady Co se pro vás změní
Nastavení účtu ARK, projektu a koncového bodu Jeden klíč na doručitele Žádná platforma onboarding před prvním hovorem.
Hostujte obrázek průvodce sami, předejte veřejnou adresu URL POST /seedance/upload/ Můžete odeslat nezpracovaný soubor; odpověď vám poskytne trvalou adresu URL.
ID modelu v těle požadavku model pole Stejný nápad; mezi verzemi se mění pouze identifikátor.
Hlasujte o úkolu, dokud nebude dokončen GET /seedance/status/{generation_id}/ Stejný tvar dotazování, jeden koncový bod.

Převedení obrazu na video ve dvou hovorech

Toto je celý tok nahrávání obrázků. První volání uloží obrázek a vrátí URL, druhé volání používá tuto adresu URL jako vizuální vodítko pro video.

Jeden nahraný statický obrázek vlevo přivádí sekvenci generovaných snímků videa vpravo 
# 1. upload the guide image
curl -X POST https://ulazai.com/seedance/upload/ \
  -H "Authorization: Bearer $ULAZAI_API_KEY" \
  -F "[email protected]"

# -> {"url": "https://cdn.ulazai.com/uploads/<id>.jpg"}

# 2. generate, passing that URL back in input_urls
curl -X POST https://ulazai.com/seedance/generate/ \
  -H "Authorization: Bearer $ULAZAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "slow dolly in, warm evening light",
        "input_urls": ["https://cdn.ulazai.com/uploads/<id>.jpg"],
        "resolution": "1080p"
      }'

Můžete předat až dvě adresy URL input_urls. Dva obrázky se čtou jako začátek a koncová reference, což je obvyklý způsob, jak zachovat konzistentnost znaku nebo produktu napříč celým serverem klip. Chcete-li generovat pouze text, zcela přeskočte volání nahrávání.

Rychlé shrnutí integrace

Auth Nosič API klíč od /dashboard/ -> Klávesy API
ID modelu bytedance/seedance-1.5-pro
Doba trvání 4s, 8s, 12s
Usnesení 480p, 720p, 1080p
Poměry stran 1:1, 21:9, 4:3, 3:4, 16:9, 9:16
Vstupy Pouze Prompt nebo prompt plus až 2 adresy URL obrázků
Průběh dotazování Vytvořit zakázku, uložit generation_id, poté stav hlasování do completed

Veřejné shrnutí koncového bodu

Metoda Koncový bod Kdy ji použít
POST /seedance/upload/ Nejprve nahrajte obrázek, chcete-li navádění z obrázku na video
POST /seedance/generate/ Vytvořte úlohu generování Seedance 1.5 Pro
GET /seedance/status/{generation_id}/ Zkontrolujte, zda se úloha stále zpracovává, zda je dokončena nebo zda se nezdařila

Autentizace

Všechny požadavky API vyžadují token nosiče:

Authorization: Bearer YOUR_API_KEY

Získejte klíč API z palubní desky pod Klíče API. Pokud stále potřebujete kredity, přejděte na balíčky první.

POST /seedance/upload/

Nahrajte vstupní obrázky pro navádění z obrázku na video

Pokud chcete, aby Seedance ukotvila kompozici, orámování postavy nebo nastavení scény, nahrajte před generováním obrázek průvodce. Odpověď vám poskytne trvalou adresu URL, do které můžete přejít input_urls.

Záhlaví požadavku

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Parametry dat formuláře

soubor * (soubor)

JPG, PNG nebo WebP, až 10 MB.

Úspěšná odpověď (200)

{
  "success": true,
  "url": "https://media.ulazai.com/seedance_images/u1_abc123.jpg",
  "filename": "seedance_images/u1_abc123.jpg"
}

Příklad použití (cURL)

curl -X POST https://api.ulazai.com/seedance/upload/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/image.jpg"
POST /seedance/generate/

Vytvořte úlohu generování Seedance 1.5 Pro

Pošlete buď zjednodušený náklad níže, nebo explicitní model plus input formát. Pokud potřebujete pouze veřejnou trasu Seedance se prompt, volitelnými obrázky průvodce a nastavením výstupu, použijte zjednodušenou verzi.

Tělo požadavku (jednoduché)

{
  "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
  "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "duration": "4",
  "fixed_lens": true,
  "generate_audio": false,
  "prompt_directory_optin": true
}

Tělo požadavku (model/styl vstupu)

{
  "model": "bytedance/seedance-1.5-pro",
  "input": {
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": "8",
    "fixed_lens": true,
    "generate_audio": true
  }
}

Parametry

prompt * (řetězec)

3 až 2500 znaků popisujících scénu, pohyb, orámování a zvukový záměr.

input_urls (pole)

Volitelné. Až 2 adresy URL obrázků pro navádění mezi obrázky a videem.

aspect_ratio (řetězec)

Jeden z: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.

rozlišení (řetězec)

Jeden z: 480p, 720p, 1080p.

trvání (řetězec)

4, 8 nebo 12 sekund.

fixed_lens (logická hodnota)

Aktivujte pro stabilnější pohled kamery.

generate_audio (logická hodnota)

Povolit synchronizované generování zvuku. To zvyšuje využití kreditu.

prompt_directory_optin (logická hodnota)

Volitelné. Sdílejte způsobilé prompt do adresáře prompt a aplikujte slevu, pokud je podporována.

Úspěšná odpověď (200)

{
  "success": true,
  "generation_id": "abc12345-1234-1234-1234-123456789012",
  "task_id": "seedance_task_xyz789",
  "credits_used": 40,
  "directory_discount_applied": true,
  "message": "Video generation started. This may take a few minutes."
}
GET /seedance/status/{generation_id}/

Stav úkolu ankety

Dotazujte se na tento koncový bod, dokud úloha neopustí processing. Po úspěchu získáte zpět adresu URL videa; na selhání měli byste chybu zkontrolovat a zkusit to znovu s opraveným nákladem.

Zpracování odezvy

{
  "success": true,
  "status": "processing",
  "message": "Video is being generated..."
}

Úspěšná odpověď (200)

{
  "success": true,
  "status": "completed",
  "video_url": "https://media.ulazai.com/seedance_outputs/video.mp4"
}

Příklady kódu: cURL, Python a JavaScript

Celý proces je odeslat → uložit generation_id → stav ankety. Zde je volání generování ve třech společných hromadách; zaměňte svůj vlastní klíč a prompt.

cURL

curl -X POST https://api.ulazai.com/seedance/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "4"
  }'

Python (požadavky)

import time, requests

BASE = "https://api.ulazai.com"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

# 1. Start the job
job = requests.post(f"{BASE}/seedance/generate/", headers=HEADERS, json={
    "prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
    "aspect_ratio": "16:9",
    "resolution": "1080p",
    "duration": "4",
}).json()
generation_id = job["generation_id"]

# 2. Poll until it leaves "processing"
while True:
    status = requests.get(f"{BASE}/seedance/status/{generation_id}/", headers=HEADERS).json()
    if status.get("status") == "completed":
        print("Video:", status["video_url"])
        break
    if status.get("status") == "failed":
        raise RuntimeError(status)
    time.sleep(8)  # back off; do not hammer generate

JavaScript (načtení)

const BASE = "https://api.ulazai.com";
const HEADERS = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const job = await fetch(`${BASE}/seedance/generate/`, {
  method: "POST",
  headers: HEADERS,
  body: JSON.stringify({
    prompt: "A cinematic close-up of a chef flipping noodles in slow motion",
    aspect_ratio: "16:9",
    resolution: "1080p",
    duration: "4",
  }),
}).then(r => r.json());

const id = job.generation_id;
let video;
while (!video) {
  const s = await fetch(`${BASE}/seedance/status/${id}/`, { headers: HEADERS }).then(r => r.json());
  if (s.status === "completed") video = s.video_url;
  else if (s.status === "failed") throw new Error(JSON.stringify(s));
  else await new Promise(r => setTimeout(r, 8000));  // poll every ~8s
}
console.log("Video:", video);

Tok použití

  1. Nahrajte jeden nebo dva vodicí obrázky pomocí /seedance/upload/ pouze v případě, že potřebujete vedení z obrázku do videa.
  2. Zavolejte /seedance/generate/ s vaším prompt, nastavením výstupu a volitelně input_urls.
  3. Vrácené zboží uschovejte generation_id.
  4. Anketa /seedance/status/{generation_id}/ dokud status se stává completed.
  5. Použijte vrácené video_url ke stažení, vložení nebo předání konečného aktiva do vašeho vlastního pracovního postupu.

Chybové kódy

400 Neplatné parametry požadavku

401 Ověření se nezdařilo (chybějící nebo neplatný klíč API)

402 Nedostatek kreditů

429 Překročen limit sazby

500 Interní chyba serveru

Cenové a sazbové limity

Účtování Seedance na UlazAI běží na kredity, takže náklady se škálují s rozlišením a dobou trvání spíše než s pevnou sazbou za sekundu. Použijte jej jako průvodce plánováním; cena živého kreditu je uvedena v balíčky a na vyžádání čas.

VýstupTypické použitíNákladový řidič
480pNávrhy a rychlé iteraceNejnižší kredity za sekundu
720pSpolečenské klipyStřední kredity za sekundu
1080pKonečná dodávkaNejvyšší kredity za sekundu; delší trvání stojí více

Limity sazeb a zpracování 429: pokud odešlete mnoho úloh souběžně, můžete obdržet 429 Rate limit exceeded. Zacházejte se API jako se zaměstnáním: odešlete, uložte generation_ida anketa /seedance/status/{generation_id}/ každých 5-10 sekund, spíše než generování kladivem. Na a 429, ustupte exponenciálně (například 2 s, 4 s, 8 s), než to zkusíte znovu.

Seedance 1.5 pro vs Seedance 2.0: tento odkaz pokrývá bytedance/seedance-1.5-pro, model aktuálně zapojený do Video Studia. ByteDance od té doby představil Seedance 2.0 jako další generaci; když je zde povoleno, používá stejný tok generování a dotazování a stejné ověřování, takže integrační kód se nemění – mění se pouze identifikátor modelu.

Často kladené otázky

Podporuje UlazAI Seedance API Seedance 2.0 a 2.5?

API generuje s bytedance/seedance-1.5-pro dnes. ByteDance vydal Seedance 2.0 v únoru 2026 a od té doby ukázal 2.5. Když je zde povolena novější verze, používá stejné ověření nosiče a stejné koncové body generování a dotazování, takže váš integrační kód se nezmění – změní se pouze identifikátor modelu.

Jak souvisí UlazAI s oficiální Seedance / ARK API ByteDance?

Seedance je vlastní model ByteDance nabízený prostřednictvím platformy Volcano Engine ARK od ByteDance. UlazAI je vrstva API třetí strany, která provozuje Seedance na jedné zjednodušené trase s jedním Bearer klíčem, hostovaným nahráváním obrázků a sdílenou kreditní peněženkou – žádný ARK účet nebo nezpracované koncové body ke správě.

Jak mohu nahrát obrázek pro Seedance image-to-video?

Odeslat obrázek jako multipart/form-data na POST /seedance/upload/ s vaším klíčem doručitele. Odpověď vrátí trvalou adresu URL; předat to (až dva) v input_urls pole zapnuto POST /seedance/generate/. Pouze textové prompt přeskočí krok nahrávání.

Kolik stojí Seedance API?

Fakturace běží na kredity, takže náklady se přizpůsobují rozlišení a trvání. Krátký návrh 480p stojí nejméně kreditů; nejvíce stojí 12sekundový 1080p render se zvukem. Přesná cena je uvedena v balíčky a znovu jako credits_used ve generování odpovědi.

Je Seedance k dispozici celosvětově prostřednictvím API?

Ano. Hostované koncové body HTTPS UlazAI voláte pomocí nosného klíče, takže není potřeba žádná VPN, regionální řešení ani čínské telefonní číslo. Každý server, který může provést ověřený požadavek HTTPS, může odesílat úlohy a dotazovat se na výsledky.

Kam dál

Koupit kredity Přistání Seedance 1.5 Pro Cena Seedance 2 Video dokumenty API Referenční index API Otevřete Seedance ve Video Studiu