Перейти к основному содержанию

​
Обзор

MiniMax H3 (Hailuo 3.0) — универсальная мультимодальная видеомодель, выпущенная MiniMax 31.07.2026 (UTC+8). Одна модель принимает текст, изображения, видео и аудио, а на выходе создаёт видео со стереодорожкой аудио. APIYI предоставляет MiniMax-H3 из самостоятельно размещённого развёртывания открытых весов, в разрешении 768P, длительностью от 4 до 15 секунд для одного клипа, с тарификацией посекундно.
Основные особенности: один эндпоинт поддерживает генерацию видео из текста, видео по первому кадру, последнему кадру или первому и последнему кадрам, а также генерацию по смешанным референсам изображений, видео и аудио. Ограничения составляют 9 референсных изображений, 3 референсных видео и 3 референсных аудиоклипа, при этом общее количество медиаобъектов не может превышать 12. Выходные данные включают стереодорожку аудио. Выходное видео и каждое входное референсное видео стоят $0.03 за секунду (официальный API MiniMax взимает $0.08 за каждое). Задача генерации видео из текста или изображения длительностью 10 секунд без референсного видео стоит $0.30. Стоимость неудачных задач автоматически возвращается.

Справочник API генерации видео

Создавайте задачу и проверяйте её по task_id с примерами для Python, cURL и Node.js, а также в интерактивной песочнице

Бонусы за пополнение

Бонусы за пополнение ещё больше снижают фактическую стоимость

​
Попросите AI-агента выполнить интеграцию

Скопируйте этот промпт и вставьте его в Codex / Claude Code / Cursor

Сначала агент получает текстовую версию этой страницы (добавьте .md к любому URL документации), затем пишет код для вашего стека. Типичные ошибки уже описаны: путь должен содержать /hailuo, результаты находятся внутри task, а duration должно быть целым числом от 4 до 15.

Интегрируйте генерацию видео MiniMax-H3 (текст в видео / видео по первому и последнему кадрам / видео по референсу) в этом проекте или помогите отладить её.

Прежде чем писать код, прочитайте документацию: получите текстовую версию этой страницы по адресу https://docs.apiyi.com/en/api-capabilities/minimax-h3/overview.md; параметры и примеры кода находятся по адресу https://docs.apiyi.com/en/api-capabilities/minimax-h3/video-generation.md .

  1. Эндпоинты: отправка через POST https://api.apiyi.com/hailuo/v2/video_generation, запрос статуса через …

Всего 10 требований. Используйте кнопку ниже, чтобы скопировать полный промпт.

​
Почему MiniMax-H3 от APIYI?

Несколько режимов генерации

Доступны генерация текста, по первому/последнему кадру, а также смешанная генерация с референсами изображений, видео и аудио; всего можно использовать не более 12 медиафайлов. Ограничения для каждого типа медиафайлов см. в разделе «Технические характеристики»

Поминутная тарификация, возврат средств при сбоях

Выходное видео и входное референсное видео стоят $0.03 за секунду; стоимость неудачных задач возвращается в полном объёме, а ошибки при отправке не тарифицируются

Бонусы за пополнение суммируются

Объединяйте их с бонусами за пополнение, чтобы снизить фактическую стоимость

Глобальный доступ без ограничений

Подключайтесь напрямую к api.apiyi.com с помощью одного ключа API; зарубежный аккаунт не требуется

Полная линейка видеомоделей

Этот же ключ работает с Seedance 2.0 / 2.5, Wan3.0, Wan2.7 и другими моделями

Профессиональная поддержка

Обращайтесь в службу поддержки по вопросам интеграции; корпоративные клиенты получают помощь на этапе внедрения

​
Основные возможности

Встроенная поддержка стереозвука

Результат включает стереофоническую аудиодорожку на основе prompt и референсного аудио; поддерживаются генерация звука и повторное использование референсного аудио

7 соотношений сторон

Шесть фиксированных соотношений от 21:9 до 9:16, а также adaptive для сохранения соотношения сторон референсного изображения

Любая целочисленная длительность от 4 до 15 с

Выбирайте длительность результата в целых секундах; референсное видео тарифицируется отдельно по длительности входного видео

Длинные промпты

До 7000 символов на prompt — достаточно для покадровых описаний

Управление первым и последним кадрами

Укажите только первый кадр, только последний или оба, чтобы задать начало и конец ролика

Несколько референсных изображений

До 9 референсных изображений; обозначайте персонажей и объекты в prompt с помощью <Picture 1> и так далее

Перенос движения из видео

До 3 референсных видео для воспроизведения движений камеры и ритма движения

Видео на основе аудио

До 3 референсных аудиоклипов; изображение следует за музыкой или голосом

​
Цены

