Seedance 2.5

Возможности

Тарифы и кредиты

Списание кредитов за генерацию видео происходит на основе тарифицируемой длительности в секундах. Без использования исходного видео тарифицируется только длительность готового ролика. При наличии исходного видео в расчет также включается длительность референсного видео.

В таблице ниже указана стоимость в кредитах за одну секунду, а не общая стоимость генерации. Тариф зависит от модели, разрешения готового видео, а также от наличия референсных видео в режиме генерации по образцу. Формулы и примеры расчета полной стоимости приведены под таблицей.

• Без видео на входе: секунд на выходе × тариф без видео.
• С видео на входе: (секунд на выходе + фактическая длительность референсного видео) × тариф с видео. Сервер измеряет общую длительность референсного видео и округляет её в большую сторону до целых секунд перед расчётом стоимости.
• Использование только изображений или аудио в качестве референсов тарифицируется по тарифу без видео. Тариф с видео применяется только в режиме reference-to-video при наличии референсных видеороликов.

Кредиты резервируются в момент отправки запроса и списываются при успешном завершении. Задачи, завершившиеся ошибкой или по таймауту, отправляются на возврат. Статус биллинга refund_failed означает, что возврат не был завершён; проверьте логи API или обратитесь в поддержку.

Аутентификация

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

https://api.seevio.ai

Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Задайте переменную окружения SEEVIO_API_KEY перед запуском этих примеров. Примеры на JavaScript выполняются на стороне сервера с помощью Node.js; примеры на Python используют библиотеку requests.

Быстрый старт

Отправьте этот минимальный запрос, сохраните полученный taskId, а затем используйте пример запроса статуса ниже. Значение credits в ответе на создание задачи — это зарезервированная сумма.

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

Пример ответа при создании задачи

После того как вышеуказанный запрос будет принят, API вернет этот ответ в формате JSON. Параметр taskId представляет собой идентификатор задачи, используемый для последующих запросов ее статуса; credits — это количество кредитов, зарезервированных для выполнения данной задачи. Этот ответ подтверждает лишь создание задачи, а не готовность видео. Чтобы получить готовый видеофайл, вам необходимо периодически опрашивать статус задачи или использовать Webhook.

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

Создание задачи

Отправьте JSON-объект, содержащий model, input и необязательный параметр callback_url. Всегда указывайте точный ID модели, приведенный на этой странице; если поле model опущено, будет выбрана seedance-2-0.

Тело запроса

Входные параметры

Передайте параметры image_urls, video_urls и audio_urls в виде массивов со строками URL-адресов (string[]). Каждый указанный URL-адрес должен быть общедоступным по протоколу HTTPS, включая медиафайлы, игнорируемые выбранным режимом.

Логические поля должны принимать значения true или false в формате JSON, а не строки или числа.

Ответ при создании

HTTP 200 возвращает taskId (строку) и credits (число). Это подтверждает только создание задачи, а не её выполнение. Указанная ниже сумма соответствует 5-секундному видео 720p из раздела «Быстрый старт».

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

Режимы генерации и примеры

Текст в видео

Генерация по текстовому промпту. Медиа-URL в этом режиме не передаются.

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

Первый кадр

Передайте одно изображение в качестве первого кадра, а затем опишите движение в промпте.

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

Первый и последний кадры

Передайте два URL-адреса изображений по порядку: сначала первый кадр, затем последний. В этом примере также запрашивается последний кадр сгенерированного видео.

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

Мультимодальный референс

Сочетание изображений, видео и аудио в качестве референсов. Промпт по-прежнему обязателен. Наличие референсного видео на входе меняет формулу расчета стоимости.

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

Аудиореференс

Использование аудио в качестве единственного типа референса с обязательным текстовым промптом, описывающим желаемый видеоряд.

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-5",
  "input": {
    "prompt": "Create a coastal sunrise scene matching the rhythm of this audio.",
    "duration": 5,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "audio_urls": [
      "https://example.com/music.mp3"
    ]
  }
}'

Редактирование видео

Опишите изменения и предоставьте исходное видео. Установите duration=-1 и используйте соотношение сторон adaptive. Для этого сценария используйте исходный ролик длительностью не менее 4 секунд. Правило тарификации для duration=-1 приведено выше.

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-5",
  "input": {
    "prompt": "Edit the source video: change the character’s coat to blue and preserve the camera movement.",
    "duration": -1,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Продолжение видео

Опишите, как должно продолжаться исходное видео. Используйте соотношение сторон adaptive и укажите стандартную длительность видео на выходе в пределах поддерживаемого диапазона модели.

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-5",
  "input": {
    "prompt": "Continue the camera movement from the source video, revealing a forest clearing.",
    "duration": 8,
    "resolution": "720p",
    "generation_type": "reference-to-video",
    "video_urls": [
      "https://example.com/source.mp4"
    ],
    "aspect_ratio": "adaptive"
  }
}'

