ToAPIsToAPIs
seedance-2

seedance-2 Генерация видео

Генерация видео с помощью seedance-2, seedance-2-fast и seedance-2-mini

POST
/v1/videos/generations

Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.

  • Поддерживаются 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

Authorizationstringзаголовокобязательно

Все запросы требуют Bearer Token аутентификацию.

Получить API Key можно на странице API Key Management Page.

Authorization: Bearer YOUR_API_KEY

Тело запроса

modelstringтелообязательнопо умолчанию: seedance-2

Название модели генерации видео.

Доступные модели:

  • seedance-2 - стандартная версия для более качественного результата и полного Seedance 2 workflow
  • seedance-2-fast - быстрая версия для превью и низкой задержки
  • seedance-2-mini - облегченная версия для недорогих черновиков и мультимодальных reference workflow, сейчас всегда создает 1 результат за запрос
promptstringтело

Текстовый prompt для видео.

Рекомендуется явно описывать сцену, движение камеры, действие, стиль и аудио-настроение.

client_business_idstringтело

Ваш бизнесовый ID, например номер заказа или внутренний ID задачи. Он сохраняется вместе с задачей и может использоваться для последующего запроса статуса: GET /v1/videos/generations/{client_business_id}.

Также поддерживается metadata.client_business_id, но рекомендуется верхнеуровневое поле.

durationintegerтелопо умолчанию: 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_ratiostringтело

Соотношение сторон видео.

Варианты:

  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16
  • adaptive

adaptive позволяет upstream выбрать подходящее соотношение по входным media.

image_urlsstring[]тело

Массив URL изображений в режиме совместимости.

Рекомендуется использовать image_with_roles, чтобы явно задавать first_frame, last_frame или reference_image.

  • Не используйте image_urls одновременно с image_with_roles.
  • Для новых интеграций используйте image_with_roles, чтобы явно указать назначение каждого изображения.
image_with_rolesarrayтело

Список изображений с ролями.

Поддерживаемые сценарии:

  • seedance-2 / seedance-2-fast / seedance-2-mini
    • first_frame для генерации по первому кадру
    • first_frame + last_frame для first-last-frame генерации
    • reference_image для мультимодального reference режима
Описание полей
urlstringтелообязательно

URL изображения.

rolestringтелообязательно

Роль изображения.

Разрешенные значения:

  • first_frame
  • last_frame
  • reference_image
  • Максимум 1 first_frame
  • Максимум 1 last_frame
  • Максимум 9 reference_image
  • Frame mode и reference mode нельзя смешивать
  • seedance-2-mini также поддерживает first_frame, last_frame и reference_image
video_with_rolesarrayтело

Список видео с ролями.

В мультимодальном reference режиме сейчас поддерживается только reference_video.

Описание полей
urlstringтелообязательно

URL видео.

rolestringтелообязательно

Фиксированное значение:

  • reference_video

Ограничения:

  • seedance-2-mini: до 3 reference video
audio_with_rolesarrayтело

Список аудио с ролями.

В мультимодальном reference режиме сейчас поддерживается только reference_audio.

Описание полей
urlstringтелообязательно

URL аудио.

rolestringтелообязательно

Фиксированное значение:

  • reference_audio

Ограничения:

  • seedance-2-mini: до 3 reference audio

audio_with_roles нельзя использовать само по себе. Нужен хотя бы один визуальный input.

resolutionstringтелопо умолчанию: 720p

Разрешение видео.

Варианты:

  • seedance-2: 480p, 720p, 1080p, 4k
  • seedance-2-fast: 480p, 720p
  • seedance-2-mini: 480p, 720p
generate_audiobooleanтелопо умолчанию: true

Генерировать ли синхронное аудио.

seedance-2-mini также поддерживает это поле.

return_last_framebooleanтелопо умолчанию: false

Возвращать ли изображение последнего кадра созданного видео.

При значении true URL изображения возвращается в result.data[0].last_frame_url после завершения задачи.

toolsarrayтело

Инструменты, доступные модели. Серия Seedance 2 сейчас поддерживает веб-поиск:

[{ "type": "web_search" }]

