Seedance Official Edition Video API

Вызов seedance-2.5官方版, seedance-2.0官方版, seedance-2.0-fast官方版 и seedance-2.0-mini官方版 с оплатой по разрешению, а также правила длительности, соотношения сторон, референсов и первого и последнего кадра.

На этой странице описан вызов видеомоделей Seedance (официальная версия). Как и другие видеомодели, они создаются через POST /v1/videos и опрашиваются через GET /v1/videos/{id}; аутентификация, загрузка материалов, статусы опроса, скачивание результатов и обработка ошибок описаны в полной спецификации Video API. Здесь приведены только поля и правила, специфичные для этой группы моделей.

Обновлено 2026-10-10. Эта группа моделей поддерживает только опрос: не указывайте callback_url при создании, иначе запрос будет отклонён. Возможности SD (облачная версия: SD2.0, SD2.5) и Seedance (официальная ретрансляция) отличаются от этой группы — см. SD (облачная версия) и Seedance (официальная ретрансляция).

Модели

Модель	Доступные разрешения	Длительность	По умолчанию	Лимит изображений / видео / аудио	Первый и последний кадр
`seedance-2.5官方版`	`720p` (по умолчанию)	4–30 с	4 с	30 / 10 / 10	Да, взаимоисключающе с обычными референсами
`seedance-2.0官方版`	`720p` (по умолчанию)	4–15 с	4 с	9 / 3 / 3	Да, взаимоисключающе с обычными референсами
`seedance-2.0-fast官方版`	`720p` (по умолчанию)	4–15 с	4 с	9 / 3 / 3	Да, взаимоисключающе с обычными референсами
`seedance-2.0-mini官方版`	`480p` (по умолчанию), `720p`	4–15 с	5 с	9 / 3 / 3	Режим первого и последнего кадра не поддерживается

Название модели должно точно совпадать с id, который возвращает GET /v1/models, включая суффикс 官方版. У каждой серии одно название модели; выходное разрешение выбирается полем resolution, и тарификация идёт по выбранному уровню. При добавлении новых уровней название модели не изменится.

Общие правила

Разрешение: укажите в resolution уровень из таблицы выше, регистр не важен (720p и 720P равнозначны); без него используется минимальный уровень. Неподдерживаемый серией уровень вернёт 400 без автоматического понижения.
Длительность: целое число секунд в duration (или строкой в seconds); если не указано, используется значение по умолчанию из таблицы выше.
Соотношение сторон: ratio (или aspect_ratio) принимает 16:9, 9:16, 1:1, 4:3, 3:4, 21:9; по умолчанию 16:9. auto не поддерживается.
Промпт: prompt обязателен.
Звук: переключателя генерации звука нет; не передавайте generate_audio.
Необязательные поля: negative_prompt (негативный промпт), seed (целое число).

Референсные материалы

Референсные изображения передаются в массиве верхнего уровня images.
Референсные видео передаются в metadata.referenceVideos, референсное аудио — в metadata.referenceAudios.
Для каждого типа материалов используйте одно поле; если передано несколько псевдонимов, будет использован один набор без объединения.
Требования к URL и загрузку локальных файлов см. в разделах Требования к URL медиафайлов и Загрузка локальных файлов.

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "Технологичная реклама: внешний вид продукта с изображений, ритм камеры из видео и звуковая атмосфера из референсного аудио",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

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

Первый и последний кадр передаются в metadata.firstFrame и metadata.lastFrame. lastFrame требует firstFrame; первый и последний кадр нельзя сочетать с референсными изображениями, видео или аудио.

{
  "model": "seedance-2.0官方版",
  "prompt": "Плавный переход от пустой площади ранним утром к той же композиции ночью, когда зажигаются огни",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Загрузка файлов

Одно локальное изображение можно также передать напрямую через multipart/form-data в поле input_reference; в этом случае не передавайте в том же запросе images или image. Референсные видео и аудио нельзя передать файлом: сначала получите URL, как описано в разделе Загрузка локальных файлов.

Устаревшие названия моделей

Прежние названия с уровнем Seedance-2.5-720p官方版, Seedance-2.0-720p官方版, Seedance-2.0-fast-720p官方版, seedance-2.0-mini-480p, seedance-2.0-mini-720p по-прежнему работают, но вывод и тарификация закреплены за уровнем из названия, а resolution игнорируется. Они больше не отображаются в каталоге моделей; для новых интеграций используйте название серии из таблицы выше вместе с resolution.