
Результат примера «текст в видео» ниже: muse-video, 10 секунд, 16:9
Создание токена
Добавьте токен в разделе Управление токенами с такими настройками:Цены
Видео 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
Как это работает
Создайте задачу
POST /v1/videos, передав как минимум model и prompt. Эндпоинт асинхронный: он за несколько секунд возвращает id задачи, а не ждёт готового видео. Сохраните его.Опрашивайте статус
GET /v1/videos/{id} каждые 15 секунд и читайте status; каждый вызов возвращается сразу. Ролики до 10 секунд обычно готовы за 2–3 минуты, а в загруженные часы могут занимать больше 5; ролики на 20–30 секунд делаются примерно 4–10 минут, на 40–60 секунд — примерно 5–10 минут.Скачайте результат
status станет completed, скачайте MP4 по video_url. Для скачивания заголовок Authorization не нужен, а ссылка действует 7 дней.Подготовка
В примерах cURL поля ответов читаетjq (на macOS: brew install jq). Сначала задайте ключ и базовый URL:
Видео по тексту
seconds: если его не указать,muse-videoсделает 10-секундный ролик.aspect_ratio: форма кадра; вместо него можно передатьsizeв пикселях, например720x1280. Поле действует и тогда, когда вы передаёте первый кадр или референсные изображения; см. подраздел «Соотношение сторон при работе с изображениями».
Анимация по первому кадру или по первому и последнему кадрам
Передайтеimage, чтобы задать начальный кадр, и добавьте last_frame, чтобы задать и финальный. Каждое изображение может быть публичной ссылкой или data URL вида data:image/...;base64,:
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
Поля запроса
resolution и fps на результат не влияют.
Статусы задачи
Ошибки
Частые вопросы
Стоят ли 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 дней. Затем ссылка перестаёт работать, и задачу нельзя скачать повторно, поэтому сохраняйте файл сразу после завершения задачи.Связанные материалы
- Сравнение API видео и цены
- API видео MiniMax H3
- API видео Seedance 2.0
- API видео Wan 2.7 и Wan 3.0
- Модели и цены
- Журнал вызовов
- Модели Meta Model API: Muse Spark, Muse Image и другие, без модели генерации видео (проверено 30 октября 2026 года)