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": "1080p",
      "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. Тело запроса должно содержать корневое поле model, необязательный 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": "1080p",
      "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": "1080p",
      "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-ключу по методу скользящего окна (sliding window). Для генерации стандартный лимит составляет 100 запросов в минуту; для запросов статуса действуют более мягкие ограничения. Ответы с кодом HTTP 429 всегда содержат заголовок Retry-After.

Оплата в API работает по схеме: резервирование при отправке, списание при успешном выполнении и возврат при ошибке. В панели управления в разделе использования доступна история списания кредитов, логи задач и статистика потребления.