Seedance API

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

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

Authorization: Bearer sk_live_xxxxxxxx

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

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.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 із промптом і налаштуваннями генерації.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

Параметр generation_type визначає, які медіафайли приймаються та як модель їх інтерпретує.

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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
    }
  }'

curl https://api.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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.seevio.ai/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-5",
    "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": "720p"
    }
  }'

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

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

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

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

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

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "billing_status": "charged",
  "credits": 100,
  "failed_reason": null,
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "billing_status": "refunded",
  "credits": 100,
  "failed_reason": "provider_failed"
}

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

{
  "id": "3f2aK9mR...",
  "status": "completed",
  "created_at": 1781234567,
  "model": "seedance-2-5",
  "data": {
    "results": ["https://cdn.seevio.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-5",
  "data": {
    "failed_reason": "provider_failed",
    "credits_refunded": 100
  }
}

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": 100,
    "available": 12
  }
}

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

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