Seedance 2.0 API

API umožňuje programově odesílat úlohy generování videa Seedance 2.0. Generování je asynchronní: vytvoříte úlohu, okamžitě obdržíte ID úlohy a poté získáte hotové video buď dotazováním na endpoint úlohy, nebo přijetím webhooku.

Vytvořte API klíč v nástěnce a posílejte ho jako Bearer token při každém požadavku. Úplný klíč se zobrazí pouze jednou při vytvoření.

Authorization: Bearer sk_live_xxxxxxxx

Nejprve odešlete úlohu. Po přijetí úlohy si vyberte jednu z metod doručení výsledku: dotazování na endpoint úlohy, nebo příjem konečného výsledku prostřednictvím webhooku.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

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

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

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

Vytvořte úlohu videa pomocí POST /v1/videos/generations. Tělo požadavku obsahuje model nejvyšší úrovně, volitelnou callback_url a vstupní objekt obsahující výzvu a nastavení generování.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cat surfing on a neon wave, cinematic lighting",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

generation_type řídí, které mediální vstupy jsou přijímány a jak je model interpretuje.

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "callback_url": "https://your-domain.com/api/seedance/webhook",
    "input": {
      "prompt": "a cinematic drone shot over a futuristic coastal city at sunrise",
      "generation_type": "text-to-video",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p",
      "generate_audio": true,
      "watermark": false,
      "web_search": false,
      "return_last_frame": false,
      "seed": -1
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "the subject turns toward camera, soft studio motion",
      "generation_type": "image-to-video",
      "image_urls": ["https://your.cdn.com/first-frame.jpg"],
      "duration": 5,
      "resolution": "720p"
    }
  }'

curl https://api.seedance2.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "input": {
      "prompt": "use the product from image 1 and the camera motion from the reference video",
      "generation_type": "reference-to-video",
      "image_urls": ["https://your.cdn.com/product.jpg"],
      "video_urls": ["https://your.cdn.com/camera-motion.mp4"],
      "audio_urls": [],
      "duration": 8,
      "resolution": "1080p"
    }
  }'

Názvy parametrů, hodnoty výčtu, cesty k endpointům a příklady jsou součástí API smlouvy. Níže uvedené popisy vysvětlují, jak se jednotlivá pole chovají.

Toto je úspěšná odpověď z POST /v1/videos/generations. Znamená to, že úloha byla přijata a kredity byly rezervovány. Použijte vrácené taskId k dotazování GET /v1/tasks/:id nebo k porovnání se zpětným voláním o dokončení nebo selhání.

{
  "taskId": "3f2aK9mR...",
  "credits": 60
}

Použijte GET /v1/tasks/:id k získání aktuálního stavu úlohy. Dotazujte se ne častěji než jednou za 10 sekund. Pro produkční systémy preferujte webhooky.

curl https://api.seedance2.ai/v1/tasks/3f2aK9mR7xQp4TnZ8bLc6YwH \
  -H "Authorization: Bearer sk_live_xxx"

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "charged",
  "credits": 60,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "billing_status": "refunded",
  "credits": 60,
  "failed_reason": "provider_failed"
}

Pokud je přítomno callback_url, Seedance zavolá váš endpoint, když je úloha dokončena nebo se nezdaří, a odešle JSON data popisující konečný výsledek. Pokud váš endpoint vrátí odpověď, která není 2xx, nebo neodpoví do 15 sekund, doručení se opakuje až 5krát. Opakování používají stejné ID úlohy, takže je odstraňte duplikáty podle ID. Vraťte odpověď 200, jakmile bezpečně zaznamenáte data zpětného volání.

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "results": ["https://cdn.seedance2.ai/.../x.mp4"],
    "video_expires_at": "2026-06-13T10:00:00Z",
    "last_frame_url": null,
    "processing_time": 48
  }
}

{
  "id": "3f2aK9mR...",
  "status": "failed",
  "created_at": 1781234567,
  "model": "seedance-2-0",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 60
  }
}

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

  if (callbackData.status === "completed") {
    const videoUrl = callbackData.data.results[0];
    // Save the video URL or update your own task record here.
  }

  if (callbackData.status === "failed") {
    const errorMessage = callbackData.data.failed_reason;
    // Mark your own task record as failed here.
  }

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

POST /v1/videos/generations a GET /v1/tasks/:id vrací tento tvar chyby, když se samotný požadavek API nezdaří, například neplatné parametry, neplatný API klíč, nedostatečné kredity, omezení rychlosti nebo úloha nebyla nalezena. Některé chyby zahrnují další pole, jako jsou 'required', 'available' nebo 'retry_after' v závislosti na situaci.

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this task.",
    "required": 60,
    "available": 12
  }
}

Omezení frekvence jsou aplikována na každý API klíč s posuvným oknem. Generování má výchozí hodnotu 60 požadavků za minutu; dotazy na stav jsou shovívavější. Odpovědi HTTP 429 zahrnují Retry-After.

API používá rezervaci při odeslání, účtování při úspěchu a vrácení peněz při selhání. Stránky využití na nástěnce zobrazují historii API kreditů, protokoly úloh a statistiky využití založené na čase.