Перейти к основному содержанию
Muse — модель генерации видео от Meta. В каждом ролике есть своя музыка и звуковые эффекты, а один запрос может вернуть цельный ролик длиной до 60 секунд. LaoZhang API берёт плату за видео: от $0.30 за 5–10 секунд до $1.55 за 60 секунд; вызывать модель может токен любой стандартной группы.
Пример Muse «текст в видео»: маяк на скалистом берегу на рассвете, волны разбиваются о камни

Результат примера «текст в видео» ниже: muse-video, 10 секунд, 16:9

Создание токена

Добавьте токен в разделе Управление токенами с такими настройками: Аккаунт Meta и отдельная группа для видео не нужны.

Цены

Видео Muse оплачивается за ролик. Цена не зависит ни от длительности в пределах модели, ни от соотношения сторон, ни от того, передаёте ли вы изображения: Как работают списания:
  • Деньги списываются при создании задачи, а неудавшиеся задачи возвращаются полностью.
  • Запросы, отклонённые при отправке из-за ошибки параметров, не оплачиваются.
  • Каждая повторная отправка создаёт новую задачу и оплачивается снова, поэтому храните соответствие между вашим ID задания и id задачи.
Фактическое списание по каждой задаче видно в журнале вызовов.

Какую видеомодель выбрать

На 31 октября 2026 года Muse — самая низкая цена в LaoZhang API за 10-секундный ролик в 720p и выше. Выбирайте её, если нужна фиксированная цена за видео, цельный ролик на 20–60 секунд или продление уже готового видео. Для 2K, референсного видео или референсного аудио используйте MiniMax H3. Для 1080p выбирайте Seedance или Wan. В разделе Сравнение API видео указано, сколько стоит 5- или 10-секундный ролик на каждой модели и какой эндпоинт она использует.

Примеры результатов

Эти ролики — необработанный результат Muse со звуковой дорожкой, которую сгенерировала модель. Нажмите на ролик, чтобы воспроизвести его. В подписи указаны модель, длина, соотношение сторон и промпт. Примеры MiniMax H3 сделаны по тем же промптам, так что модели можно сравнить сцену за сценой.

muse-video, 5 секунд, 16:9. Промпт: A red fox walking through snowy forest at sunrise, cinematic

muse-video-20s продолжает предыдущий 5-секундный ролик до 20 секунд. Промпт: The fox reaches a frozen river and looks across it as the sun rises higher

muse-video-20s, 20 секунд, 16:9. Промпт: A paper boat drifts down a rainy city gutter, then sails into a small sunny pond

muse-video-40s продолжает предыдущий 20-секундный ролик до 40 секунд. Промпт: The paper boat sails across the pond, passes under a wooden bridge and reaches a garden fountain

muse-video-40s, 40 секунд, 16:9. Промпт: A hot air balloon rises over a valley at dawn, drifts over a river and a village, then lands in a meadow

muse-video-50s, 50 секунд, вертикальное 9:16. Промпт: A cyclist rides through a coastal town from morning to sunset: market, harbor, cliff road, lighthouse

Как это работает

1

Создайте задачу

Вызовите POST /v1/videos, передав как минимум model и prompt. Эндпоинт асинхронный: он за несколько секунд возвращает id задачи, а не ждёт готового видео. Сохраните его.
2

Опрашивайте статус

Вызывайте GET /v1/videos/{id} каждые 15 секунд и читайте status; каждый вызов возвращается сразу. Ролики до 10 секунд обычно готовы за 2–3 минуты, а в загруженные часы могут занимать больше 5; ролики на 20–30 секунд делаются примерно 4–10 минут, на 40–60 секунд — примерно 5–10 минут.
3

Скачайте результат

Когда status станет completed, скачайте MP4 по video_url. Для скачивания заголовок Authorization не нужен, а ссылка действует 7 дней.
Опрашивайте задачу до 30 минут и не отправляйте запрос повторно, пока она выполняется.
  • Создание задачи и опрос возвращаются сразу, поэтому увеличивать HTTP-таймаут не нужно.
  • 30 минут — предел опроса: проверяйте, пока status равен queued или in_progress.
  • Если вы прекратили опрос, позже проверьте тот же id ещё раз. Повторная отправка создаёт новую задачу и списывает деньги снова.
  • Задача, не завершившаяся за 40 минут, помечается как неудавшаяся и возвращается полностью.

Подготовка

В примерах cURL поля ответов читает jq (на macOS: brew install jq). Сначала задайте ключ и базовый URL:

Видео по тексту

Успешный запрос возвращает задачу в очереди:
Два необязательных поля, которые понадобятся чаще всего:
  • seconds: если его не указать, muse-video сделает 10-секундный ролик.
  • aspect_ratio: форма кадра; вместо него можно передать size в пикселях, например 720x1280. Поле действует и тогда, когда вы передаёте первый кадр или референсные изображения; см. подраздел «Соотношение сторон при работе с изображениями».

Анимация по первому кадру или по первому и последнему кадрам

