Seedance 2.0 Mini

Schopnosti a funkce

Ceny a kredity

Generování videa je zpoplatněno kredity na základě účtované délky v sekundách. Bez video vstupu odpovídá účtovaná délka délce výstupu. Pokud video vstup zadáte, započítává se do ní také délka referenčního videa.

V tabulce níže jsou uvedeny kredity účtované za sekundu, nikoli celková cena za úkol. Sazba závisí na modelu, výstupním rozlišení a na tom, zda v režimu reference-to-video zadáte referenční videa. Výpočet celkové ceny najdete ve vzorcích a příkladech pod tabulkou.

• Bez video vstupu: sekundy výstupu × sazba bez videa.
• S video vstupem: (sekundy výstupu + naměřené sekundy referenčního videa) × sazba s videem. Server změří celkovou délku referenčního videa a před zaúčtováním ji zaokrouhlí nahoru na celé sekundy.
• Samostatné obrázkové nebo zvukové reference využívají sazbu bez videa. Sazba za referenční video se uplatňuje pouze v režimu reference-to-video, pokud jsou skutečně dodány video reference.

Kredity jsou rezervovány při odeslání požadavku a strženy při úspěšném dokončení. Selhané nebo vypršené úlohy jdou do procesu vrácení peněz (refundace). Stav účtování refund_failed znamená, že se vrácení kreditů nedokončilo; zkontrolujte protokoly API nebo kontaktujte podporu.

Ověření

Vytvořte si API klíč v administraci. Celý klíč se zobrazí pouze jednou. Uložte si ho na svém serveru a posílejte ho jako Bearer token v každém požadavku.

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Před spuštěním těchto příkladů nastavte proměnnou prostředí SEEVIO_API_KEY. Příklady v JavaScriptu běží na vašem serveru v prostředí Node.js; příklady v Pythonu používají knihovnu requests.

Rychlý start

Odešlete tento minimální požadavek, uložte si vrácené taskId a poté použijte níže uvedený příklad dotazu na stav úlohy. Hodnota credits v odpovědi na vytvoření představuje rezervovanou částku.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

Příklad odpovědi při vytvoření úlohy

Jakmile je výše uvedený požadavek přijat, API vrátí tuto odpověď ve formátu JSON. Hodnota taskId představuje identifikátor úlohy, který slouží k následnému dotazování na její stav. credits udává počet kreditů rezervovaných pro tuto úlohu. Tato odpověď pouze potvrzuje úspěšné vytvoření úlohy, nikoli to, že je video již hotové. Pro získání výsledného videa je nutné stav úlohy pravidelně kontrolovat (polling) nebo využít Webhook.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 30
}

Vytvoření úlohy

Odešlete objekt JSON obsahující model a input, případně volitelnou callback_url. Vždy uveďte přesné ID modelu uvedené na této stránce; při vynechání modelu se vybere seedance-2-0.

Tělo požadavku

Vstupní parametry

Zadejte parametry image_urls, video_urls a audio_urls jako pole řetězců s URL (string[]). Každá zadaná URL musí být veřejně přístupná přes protokol HTTPS, a to včetně médií, která vybraný režim ignoruje.

Booleovská pole musí mít hodnotu JSON true nebo false, nikoli řetězec nebo číslo.

Odpověď na vytvoření

HTTP 200 vrací taskId (řetězec) a credits (číslo). Potvrzuje se tím vytvoření úlohy, nikoli její dokončení. Částka níže odpovídá 5sekundovému rychlému startu v rozlišení 720p.

{
  "taskId": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "credits": 30
}

Režimy generování a příklady

Text na video

Generování na základě textového zadání. Adresy URL médií se v tomto režimu nepředávají.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'

První snímek

Zadejte jeden obrázek jako první snímek a v promptu popište požadovaný pohyb.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg"
    ],
    "aspect_ratio": "adaptive"
  }
}'

První a poslední snímek

Zadejte dvě URL adresy obrázků v pořadí: první snímek, poté poslední snímek. Tento příklad také vyžaduje vrácení posledního snímku vygenerovaného videa.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "image-to-video",
    "image_urls": [
      "https://example.com/first-frame.jpg",
      "https://example.com/last-frame.jpg"
    ],
    "aspect_ratio": "adaptive",
    "return_last_frame": true
  }
}'

Multimodální reference

Kombinujte obrázkové, video a audio reference. Prompt je i nadále vyžadován. Vstup v podobě referenčního videa mění výpočet ceny.

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "Follow the reference camera movement and keep the character consistent. Use the audio for ambience.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "image_urls": [
      "https://example.com/character.jpg"
    ],
    "video_urls": [
      "https://example.com/camera.mp4"
    ],
    "audio_urls": [
      "https://example.com/ambience.mp3"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Dotaz na stav úlohy

Nahraďte ukázkové ID za taskId vrácené při vytvoření. Dotazy vracejí pouze úlohy patřící uživateli daného API klíče; nepřístupná nebo neznámá ID vrací HTTP 404.

Jako výchozí bod se dotazujte každých 10–20 sekund, při chybě HTTP 429 frekvenci snižte a dotazování ukončete, jakmile je stav completed nebo failed. V produkčním prostředí dejte přednost webhookům. Každá ukázka kódu níže provede jeden dotaz.

curl --fail-with-body https://api.seevio.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer $SEEVIO_API_KEY"

Dokončená úloha: odpověď na dotaz s výsledným videem

Pokud dotaz vrátí status=completed, generování videa bylo dokončeno. Adresy URL videa si přečtěte v data.results a stáhněte si je před vypršením času v data.video_expires_at. billing_status=charged znamená, že vyhrazené kredity byly naúčtovány.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "completed",
  "billing_status": "charged",
  "credits": 30,
  "failed_reason": null,
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Neúspěšná úloha: odpověď na dotaz s podrobnostmi o chybě a účtování

Pokud dotaz vrátí status=failed, generování skončilo neúspěšně. Důvod chyby najdete v failed_reason a výsledek vrácení peněz v billing_status. V tomto příkladu hodnota refunded znamená, že kredity byly vráceny. V credits zůstává původní vyhrazená částka a odpověď neobsahuje žádná data.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "failed",
  "billing_status": "refunded",
  "credits": 30,
  "failed_reason": "provider_failed"
}

