MiniMax · Видео · API

MiniMax Hailuo API — цены в рублях и подключение за 5 минут

MiniMax Hailuo API в рублях: генерация видео по тексту и картинке через один ключ Zerocoder. Цена за клип, примеры cURL / Python / Node.js, лимиты и возвраты.

Получить API-ключ MiniMax Hailuo в студии без кода →Документация

Что это за модели

MiniMax Hailuo — семейство моделей генерации видео от MiniMax: по текстовому описанию или по кадру-референсу модель строит короткий видеоролик длительностью от 4 до 10 секунд. Соотношение сторон или размер кадра задаётся отдельным параметром, по умолчанию 16:9. Для сценариев image-to-video можно передать ссылку на исходный кадр — модель анимирует именно его, а не генерирует сцену с нуля.

Что даёт подключение через Zerocoder

Один API-ключ и один рублёвый кошелёк открывают доступ сразу ко всем моделям платформы, включая обе модели Hailuo. Пополнение — картой РФ или по счёту для юрлица, без VPN и без зарубежных карт. Документация и выпуск ключей — в личном кабинете API. SDK и формат запросов совместимы с привычными HTTP-клиентами, переключение между моделями семейства — это смена одного параметра model.

Как устроен запрос

Запрос на генерацию уходит на POST /v1/videos с моделью, промптом, длительностью и опциональным кадром для image-to-video; в ответ приходит id задачи и статус queued. Готовность опрашивается через GET /v1/videos по этому id: статус меняется на processing, затем на completed со ссылкой на файл или на failed с автоматическим возвратом средств.

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

Таблица строится из живого прайса GET /v1/models: цены уже с наценкой, в рублях и в долларах по внутреннему курсу. Что пропало из таблицы — временно не отдаёт шлюз.

Модель	Единица	₽	$	Примеры стоимости	Endpoint
`minimax-3-hailuo`рекомендуем	за клип	14,9 ₽	$0.166	1 генерация: 14,9 ₽ · $0.166 10 генераций: 149 ₽ · $1.66	`/v1/videos`
`minimax-h3`	за секунду	5,56 ₽	$0.062	ролик 5 с: 27,8 ₽ · $0.309 ролик 10 с: 55,6 ₽ · $0.617	`/v1/videos`

Калькулятор стоимости

Выберите модель и объём — калькулятор считает по тем же формулам, что биллинг API.

МодельКоличество клипов 10

за клип14,9 ₽ $0.166

в месяц · 10149 ₽ $1.66

Цены из GET /v1/models, курс — внутренний. Неудачная генерация не списывается.

Первый запрос

Один ключ zc-sk-…, заголовок x-api-key (или Authorization: Bearer), база https://zerocoder.com/api/v1. Примеры собраны из реальных контрактов маршрутов.

Создайте ключ

В кабинете → API: пополните баланс в рублях и создайте ключ zc-sk-…

Отправьте запрос

Скопируйте пример ниже — id модели уже подставлен из прайса.

Проверьте списание

GET /v1/balance покажет баланс; цена вызова приходит в ответе.

cURLPythonNode.jsmodel: minimax-3-hailuo

# 1) start the render — price_rub is charged up front, refunded if the render fails
curl https://zerocoder.com/api/v1/videos \
  -H "x-api-key: zc-sk-…" -H "content-type: application/json" \
  -d '{"model": "minimax-3-hailuo", "prompt": "A drone shot over a foggy pine forest at sunrise, slow dolly in", "seconds": 5, "aspect": "16:9"}'
# → {"id":"vid_…","object":"video","model":"minimax-3-hailuo","status":"queued","seconds":5,"price_rub":…,"balance_rub":…,"poll":"/api/v1/videos?id=vid_…"}

# 2) poll until status is "completed" (url) or "failed" (refunded: true)
curl "https://zerocoder.com/api/v1/videos?id=vid_…" -H "x-api-key: zc-sk-…"
# image-to-video: add "image": "https://…/frame.jpg" to the body

import time, requests

API = "https://zerocoder.com/api/v1"
H = {"x-api-key": "zc-sk-…"}

job = requests.post(f"{API}/videos", headers=H, json={
    "model": "minimax-3-hailuo",
    "prompt": "A drone shot over a foggy pine forest at sunrise, slow dolly in",
    "seconds": 5,            # 4–10
    "aspect": "16:9",        # or 9:16 / 1:1; "image": "https://…" for image-to-video
}).json()
print("charged", job["price_rub"], "RUB, balance", job["balance_rub"])

while True:
    st = requests.get(f"{API}/videos", headers=H, params={"id": job["id"]}).json()
    if st["status"] == "completed":
        print(st["url"]); break
    if st["status"] == "failed":
        print("failed, refunded:", st.get("refunded")); break
    time.sleep(4)

const API = "https://zerocoder.com/api/v1";
const H = { "x-api-key": "zc-sk-…", "content-type": "application/json" };

