Перейти к основному содержанию
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "Сохрани персонажа с изображения 1, используй движение камеры из видео 1 и ритм аудио 1 для короткого indoor product ролика.",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}
  • Поддерживаются 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

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

​
Тело запроса

​
model
string
по умолчанию:"seedance-2"
обязательно
Название модели генерации видео.Доступные модели:
  • seedance-2 - стандартная версия для более качественного результата и полного Seedance 2 workflow
  • seedance-2-fast - быстрая версия для превью и низкой задержки
  • seedance-2-mini - облегченная версия для недорогих черновиков и мультимодальных reference workflow, сейчас всегда создает 1 результат за запрос
​
prompt
string
Текстовый prompt для видео.Рекомендуется явно описывать сцену, движение камеры, действие, стиль и аудио-настроение.
​
client_business_id
string
Ваш бизнесовый ID, например номер заказа или внутренний ID задачи. Он сохраняется вместе с задачей и может использоваться для последующего запроса статуса: GET /v1/videos/generations/{client_business_id}.Также поддерживается metadata.client_business_id, но рекомендуется верхнеуровневое поле.
​
duration
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)
​
aspect_ratio
string
Соотношение сторон видео.Варианты:
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
​
image_urls
string[]
Массив URL изображений в режиме совместимости.Рекомендуется использовать image_with_roles, чтобы явно задавать first_frame, last_frame или reference_image.
  • Не используйте image_urls одновременно с image_with_roles.
  • seedance-2-mini не поддерживает frame mode. Для mini используйте image_with_roles с reference_image.
​
image_with_roles
array
Список изображений с ролями.Поддерживаемые сценарии:
  • seedance-2 / seedance-2-fast
    • first_frame для генерации по первому кадру
    • first_frame + last_frame для first-last-frame генерации
    • reference_image для мультимодального reference режима
  • seedance-2-mini
    • только reference_image
  • Максимум 1 first_frame
  • Максимум 1 last_frame
  • Максимум 9 reference_image
  • Frame mode и reference mode нельзя смешивать
  • seedance-2-mini поддерживает только reference_image
​
video_with_roles
array
Список видео с ролями.В мультимодальном reference режиме сейчас поддерживается только reference_video.Ограничения:
  • seedance-2-mini: до 3 reference video
​
audio_with_roles
array
Список аудио с ролями.В мультимодальном reference режиме сейчас поддерживается только reference_audio.Ограничения:
  • seedance-2-mini: до 3 reference audio
audio_with_roles нельзя использовать само по себе. Нужен хотя бы один визуальный input.
​
resolution
string
по умолчанию:"720p"
Разрешение видео.Варианты:
  • seedance-2: 480p, 720p, 1080p, 4k
  • seedance-2-fast: 480p, 720p
  • seedance-2-mini: 480p, 720p
​
generate_audio
boolean
по умолчанию:true
Генерировать ли синхронное аудио.
Для seedance-2-mini поле generate_audio не открыто. Не отправляйте его для mini.
​
seed
integer
Random seed для контроля генерации.
​
callback_url
string
URL для асинхронного callback.
​
trace_id
string
Ваш pass-through trace ID. Работает вместе с callback_url.

​
Использование загруженных 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
  • Текст + первый кадр: генерация по первому кадру (seedance-2 / seedance-2-fast)
  • Текст + первый кадр + последний кадр: first-last-frame генерация (seedance-2 / seedance-2-fast)
  • Текст + reference images: мультимодальный reference режим
  • Текст + reference video: генерация с reference видео
  • Текст + reference images + reference audio: мультимодальный reference режим
  • Текст + reference images + reference video + reference audio: мультимодальный reference режим
seedance-2-mini поддерживает только reference mode. first_frame и last_frame не поддерживаются.

​
Возможности

Параметрseedance-2seedance-2-fastseedance-2-mini
ПозиционированиеБолее высокое качество и длинные роликиБолее быстрая генерация и меньшая задержкаНедорогие черновики и мультимодальные reference
Длительность4-15 секунд, поддерживается авто-длительность4-15 секунд, поддерживается авто-длительность4 / 8 / 10 / 12 / 15 секунд
Разрешение480p / 720p / 1080p / 4k480p / 720p480p / 720p
Роли изображенийfirst_frame / last_frame / reference_imagefirst_frame / last_frame / reference_imagereference_image
Роли видеоreference_videoreference_videoreference_video
Роли аудиоreference_audioreference_audioreference_audio
Frame modeПоддерживаетсяПоддерживаетсяНе поддерживается
Лимит reference image999
Лимит reference videoЗависит от выбранного routed channelЗависит от выбранного routed channel3
Лимит reference audioЗависит от выбранного routed channelЗависит от выбранного routed channel3
Поле синхронного аудиоgenerate_audiogenerate_audioНе открыто
Callbackcallback_url + trace_idcallback_url + trace_idcallback_url + trace_id
seedance-2-mini сейчас всегда генерирует 1 результат за запрос и не открывает count / n. Также mini не поддерживает media_mode=frame, first_frame, last_frame и return_last_frame.

​
Response

​
id
string
ID задачи для запроса статуса.
​
client_business_id
string
Ваш бизнесовый ID. Возвращается только если client_business_id был передан в запросе.
​
object
string
Тип объекта, всегда generation.task.
​
model
string
Название модели, использованной в запросе.
​
status
string
Статус задачи: queued, in_progress, completed или failed.
​
progress
integer
Прогресс задачи в процентах (0-100).
​
created_at
integer
Временная метка создания задачи.
Submit API возвращает базовый объект задачи. После завершения используйте Get Video Task Status, чтобы получить completed_at, expires_at и result.type = "video" вместе с result.data[].url и result.data[].format.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2-mini",
    "client_business_id": "order_20260616_001",
    "prompt": "Сохрани персонажа с изображения 1, используй движение камеры из видео 1 и ритм аудио 1 для короткого indoor product ролика.",
    "duration": 10,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://example.com/ref-image-1.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://example.com/ref-video-1.mp4", "role": "reference_video"}
    ],
    "audio_with_roles": [
      {"url": "https://example.com/ref-audio-1.mp3", "role": "reference_audio"}
    ],
    "resolution": "480p"
  }'

{
  "id": "tsk_vid_xxx",
  "client_business_id": "order_20260616_001",
  "object": "generation.task",
  "model": "seedance-2-mini",
  "status": "in_progress",
  "progress": 10,
  "created_at": 1781577600
}