Muse Video

Muse Video — видеомодель от Meta Superintelligence Labs. Один запрос создаёт ролик примерно на 10 секунд в 720p со звуком из промпта или из промпта и до 9 референсных изображений в одном из семи соотношений сторон. Отправьте запрос, сохраните возвращённый идентификатор задачи и получите готовое видео из задачи. Референсные изображения передаются как URL.

ID моделей

Актуальные цены — на странице модели.

Краткий пример

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "muse-video",
    "prompt": "Waves rolling onto a sandy beach at sunset, slow camera pan, natural ocean sound. No text.",
    "aspect_ratio": "16:9"
  }'

Конечная точка

POST https://api.seedrouter.ai/v1/videos/generations

В ответе приходит задача ({"id": "task_...", "status": "processing"}), а не готовое видео. Результат получайте опросом GET /v1/tasks/{task_id}. Храните API-ключи в серверном коде.

Параметры

Поля вне этого списка удаляются перед передачей запроса; они не вызывают ошибку и не меняют результат. Настроек первого или последнего кадра, референсного видео, референсного аудио, продления, seed или негативного промпта нет. callback_url недоступен; вместо этого опрашивайте задачу.

Референсные изображения

Передайте до 9 изображений в image_urls и опишите движение в prompt. Muse Video использует их как референсы: ролик остаётся близок к ним, но первый кадр не является попиксельной копией. Если пропустить aspect_ratio, ролик следует их форме.

{
  "model": "muse-video",
  "prompt": "The fox slowly lifts its head, wind moving through its fur, the camera pushing in gently, soft forest ambience.",
  "image_urls": ["https://example.com/fox.png"]
}

Медиавходы

Каждый референс — это публичный URL по HTTP(S). Data URI в base64 не принимаются: загрузите файл в собственное хранилище и передайте его URL. Используйте изображения PNG, JPEG или WebP; суммарный размер исходных файлов всех референсов не должен превышать 11 МБ. Набор, превышающий этот предел, завершится ошибкой после приёма запроса и не оплачивается.

Факторы стоимости

Актуальные тарифы смотрите в разделе цен модели. У Muse Video единая цена за ролик:

cost = price per clip × 1

Цена не умножается на секунды. Запросы только с текстом и с референсами при любом соотношении сторон стоят одинаково. Зарезервированная при приёме задачи сумма равна списанной. Итоговые списания смотрите в истории использования своей учётной записи. Неуспешные задачи не тарифицируются.

Схема вывода

При отправке возвращается задача:

{"id": "task_...", "model": "muse-video", "status": "processing", "created_at": 1789689600}

Получение задачи

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Сетевой тайм-аут во время опроса не означает, что генерация завершилась сбоем: сохраните идентификатор задачи и продолжите проверку. Не создавайте другую задачу, чтобы узнать ход выполнения.

Выполненная задача

{
  "id": "task_...",
  "model": "muse-video",
  "status": "completed",
  "created_at": 1789689600,
  "finished_at": 1789689790,
  "output": {
    "video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"
  }
}

В наших тестах ролики пришли в виде файлов MP4 (H.264) длительностью 10,0 секунды с аудиодорожкой AAC: 1280 × 720 для 16:9, 720 × 1280 для 9:16 и 1248 × 704 для референса с соотношением сторон 16:9 примерно через 100–200 секунд после отправки.

Ошибки

Запросы, отклонённые до создания задачи, возвращают HTTP-ошибку вместе с объектом error и не тарифицируются. Задача, которая завершилась сбоем уже после приёма, при запросе возвращает HTTP 200 с status: "failed" и объектом error.

Коды, HTTP-статусы и рекомендации по повторным попыткам приведены в общем каталоге ошибок.

{
  "id": "task_...",
  "model": "muse-video",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Если тайм-аут произошёл при самой отправке, сначала проверьте свои задачи и только потом отправляйте повторно: первый запрос мог быть уже принят.

Советы

• Описывайте объект, действие, движение камеры и свет и указывайте нужные звуки; аудио генерируется вместе с картинкой.
• Создайте изображение с Muse Image, затем передайте сюда его URL, чтобы оживить его.
• Для вертикального видео передайте aspect_ratio: "9:16" или вертикальный референс.
• Добавьте no text, чтобы в кадре не появлялись выдуманные надписи.

Связанные материалы

• Playground и цены Muse Video
• Справочник API Muse Image
• Скачать OpenAPI
• Markdown для копирования