const job = await fetch(`${API}/videos`, {
  method: "POST", headers: H,
  body: JSON.stringify({ model: "minimax-3-hailuo", prompt: "A drone shot over a foggy pine forest at sunrise, slow dolly in", seconds: 5, aspect: "16:9" }),
}).then((r) => r.json());
console.log("charged", job.price_rub, "RUB");

for (;;) {
  const st = await fetch(`${API}/videos?id=${job.id}`, { headers: H }).then((r) => r.json());
  if (st.status === "completed") { console.log(st.url); break; }
  if (st.status === "failed") { console.log("failed, refunded:", st.refunded); break; }
  await new Promise((r) => setTimeout(r, 4000));
}

MiniMax Hailuo в студии без кода →Документация

Входные материалы, лимиты и возврат денег

Текст → видео и картинка → видео (image: публичная https-ссылка)
Длительность seconds: 4–10 с (по умолчанию 5)
aspect 16:9 / 9:16 / 1:1 или явный size
Списание до старта по price_rub, при сбое рендера — возврат (refunded: true)
Ролик дольше 30 минут в очереди — возврат автоматически
30 запросов в минуту на ключ (все ручки вместе)

Ответы с ошибками и возвраты

# 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or revoked API key."}}
# 402 {"type":"error","error":{"type":"billing_error","message":"Not enough API balance: …"}}
# 429 {"type":"error","error":{"type":"rate_limit_error","message":"…"}}   ← 30 requests/min per key
# 400 {"type":"error","error":{"type":"invalid_request_error","message":"Unknown model \"…\". See GET /v1/models."}}
# 502 {"type":"error","error":{"type":"api_error","message":"… Charge refunded."}}   ← start failed → money back
# GET ?id → {"id":"vid_…","status":"failed","refunded":true}                        ← render failed → money back

Сценарии использования

Продюсер коротких роликов генерирует видео-заготовки для соцсетей по текстовому брифу клиента

Маркетинговый сервис собирает пайплайн: текст от копирайтера → автоматическая генерация видео через /v1/videos

Стартап оживляет статичные фото товаров в карточках маркетплейса через image-to-video

Внутренний инструмент студии превращает сценарные кадры (сторибоард) в черновые анимированные превью

Telegram-бот принимает промпт от пользователя и возвращает готовое видео, опрашивая статус задачи

Продуктовая команда A/B-тестирует два id модели семейства на одном промпте для подбора стиля и цены

Как готовить промт

Опишите план и движение камеры явно: общий/средний/крупный план, наезд, панорама, скорость движения
Задайте свет и время суток в промпте: мягкий утренний свет, контровой закат, неон ночью — это меняет настроение кадра
Укажите, что конкретно происходит за отведённые 4–10 секунд: одно чёткое действие лучше, чем несколько сюжетов подряд
Для image-to-video подробно опишите референсный кадр: что на нём статично, а что должно начать двигаться
Подбирайте aspect/size и seconds под площадку публикации и избегайте текста в кадре, толпы и мелких деталей рук — модель их искажает

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

Поддерживает ли Hailuo генерацию видео по картинке?

Да: передайте https-ссылку на изображение в поле image и опишите движение — модель анимирует кадр.

Как получить ключ к MiniMax Hailuo API?

Зарегистрируйтесь на Zerocoder, откройте раздел API в кабинете и создайте ключ формата zc-sk-…. Этот же ключ открывает MiniMax Hailuo и все остальные модели каталога — отдельный ключ под MiniMax Hailuo не нужен.

Как оплачивается MiniMax Hailuo API?

Пополняете API-баланс в рублях с карты российского банка или по счёту для юрлиц. Списание за секунду или за клип MiniMax Hailuo по цене из GET /v1/models; цены MiniMax Hailuo уже включают наценку, скрытых комиссий нет.

Что будет, если MiniMax Hailuo не сгенерировал ролик?

Если генерация MiniMax Hailuo упала у провайдера — списание возвращается на баланс автоматически, в ответе будет refunded: true. Вы платите только за готовый ролик.

Какие лимиты у MiniMax Hailuo API?

Лимит общий для ключа — 30 запросов в минуту на все генерирующие ручки, включая MiniMax Hailuo. При превышении приходит 429 rate_limit_error; для больших нагрузок на MiniMax Hailuo напишите нам — лимит поднимается индивидуально.

Нужен ли VPN или зарубежная карта для MiniMax Hailuo API?

Нет. Запросы к MiniMax Hailuo идут на zerocoder.com, оплата в рублях, закрывающие документы для бухгалтерии — по запросу.

Можно ли попробовать MiniMax Hailuo без кода?

Да: MiniMax Hailuo доступен в студии Zerocoder и в бесплатных инструментах каталога — проверьте качество руками, а потом подключайте MiniMax Hailuo API.

API нейросетей для ваших продуктов

Оплата в рублях, без VPN, дешевле официальных API на 70 %

Получить API-ключ Открыть API