Фактическое число поисков возвращается в usage.tool_usage.web_search; значение 0 означает, что поиск не выполнялся.

tools поддерживается только для text-to-video и не может использоваться вместе с изображениями, видео или аудио.

seedintegerтело

Random seed для контроля генерации.

callback_urlstringтело

Стандартный callback ToAPIs. Сначала настройте URL и secret Token; разрешено только same-origin переопределение. См. Webhook.

trace_idstringтело

Поле трассировки клиента, не зависящее от Webhook.

disable_nsfwbooleanтелопо умолчанию: true

По умолчанию генерация NSFW-контента запрещена. Чтобы разрешить, установите false.

Проверка материалов

Если запрос содержит изображения, видео или аудио, некоторые каналы автоматически проверяют материалы перед отправкой на генерацию. Дополнительный параметр не нужен: передавайте URL материалов в прежних полях медиа.

  • Принятый запрос сразу возвращает видеозадачу. Если нужна проверка, задача остается в queued, а генерация отправляется только после того, как все материалы запроса пройдут проверку. Первая проверка может занять несколько минут; повторное использование того же URL тем же пользователем в том же канале переиспользует результат проверки.
  • Один раунд подготовки материалов по умолчанию длится не более 20 минут. Отказ в проверке или тайм-аут подготовки завершают задачу со статусом failed, причина указана в error.message. Если проверка не пройдена, плата за генерацию видео не взимается.
  • Материалы передаются только публичными HTTP(S) URL; Base64 и локальные пути не принимаются. Изображения должны быть не больше 30 MB, видео и аудио не больше 100 MiB. Прежние ограничения форматов модели сохраняются.
  • Каналы с проверкой валидируют материалы при приеме запроса: URL с учетными данными или длиннее 2048 байт, один URL с разными типами материала или более 64 ссылок на материалы в одном запросе возвращают HTTP 400 с error.code invalid_private_assets.
  • Материалы определяются по URL. После изменения содержимого файла используйте новый URL.
  • Прежние ссылки asset:// выведены из использования и возвращают HTTP 400.

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

Типичные поддерживаемые комбинации:

  • Только текст: 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-2seedance-2-fastseedance-2-mini
ПозиционированиеБолее высокое качество и длинные роликиБолее быстрая генерация и меньшая задержкаНедорогие черновики и мультимодальные reference
Длительность4-15 секунд, поддерживается авто-длительность4-15 секунд, поддерживается авто-длительность4-15 секунд
Разрешение480p / 720p / 1080p / 4k480p / 720p480p / 720p
Роли изображенийfirst_frame / last_frame / reference_imagefirst_frame / last_frame / reference_imagefirst_frame / last_frame / reference_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_audiogenerate_audio
ToAPIs callbackcallback_url (trace_id опционально)callback_url (trace_id опционально)callback_url (trace_id опционально)

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

Получайте готовые результаты через Статус видеозадачи. Если передача исходного URL включена, сначала используйте result.data[].url, а необязательный fallback_url только при недоступности основного адреса. Для последнего кадра используются last_frame_url и fallback_last_frame_url. Резервные поля возвращаются только при наличии доступных копий.

Response

idstring

ID задачи для запроса статуса.

client_business_idstring

Ваш бизнесовый ID. Возвращается только если client_business_id был передан в запросе.

objectstring

Тип объекта, всегда generation.task.

modelstring

Название модели, использованной в запросе.

statusstring

Статус задачи: queued, in_progress, completed или failed.

progressinteger

Прогресс задачи в процентах (0-100).

created_atinteger

Временная метка создания задачи.

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.

Пример запроса

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"
  }'
import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "seedance-2-mini",
        "prompt": "Сохрани персонажа и используй ритм reference image и reference video для короткого indoor ad clip",
        "duration": 8,
        "aspect_ratio": "16:9",
        "resolution": "720p",
        "image_with_roles": [
            {"url": "https://example.com/ref.png", "role": "reference_image"}
        ],
        "video_with_roles": [
            {"url": "https://example.com/ref.mp4", "role": "reference_video"}
        ],
    },
)

print(response.json())

Пример ответа

{
  "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
}