Skip to main content
POST
  • Поддерживаются seedance-2, seedance-2-fast и seedance-2-mini
  • Поддерживаются text-to-video и мультимодальный reference-to-video; seedance-2 и seedance-2-fast также поддерживают сценарии с первым и последним кадром
  • Поддерживаются совместные image / video / audio reference; для seedance-2-mini лимиты составляют 9 изображений, 3 видео и 3 аудио
  • Асинхронный сценарий: submit API возвращает generation.task, а готовый результат забирается через API статуса задачи

Authorizations

string
обязательно
Все запросы требуют Bearer Token аутентификацию.Получить API Key можно на странице API Key Management Page.

Тело запроса

string
по умолчанию:"seedance-2"
обязательно
Название модели генерации видео.Доступные модели:
  • seedance-2 - стандартная версия для более качественного результата и полного Seedance 2 workflow
  • seedance-2-fast - быстрая версия для превью и низкой задержки
  • seedance-2-mini - облегченная версия для недорогих черновиков и мультимодальных reference workflow, сейчас всегда создает 1 результат за запрос
string
Текстовый prompt для видео.Рекомендуется явно описывать сцену, движение камеры, действие, стиль и аудио-настроение.
string
Ваш бизнесовый ID, например номер заказа или внутренний ID задачи. Он сохраняется вместе с задачей и может использоваться для последующего запроса статуса: GET /v1/videos/generations/{client_business_id}.Также поддерживается metadata.client_business_id, но рекомендуется верхнеуровневое поле.
integer
по умолчанию:0
Длительность видео в секундах.Правила:
  • seedance-2: 4-15
  • seedance-2-fast: 4-15
  • seedance-2-mini: 4-15
  • 0: авто-длительность (только seedance-2 / seedance-2-fast)
  • -1: авто-длительность (только seedance-2 / seedance-2-fast)
string
Соотношение сторон видео.Варианты:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • adaptive
adaptive позволяет upstream выбрать подходящее соотношение по входным media.
string[]
Массив URL изображений в режиме совместимости.Рекомендуется использовать image_with_roles, чтобы явно задавать first_frame, last_frame или reference_image.
  • Не используйте image_urls одновременно с image_with_roles.
  • Для новых интеграций используйте image_with_roles, чтобы явно указать назначение каждого изображения.
array
Список изображений с ролями.Поддерживаемые сценарии:
  • seedance-2 / seedance-2-fast / seedance-2-mini
    • first_frame для генерации по первому кадру
    • first_frame + last_frame для first-last-frame генерации
    • reference_image для мультимодального reference режима
  • Максимум 1 first_frame
  • Максимум 1 last_frame
  • Максимум 9 reference_image
  • Frame mode и reference mode нельзя смешивать
  • seedance-2-mini также поддерживает first_frame, last_frame и reference_image
array
Список видео с ролями.В мультимодальном reference режиме сейчас поддерживается только reference_video.Ограничения:
  • seedance-2-mini: до 3 reference video
array
Список аудио с ролями.В мультимодальном reference режиме сейчас поддерживается только reference_audio.Ограничения:
  • seedance-2-mini: до 3 reference audio
audio_with_roles нельзя использовать само по себе. Нужен хотя бы один визуальный input.
string
по умолчанию:"720p"
Разрешение видео.Варианты:
  • seedance-2: 480p, 720p, 1080p, 4k
  • seedance-2-fast: 480p, 720p
  • seedance-2-mini: 480p, 720p
boolean
по умолчанию:true
Генерировать ли синхронное аудио.seedance-2-mini также поддерживает это поле.
boolean
по умолчанию:false
Возвращать ли изображение последнего кадра созданного видео.При значении true URL изображения возвращается в result.data[0].last_frame_url после завершения задачи.
array
Инструменты, доступные модели. Серия Seedance 2 сейчас поддерживает веб-поиск:
Фактическое число поисков возвращается в usage.tool_usage.web_search; значение 0 означает, что поиск не выполнялся.
tools поддерживается только для text-to-video и не может использоваться вместе с изображениями, видео или аудио.
integer
Random seed для контроля генерации.
string
Стандартный callback ToAPIs. Сначала настройте URL и secret Token; разрешено только same-origin переопределение. См. Webhook.
string
Поле трассировки клиента, не зависящее от Webhook.

Использование загруженных asset

Если вы уже загрузили приватные asset и получили asset_id, передавать исходный media URL повторно не нужно. Используйте:
  • asset://<ASSET_ID>
Asset можно использовать так:
  • Изображения: first_frame, last_frame, reference_image
  • Видео: reference_video
  • Аудио: reference_audio
Перед использованием убедитесь, что asset имеет статус active. Связанные руководства:

Комбинации входов

Типичные поддерживаемые комбинации:
  • Только текст: text-to-video
  • Текст + первый кадр: генерация по первому кадру
  • Текст + первый кадр + последний кадр: first-last-frame генерация
  • Текст + reference images: мультимодальный reference режим
  • Текст + reference video: генерация с reference видео
  • Текст + reference images + reference audio: мультимодальный reference режим
  • Текст + reference images + reference video + reference audio: мультимодальный reference режим
seedance-2-mini также поддерживает сценарии с первым кадром и первым/последним кадром. Используйте image_with_roles с явными ролями first_frame / last_frame.

Возможности

seedance-2-mini сейчас всегда генерирует 1 результат за запрос и не открывает count / n. Управление кадрами задавайте через image_with_roles с first_frame / last_frame.

Response

string
ID задачи для запроса статуса.
string
Ваш бизнесовый ID. Возвращается только если client_business_id был передан в запросе.
string
Тип объекта, всегда generation.task.
string
Название модели, использованной в запросе.
string
Статус задачи: queued, in_progress, completed или failed.
integer
Прогресс задачи в процентах (0-100).
integer
Временная метка создания задачи.
Submit API возвращает базовый объект задачи. После завершения используйте Get Video Task Status, чтобы получить completed_at, expires_at и result.type = "video" вместе с result.data[].url и result.data[].format. При return_last_frame последний кадр возвращается в result.data[0].last_frame_url; при web_search число поисков возвращается в usage.tool_usage.web_search.