API ВИДЕО

Генерация видео

Запускайте Seedance 2.5, Seedance 2.5 CN, Seedance 2.0, Seedance 2.0 CN, Seedance 2.0 Fast, Seedance 2.0 Fast CN, Seedance 2.0 Mini, Seedance 2.0 Mini CN. Каждый запрос видео создает задачу, которую вы опрашиваете или получаете через webhook.

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

Укажите mode, чтобы выбрать сценарий работы. По умолчанию используется text_to_video. Выберите режим, чтобы обновить пример ниже.

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

POSThttps://api.mlmux.com/v1/videos/generations

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "model/seedance-2.5-max",
  "prompt": "A cinematic tracking shot along a coastal road at sunrise, warm backlight, gentle camera drift",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 8,
  "generate_audio": true,
  "route_mode": "official-cheap"
}'

Параметры

Поле	Тип	Обязательно	Описание
`model`	string	Да	Идентификатор модели из таблицы ниже.
`prompt`	string	Да	Сцена, объект, движение, камера, освещение и указания по звуку.
`mode`	string	Нет	`text_to_video` (по умолчанию), `image_to_video`, `first_last_frame` или `multi_ref`.
`ratio`	string	Нет	`16:9`, `9:16`, `4:3`, `3:4`, `1:1`, `21:9` или `adaptive` (если поддерживается). По умолчанию: `adaptive`.
`resolution`	string	Нет	`480p`, `720p`, `1080p` или `4K` в зависимости от модели. По умолчанию: `720p`.
`duration`	integer	Нет	Длительность клипа в секундах в пределах диапазона модели. По умолчанию: 5. Передайте `-1`, чтобы модель выбрала длительность автоматически.
`generate_audio`	boolean	Нет	Генерировать синхронизированное аудио вместе с клипом.
`route_mode`	string	Нет	`official` или `official-cheap`. По умолчанию используется режим маршрутизации ключа, иначе — `official-cheap`.
`image_url`	string	Условно	Обязательно для `image_to_video`: начальный кадр.
`first_frame_url` `last_frame_url`	string	Условно	Обязательно для `first_last_frame`. Вместо этого можно передать упорядоченный массив из двух `image_urls`.
`image_urls`	string[]	Условно	Референсные изображения для `multi_ref`.
`video_urls` `audio_urls`	string[]	Условно	Референсные видео и аудио для `multi_ref`.

Для multi_ref требуется как минимум один референс. Seedance 2.5 принимает до 30 изображений, 10 видео и 10 аудиофайлов (всего до 50); другие модели принимают до 9 изображений, 3 видео и 3 аудиофайлов (всего до 12). Используйте публичные HTTPS URL или предварительно загрузите файлы через POST /v1/uploads.

Модели

Модель	ID модели	Разрешение	Соотношение сторон	Длительность
Seedance 2.5	`model/seedance-2.5-max`	480p · 720p · 1080p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–30 с
Seedance 2.5 CN	`model/seedance-2.5-cn-max`	480p · 720p · 1080p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–30 с
Seedance 2.0	`model/seedance-2.0-max`	480p · 720p · 1080p · 4K	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 с
Seedance 2.0 CN	`model/seedance-2.0-cn-max`	480p · 720p · 1080p · 4K	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 с
Seedance 2.0 Fast	`model/seedance-2.0-fast-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 с
Seedance 2.0 Fast CN	`model/seedance-2.0-fast-cn-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 с
Seedance 2.0 Mini	`model/seedance-2.0-mini-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 с
Seedance 2.0 Mini CN	`model/seedance-2.0-mini-cn-max`	480p · 720p	adaptive · 16:9 · 21:9 · 4:3 · 1:1 · 3:4 · 9:16	4–15 с

Эти ID заканчиваются на -max, поэтому ratio, resolution и duration необязательны и по умолчанию принимают указанные выше значения.

Жизненный цикл задачи

Создание видео всегда возвращает HTTP 202 с объектом задачи. Сохраните ее id и опрашивайте poll_url. Когда status станет succeeded, ответ будет содержать video, usage и actual_charge_credits.

GEThttps://api.mlmux.com/v1/videos/generations/{task_id}

202 Accepted

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "model/seedance-2.5-max",
  "api_method": "videos.generations.create",
  "poll_url": "/v1/videos/generations/task_01a9...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 1.84
}

Успешно

{
  "id": "task_01a9...",
  "object": "video.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "video": "https://.../generated/01a9....mp4",
  "last_frame_image": "https://.../generated/01a9....jpg",
  "usage": {
    "output_tokens": 172800,
    "video_seconds": 8,
    "video_resolution": "720p"
  },
  "estimated_charge_credits": 1.84,
  "actual_charge_credits": 1.79
}

У завершившейся с ошибкой задачи status равен failed, а причина указана в message. Ссылки на результат размещаются на хостинге MLMux; скачайте файлы, которые хотите сохранить.

Вебхуки

Вместо опроса можно подписаться на события request.succeeded и request.failed. Формат полезной нагрузки и проверка подписи описаны в разделе Вебхуки.