Seedance 2.0 API

API дозволяє програмно надсилати завдання на генерацію відео Seedance 2.0. Генерація асинхронна: створіть завдання, негайно отримайте ідентифікатор завдання, а потім отримайте готове відео, опитуючи кінцеву точку завдання або отримуючи веб-хук.

Створіть ключ API на панелі керування та надсилайте його як токен Bearer у кожному запиті. Повний ключ відображається лише один раз під час створення.

Authorization: Bearer sk_live_xxxxxxxx

Спочатку надішліть завдання. Після того, як завдання буде прийнято, виберіть один із методів доставки результату: опитувати кінцеву точку завдання або отримувати кінцевий результат через веб-хук.

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 });
}

Створіть відеозавдання за допомогою POST /v1/videos/generations. Тіло запиту має модель верхнього рівня, необов'язковий callback_url та об'єкт input, що містить prompt та налаштування генерації.

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 контролює, які медіа-входи приймаються та як модель їх інтерпретує.

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"
    }
  }'

Імена параметрів, значення перерахувань, шляхи кінцевих точок та приклади є частиною контракту API. Описи нижче пояснюють, як поводиться кожне поле.

Це успішна відповідь від POST /v1/videos/generations. Це означає, що завдання прийнято та кредити зарезервовано. Використовуйте повернутий taskId для опитування GET /v1/tasks/:id або для зіставлення зворотного виклику про завершення або невдачу.

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

Використовуйте GET /v1/tasks/:id, щоб отримати поточний стан завдання. Опитуйте не частіше, ніж раз на 10 секунд. Для виробничих систем віддавайте перевагу веб-хукам.

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"
}

Коли присутній callback_url, Seedance викликає вашу кінцеву точку, коли завдання завершується або не вдається, і надсилає дані JSON, що описують кінцевий результат. Якщо ваша кінцева точка повертає відповідь, відмінну від 2xx, або не відповідає протягом 15 секунд, доставка повторюється до 5 разів. Повторні спроби використовують той самий ідентифікатор завдання, тому виконайте дедуплікацію за ідентифікатором. Поверніть відповідь 200, як тільки ви безпечно записали дані зворотного виклику.

{
  "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 та GET /v1/tasks/:id повертають таку форму помилки, коли сам запит API не вдається, наприклад, через недійсні параметри, недійсний ключ API, недостатню кількість кредитів, перевищення ліміту запитів або відсутність завдання. Деякі помилки включають додаткові поля, такі як required, available або retry_after, залежно від ситуації.

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

Ліміти запитів застосовуються для кожного ключа API з плаваючим вікном. Генерація за замовчуванням становить 60 запитів на хвилину; запити статусу є більш лояльними. Відповіді HTTP 429 включають Retry-After.

API використовує резервування при відправці, стягнення плати при успіху та повернення коштів при невдачі. Сторінки використання на панелі керування показують історію кредитів API, журнали завдань та статистику використання за часом.