Webhooky

Nastavením callback_url v požadavku na vytvoření obdržíte JSON POST požadavek při dokončení nebo selhání úlohy. Odpovězte stavovým kódem 2xx do 15 sekund. Neúspěšná doručení se opakují; opakovaná doručení zpracovávejte idempotentně podle ID úlohy.

Koncový bod pro zpětné volání (callback) musí přijímat požadavky typu POST s tělem ve formátu JSON (Content-Type: application/json).

Vytvoření úlohy s callbackem

curl --fail-with-body https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEVIO_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "input": {
    "prompt": "A cat surfing at sunset, cinematic lighting",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "text-to-video",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "callback_url": "https://example.com/webhooks/seevio"
}'

Data ve webhooku se liší od odpovědí na dotaz na stav úlohy: neobsahují billing_status a credits; podrobnosti o selhání jsou uvnitř data.failed_reason a data.credits_refunded. Hodnota created_at ve webhooku představuje čas vytvoření události v unixových sekundách.

Úloha byla dokončena: callback s úspěšným výsledkem

Pokud generování proběhne úspěšně, callback vrátí status=completed. K identifikaci úlohy použijte id a k získání adres URL vygenerovaného videa data.results. Výsledky si stáhněte a uložte před vypršením času v data.video_expires_at.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "completed",
  "data": {
    "results": [
      "https://cdn.seevio.ai/api/videos/example.mp4"
    ],
    "video_expires_at": "2026-09-07T00:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

Úloha selhala: callback s chybovým hlášením

Pokud generování selže, callback vrátí status=failed. K identifikaci úlohy použijte id, pro zjištění důvodu selhání data.failed_reason a pro počet vrácených kreditů data.credits_refunded.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-0-mini",
  "status": "failed",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 30
  }
}

Příklad přijímače

export async function POST(request: Request) {
  const callbackData = await request.json();

  if (callbackData.status === "completed") {
    const videoUrls = callbackData.data.results;
    // Save the video URLs and mark this task as completed in your application.
    console.log(callbackData.id, videoUrls);
  }

  if (callbackData.status === "failed") {
    const { failed_reason, credits_refunded } = callbackData.data;
    // Record the failure reason and refunded credits for this task.
    console.error(callbackData.id, failed_reason, credits_refunded);
  }

  return new Response(null, { status: 200 });
}

Tento příklad v Next.js načítá tělo callbacku ve formátu JSON a rovnou zpracovává dokončené i neúspěšné úlohy. Do své aplikace přidejte perzistentní ukládání a deduplikaci podle ID úloh. Náročnější operace zařazujte do fronty ještě před potvrzením přijetí callbacku.

Požadavky na média a omezení

• Všechny adresy URL médií a callbacků musí být veřejné adresy HTTPS. Vyhněte se localhostu, privátním IP adresám a souborům vyžadujícím cookies nebo přihlášení. URL referenčního videa/audia musí odkazovat přímo na čitelný mediální soubor.
• V režimu reference-to-video poskytněte alespoň jednu referenci, s maximálně 9 obrázky, 3 videi, 3 zvukovými soubory a maximálně 12 materiály celkem. Celková délka videa i celková délka audia může být každá maximálně 15 sekund.
• text-to-video ignoruje všechny reference na média. image-to-video předává pouze obrázky pro první/poslední snímek a ignoruje reference na video a audio. Chcete-li média kombinovat, použijte reference-to-video.
• U modelů Seedance 2.0 použijte z důvodu kompatibility zvuk alespoň s jedním obrázkem nebo videem. Příklady čistě pro audio reference naleznete na stránce pro Seedance 2.5.
• Verze Fast a Mini podporují rozlišení 480p a 720p. Nespoléhejte na to, že validace požadavku povolí řetězce s vyšším rozlišením: pro tento model se nejedná o podporované úrovně výstupu.

Chyby

Chyby HTTP obsahují objekt error s poli code a message. Úspěšně přijatá úloha může přesto později selhat; dotazujte se na stav úlohy nebo ošetřete callback o jejím selhání.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

Limity četnosti požadavků

Vytváření úkolů: každý API klíč standardně umožňuje až 100 požadavků za minutu. Vlastní limity četnosti v současné době nejsou k dispozici.

Dotazování na úkoly: každý API klíč standardně umožňuje až 120 požadavků za minutu. Požadavky na dotazy a požadavky na vytváření úkolů se počítají samostatně.