Передайте image, чтобы задать начальный кадр, и добавьте last_frame, чтобы задать и финальный. Каждое изображение может быть публичной ссылкой или data URL вида data:image/...;base64,:
Модель использует два изображения как визуальные ориентиры: ролик начинается и заканчивается тем же кадром, но детали не воспроизводятся пиксель в пиксель. Чтобы загрузить локальные файлы, отправьте данные формы multipart. Первый кадр передаётся в input_reference, последний — в last_frame:
При загрузке через -F не задавайте Content-Type: application/json. Размер каждого изображения — до 10 МБ.

Генерация по референсным изображениям

Передайте в reference_images от 1 до 4 изображений. Модель переносит в видео их объект и стиль, но не использует ни одно из них как первый кадр:

Соотношение сторон при работе с изображениями

Если вы передаёте первый кадр, последний кадр или референсные изображения, форма ролика определяется так:
  • С aspect_ratio (или size): перед генерацией каждое изображение обрезается по центру до этого соотношения, и ролик получается в этой форме; размеры перечислены в разделе «Поля запроса».
  • Без него: ролик сохраняет форму изображения, поэтому горизонтальное фото 3:2 даст 1152×768.
Обрезка по центру убирает края слева и справа или сверху и снизу. Если объект находится у края, обрежьте изображение до нужного соотношения сами перед загрузкой — тогда вы управляете кадрированием.

Ролики на 20, 30 и до 60 секунд и продолжение видео

Более длинные модели генерируют один цельный ролик той длины, что указана в названии модели (от 20 до 60 секунд; цены — в разделе «Цены»). Вызываются они так же, как muse-video; поле seconds можно не указывать. Чтобы продолжить уже готовый ролик, передайте video_url:
Правила продолжения:
  • Параметр video_url принимают все модели, кроме muse-video. Готовое видео имеет длину, указанную в названии модели, включая исходный ролик.
  • Источник должен быть общедоступной https-ссылкой на MP4, как минимум на 2 секунды короче готового видео: до 18 секунд для muse-video-20s, 28 для muse-video-30s и так далее до 58 для muse-video-60s.
  • Если исходный файл больше примерно 19 МБ, LaoZhang API сначала сжимает его до 720p, поэтому исходная часть результата выглядит чуть мягче.
  • Например, 5-секундный источник, продолженный через muse-video-20s, получает около 15 секунд нового содержимого и превращается в 20-секундное видео.
  • В качестве источника подойдёт video_url, который вернул LaoZhang API.

Опрос и скачивание

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

Пока видео обрабатывается, status равен in_progress, а progress показывает примерный процент:
Когда задача завершена, в ней есть video_url:
У неудавшейся задачи status равен "failed", а причина указана в error.message. Списание уже возвращено:

Скачивание видео

Можно также вызвать GET /v1/videos/{id}/content с заголовком Authorization: он вернёт файл MP4.

Минимальный клиент на Python

Нужен пакет requests (pip install requests):

Справочник API

Поля запроса

Размер результата по соотношению сторон: Если переданы изображения, размер при том же соотношении может отличаться от таблицы на несколько десятков пикселей, например 1248×704 для 16:9 или 1056×800 для 4:3. Частота кадров всегда 24 кадра/с; параметры resolution и fps на результат не влияют.

Статусы задачи

Ошибки

Первые три ошибки приходят как HTTP 400 при отправке: задача не создаётся, деньги не списываются. Остальные приходят как неудавшаяся задача, списание по ней уже возвращено.

Частые вопросы

Стоят ли 5-секундный и 10-секундный ролики одинаково?

Да. muse-video стоит $0.30 за 5, 8 или 10 секунд. Для более длинного цельного плана используйте muse-video-20s ($0.55), muse-video-30s ($0.80) и далее до muse-video-60s ($1.55).

Можно ли получить видео в 1080p?

Нет. Muse выдаёт 1280×720 в горизонтальной ориентации и 720×1280 в вертикальной; другие формы перечислены в разделе «Поля запроса». Параметр resolution: "1080p" принимается, но размер результата не меняется.

Почему ролик повторяет форму моего изображения?

Без aspect_ratio и size Muse сохраняет форму переданного изображения. Добавьте aspect_ratio: изображение сначала обрежется по центру до этого соотношения, и ролик получится нужной формы. Если объект у края изображения, обрежьте его сами перед загрузкой; см. подраздел «Соотношение сторон при работе с изображениями».

Есть ли в видео звук и можно ли его отключить?

В каждом ролике есть звуковая дорожка с музыкой и эффектами, зависящими от вашего промпта. Отключить её параметром нельзя; если звук не нужен, уберите аудиодорожку после скачивания.

Можно ли отправить запрос повторно после таймаута или ошибки?

Сначала проверьте задачу. Таймаут на стороне клиента не означает, что задача не выполнена, поэтому продолжайте опрашивать тот же id: повторная отправка создаёт новую задачу и списывает деньги снова. Исправлять запрос и создавать новую задачу нужно только при status, равном failed. По неудавшимся задачам деньги уже возвращены, а задача, не завершившаяся за 40 минут, автоматически помечается как неудавшаяся и возвращается.

Как долго хранятся ссылки на видео?

7 дней. Затем ссылка перестаёт работать, и задачу нельзя скачать повторно, поэтому сохраняйте файл сразу после завершения задачи.

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