Запрос статуса задачи

Замените ID в примере на taskId, полученный при создании. Запросы возвращают только те задачи, которые принадлежат владельцу API-ключа; недоступные или несуществующие ID возвращают HTTP 404.

Для начала делайте запросы каждые 10–20 секунд, увеличивайте интервал при получении HTTP 429 и прекращайте опрос, когда статус изменится на completed или failed. Для продакшена рекомендуется использовать вебхуки. Каждый пример кода ниже выполняет один запрос.

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

Успешное выполнение: ответ на запрос с готовым видео

Когда запрос возвращает status=completed, генерация видео завершена. Ссылки на видеофайлы можно получить из data.results — скачайте их до наступления времени, указанного в data.video_expires_at. Значение billing_status=charged означает, что зарезервированные кредиты были списаны.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "status": "completed",
  "billing_status": "charged",
  "credits": 100,
  "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
  }
}

Ошибка выполнения: ответ на запрос со сведениями об ошибке и оплате

Если запрос возвращает status=failed, генерация завершилась неудачно. Причину ошибки можно узнать в failed_reason, а статус возврата средств — в billing_status. В данном примере значение refunded означает, что кредиты были возвращены на баланс. При этом в credits отображается изначально зарезервированная сумма, а блок data в ответе отсутствует.

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

Вебхуки

Укажите callback_url в запросе на создание задачи, чтобы получать POST-запросы с JSON-телом при завершении или ошибке задачи. Возвращайте ответ со статусом 2xx в течение 15 секунд. В случае неудачной доставки попытки повторяются; обрабатывайте повторные доставки идемпотентно по ID задачи.

Ваша конечная точка (endpoint) для обратного вызова должна принимать POST-запросы с телом запроса в формате JSON (Content-Type: application/json).

Создание задачи с вебхуком

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

Полезная нагрузка вебхука отличается от ответа на запрос статуса задачи: в ней отсутствуют billing_status и credits; детали ошибки находятся в data.failed_reason и data.credits_refunded. Поле created_at в вебхуке указывает время создания события в формате Unix timestamp (в секундах).

Задача выполнена: структура успешного ответа (callback payload)

При успешной генерации вебхук возвращает статус status=completed. Используйте id для идентификации задачи, а массив data.results — для получения URL-адресов видео. Скачайте и сохраните результаты до наступления времени, указанного в data.video_expires_at.

{
  "id": "3f2aK9mR7xQp4TnZ8bLc6YwH",
  "created_at": 1788652800,
  "model": "seedance-2-5",
  "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
  }
}

Ошибка выполнения задачи: структура ответа при сбое

Если генерация завершилась ошибкой, вебхук возвращает статус status=failed. Используйте id для идентификации задачи, data.failed_reason — для выяснения причины сбоя, а data.credits_refunded — для проверки количества возвращенных кредитов.

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

Пример обработчика (receiver)

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

В этом примере для Next.js показано, как считывать JSON-тело вебхука и обрабатывать успешно выполненные и проваленные задачи. Для интеграции в продакшн добавьте сохранение данных в БД и дедупликацию по task-ID, а ресурсоемкие фоновые задачи отправляйте в очередь перед отправкой ответа на вебхук.

Требования и ограничения для медиа

• Все URL-адреса медиафайлов и вебхуков должны использовать протокол HTTPS и быть публично доступными. Избегайте localhost, приватных IP-адресов и файлов, требующих cookie или авторизации. URL-адреса референсных видео и аудио должны вести непосредственно на читаемые файлы.
• В режиме reference-to-video предоставьте как минимум один референс. Всего должно быть не более 30 изображений, 10 видео, 10 аудиофайлов и не более 50 материалов суммарно. Общая длительность видео и аудио не должна превышать 30 секунд для каждого типа медиа.
• Режим text-to-video игнорирует любые медиареференсы. Режим image-to-video использует только изображения первого/последнего кадров, игнорируя видео и аудио. Для объединения различных типов медиа используйте режим reference-to-video.
• Каждый референсный видео- и аудиофайл должен длиться от 2 до 30 секунд. Для примеров редактирования видео используйте исходные клипы длительностью не менее 4 секунд.

Ошибки

Ошибки HTTP возвращают объект error с полями code и message. Успешно принятая задача всё ещё может завершиться ошибкой позже; запрашивайте статус задачи или обрабатывайте вебхук об ошибке.

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

Лимиты запросов

Создание задач: по умолчанию для каждого API-ключа разрешено до 100 запросов в минуту. Индивидуальные лимиты запросов на данный момент не поддерживаются.

Получение информации о задачах: по умолчанию для каждого API-ключа разрешено до 120 запросов в минуту. Запросы на получение информации и запросы на создание задач учитываются раздельно.