Skip to main content

​
Обзор

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

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

Создание задачи и опрос её статуса по task_id с примерами для Python / cURL / Node.js и интерактивным Playground

Бонусы при пополнении

Бонусы при пополнении дополнительно снижают эффективную цену

​
Поручите интеграцию ИИ-агенту

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

Поручите кодинг-агенту интеграцию или отладку генерации видео MiniMax-H3. Скопируйте и вставьте это в Codex, Claude Code, Cursor и аналогичные инструменты.

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

Полный набор возможностей

Доступны генерация по тексту, по первому/последнему кадру, а также смешанная референсная генерация по изображениям / видео / аудио с теми же лимитами на референсы, что и у официальной модели (9 изображений + 3 видео + 3 аудиоклипа)

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

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

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

Сочетайте с бонусами за пополнение для снижения фактических затрат

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

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

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

Тот же ключ работает и с Seedance 2.0 / 2.5, Wan2.7, VEO 3.1 и другими

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

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

​
Ключевые возможности

Встроенный стереозвук

Каждый ролик включает музыку и звуковые эффекты, создаваемые на основе prompt и любого референсного аудио, без отдельного этапа дубляжа

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

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

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

Тарификация по фактическому количеству запрошенных секунд, поэтому короткие ролики стоят дешевле

Длинные prompt

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

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

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

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

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

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

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

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

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

​
Тарифы

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

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

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

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

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

​
Эндпоинты API

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

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

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

​
Ссылки на медиафайлы в prompt

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

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

1

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

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

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

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

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

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

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

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

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

Генерация обычно занимает 2–4 минуты; установите общий клиентский таймаут на 15 минут
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.
Каждый клип содержит стереодорожку, и параметра для ее отключения нет. Если она вам не нужна, удалите аудиодорожку на этапе постобработки.
На данный момент нет. Повторная отправка с тем же Idempotency-Key все равно создает новую задачу, которая тарифицируется отдельно. Отслеживайте отправленные задачи на стороне своего приложения.
Нет. Как только задача переходит в статус failed, средства возвращаются в полном объеме автоматически; отклоненные при отправке запросы также не тарифицируются.
Нет. Все медиафайлы должны быть общедоступными HTTPS URL. Сначала загрузите их в собственное объектное хранилище и передайте ссылку.
Разрешение соответствует соотношению сторон исходного изображения, например, 768×768 для квадратного изображения и 1344×768 для изображения 16:9. Запросы, содержащие только текст или только аудио, не могут использовать adaptive.
Одиночный клип длительностью более 15 секунд автоматически обрезается до первых 15 секунд, но если суммарная длительность нескольких референсных видео превышает 15 секунд, задача завершается ошибкой (а средства возвращаются).
По замерам медианное время составляет около 3 минут, обычно 2–4 минуты; клипы длительностью 10–15 секунд обрабатываются чуть дольше.
Мы не сталкивались с быстрым истечением срока его действия, однако долговременная доступность не гарантируется, поэтому своевременно скачивайте и сохраняйте видео. Проверяйте URL с помощью запроса GET; запросы HEAD возвращают 403.
Сначала убедитесь, что тело запроса соответствует правилам (ровно один текстовый элемент, никаких лишних полей, медиассылки по HTTPS). Если все верно, обычно это временная перегрузка: подождите несколько секунд и повторите попытку. Запросы с ошибкой отправки не тарифицируются.

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