Этот канал запускает открытые веса H3 MiniMax в нашей собственной среде развертывания. Это не релей официального API MiniMax, поэтому здесь действуют собственные цены:
Этот канал представляет собой самостоятельное развертывание открытых весов с тарификацией, независимой от официального API MiniMax. Цены могут измениться; приведенная выше таблица предназначена только для справки, а вкладка Цены на модели в верхней навигации является источником актуальной информации: Цены на модели. Официальные цены из platform.minimax.io/docs/guides/pricing-paygo (получены 2026-09-29).
Детали тарификации:
  • Выходное видео: $0.03 за секунду; входное референсное видео: $0.03 за секунду. Итоговая тарификация использует сообщаемый вышестоящим сервисом объем выходного и входного видео; длительность входного видео берется из usage.input_seconds
  • При принятии запроса платформа предварительно списывает плату за выходные данные на основе запрошенного duration. После завершения она рассчитывает фактическое использование и списывает или возвращает разницу
  • В журнале расчетов фиксируется только корректировка, а не полная стоимость повторно. Итоговая стоимость = предварительное списание + дополнительные списания − возвраты; у задачи не всегда бывает ровно две записи о тарификации
  • За референсные изображения (до 9) и референсное аудио дополнительная плата не взимается
  • Для неуспешных задач (сбой загрузки медиафайлов, неподдерживаемый формат, ошибка выполнения и т. д.) полная сумма автоматически возвращается
  • Запросы, возвращающие 4xx / 5xx при отправке, не тарифицируются; запрос статуса и скачивание бесплатны
  • См. бонусы за пополнение, чтобы снизить фактическую стоимость
Примеры по указанным выше стандартным тарифам: Эти примеры показывают, что именно тарифицируется. Цены могут измениться; проверяйте Цены на модели в верхней навигации, чтобы узнать актуальные тарифы. Для определения длительности входных данных используйте сообщаемый вышестоящим сервисом usage.input_seconds, а не запрошенный duration.

​
Настройка группы

MiniMax-H3 работает в группе default, и группа svip также подходит; выделенная группа не требуется. Мы рекомендуем установить модель тарификации Token на Pay-as-you-go Priority. Если при вызове возвращается «no available channels for the current group», значит, группа Token не включает эту модель или значение model указано с ошибкой (оно чувствительно к регистру).

​
Технические характеристики

Официальная модель MiniMax H3 поддерживает 2K, однако этот канал предлагает только 768P; 2K отклоняется.

​
Приблизительное время генерации

Время генерации для MiniMax-H3 зависит главным образом от двух факторов: длительности результата и наличия референсного видео. Приведенная ниже таблица отражает текущее состояние этого канала на основе более 400 успешных задач в период с 2026-09-29 по 2026-10-10 (UTC+8):
  • Время растет быстрее, чем длительность: 15-секундный ролик генерируется примерно в 5 раз дольше 5-секундного, а не в 3 раза
  • Дольше всего обрабатываются референсные видео: модель покадрово разбирает референсное видео и рассчитывает его вместе с новыми кадрами, что многократно увеличивает объем вычислений
  • Настраивайте таймауты клиента на основе этой таблицы: 30 минут для задач без референсного видео и 2 часа для задач с ним, чтобы выполняющиеся задачи ошибочно не принимались за сбой
Это текущие измеренные показатели данного канала. Для чувствительных ко времени задач начните с 4–6-секундных роликов или используйте референсные изображения вместо референсных видео. Скоро появится более быстрая и качественная группа MiniMax; мы сообщим об этом на этой странице и в Changelog.

​
Эндпоинты API

Основной хост — https://api.apiyi.com, резервный хост — https://b.apiyi.com, пути те же. Обратите внимание, что пути начинаются с /hailuo, а не с /v1.

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

Режим генерации определяется по медиафайлам в content[]:

​
Ссылки на медиа в промпте

Медиафайлы каждого типа нумеруются в порядке следования в content[]: первое и второе референсные изображения — это <Picture 1> и <Picture 2>, первое референсное видео — <Video 1>, первый аудиофрагмент-референс — <Audio 1>. Например:
  • Первые и последние кадры нельзя комбинировать с какими-либо референсными медиафайлами
  • Если используется одно изображение, role можно не указывать (оно считается первым кадром); если изображений два или больше, задайте role для каждого
  • Общая длительность референсных видео не должна превышать 15 секунд, иначе задача завершится ошибкой (с возвратом средств); один клип длительностью более 15 секунд обрезается до первых 15 секунд

​
Повторное использование аудиореференсов и ограничения

Отправьте аудио с помощью type: "audio_url", audio_url.url и role: "reference_audio". Его можно комбинировать с изображениями с помощью role: "reference_image". Используйте <Audio 1>: fully_copy в поле text элемента типа type: "text" в content[], чтобы задать инструкции по повторному использованию аудио. Ниже приведён фрагмент раздела retention_analysis промпта; отправьте его вместе с аудиореференсом и полным визуальным описанием:
fully_copy — это инструкция по повторному использованию аудио в промпте, а не отдельный параметр JSON и не переключатель сквозной передачи исходного аудио. Повторное использование аудио тестировалось в этом канале, но результат генерируется моделью. Побитовое совпадение, отсутствие добавленных звуков и полная тишина после окончания референса не гарантируются. Если исходная звуковая дорожка должна остаться полностью неизменной, замените аудиодорожку после генерации видео и самостоятельно согласуйте длительность.

​
Лучшие практики

1

Сначала тестируйте на 4–5 секундах

Тарификация посекундная, поэтому перед рендерингом 10–15 секунд проверьте композицию и стиль на коротком ролике
2

Используйте фиксированное соотношение сторон для text-to-video

16:9 для альбомной ориентации, 9:16 для портретной, 21:9 для широкоформатной; при наличии первого кадра adaptive сохраняет соотношение сторон изображения
3

Размещайте медиафайлы в стабильном публичном хранилище

Используйте прямые ссылки из собственного объектного хранилища или CDN, чтобы защита от хотлинкинга или истекшие подписи не прерывали скачивание медиафайлов
4

Описывайте движения камеры и звук

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

Опрашивайте статус каждые 10 секунд

5-секундный ролик обычно занимает около 3 минут; установите общий таймаут клиента на 30 минут без референсного видео и на 2 часа при его наличии (см. «Ориентировочное время генерации»)
6

Реализуйте идемпотентность самостоятельно

Сохраняйте привязку бизнес-ID к task_id; если время ожидания отправки истекло, проверьте наличие существующей задачи перед повторной отправкой
7

Сохраняйте видео сразу

Скачайте task.content.url с помощью GET и раздавайте его из собственного хранилища

​
Коды ошибок и повторные попытки

Советы для клиента: установите таймаут отправки на 60 секунд (в пиковые периоды только отправка может занимать более 10 секунд); повторяйте попытки только при ошибках HTTP 500 и сетевых сбоях, с постепенным увеличением интервала. Средства за любой сбой на этапе выполнения возвращаются автоматически, а повторная отправка тарифицируется как новый запрос.

​
Часто задаваемые вопросы

В пути отсутствует префикс /hailuo. Правильные пути: /hailuo/v2/video_generation и /hailuo/v2/query/video_generation/{task_id}.
Этот канал поддерживает только 768P. Официальная модель MiniMax поддерживает 2K, но в этом канале такая возможность недоступна.
Нет. duration должно быть целым числом от 4 до 15.
В результат включена стереодорожка, и параметра для отключения генерации аудио нет. Передача generate_audio=false возвращает HTTP 400 unsupported field generate_audio. Если аудио не нужно, удалите дорожку при постобработке.
Этот эндпоинт не поддерживает параметр seed; его передача возвращает HTTP 400 unsupported field seed. Запросы статуса задачи также не возвращают фактическое зерно для воспроизведения результата.
Текущие эндпоинты создания и запроса статуса не возвращают ревизию модели или полный снимок параметров выполнения. В ответах могут быть метаданные, например model, duration, ratio и resolution, но MiniMax-H3 — это только название модели, оно не указывает на используемый снимок весов.
Пока нет. Повторная отправка с тем же Idempotency-Key создаёт новую задачу, тарифицируемую отдельно. Отслеживайте отправленные задачи в своём приложении.
Нет. Когда задача получает статус failed, средства автоматически возвращаются в полном объёме; за запросы, отклонённые при отправке, плата также не взимается.
Нет. Все медиафайлы должны быть доступны по публичным HTTPS URL. Сначала загрузите их в собственное объектное хранилище, затем передайте ссылку.
Оно соответствует соотношению сторон входного изображения: например, 768×768 для квадратного изображения и 1344×768 для изображения с соотношением сторон 16:9. В запросах только с текстом или аудио нельзя использовать adaptive.
Если длительность одного клипа превышает 15 секунд, он автоматически обрезается до первых 15 секунд. Но если суммарная длительность нескольких эталонных видео превышает 15 секунд, задача завершается ошибкой, а средства возвращаются.
Около 3 минут для клипа длительностью 5 секунд и около 13 минут для клипа длительностью 15 секунд; задачи с эталонным видео выполняются гораздо дольше — около 85 минут для клипа длительностью 15 секунд. Полную таблицу см. выше в разделе «Ожидаемое время генерации».
Мы не замечали, чтобы срок его действия быстро истекал, но долгосрочная доступность не гарантируется, поэтому скачайте и сохраните видео как можно скорее. Проверьте URL с помощью GET; запросы HEAD возвращают 403.
Сначала убедитесь, что тело запроса соответствует правилам: содержит ровно один текстовый элемент, не содержит дополнительных полей, а ссылки на медиафайлы используют https. Если всё верно, вероятнее всего, это временная перегрузка: подождите несколько секунд и повторите запрос. За неудачные запросы на отправку плата не взимается.

​
Связанные документы