MiniMax
MiniMax H3
minimax-h3-max/text-to-video
Универсальная мультимодальная видеомодель: в одном контексте одновременно обрабатывает текст, изображения, видео и аудио, поддерживает генерацию видео из текста, из изображения, по референсу и редактирование по инструкции, а также создание синхронизированного аудио
Попробовать minimax-h3-max/text-to-video
Ввод
Работы
Все работыВывод
videoЦены
minimax-h3-max/text-to-video per second
| Характеристики | Цена за единицу |
|---|---|
| 480P | $0.072 |
| 768P | $0.115 |
| 1080P | $0.229 |
Краткое описание
minimax-h3-max/text-to-video — это линейка генерации видео по текстовому описанию от MiniMax для сценариев text-to-video: достаточно ввести подсказку на естественном языке, чтобы получить короткий видеоклип с синхронизированной звуковой дорожкой. Поддерживается длительность до 15 секунд, разрешение от 480P до 1080P и шесть соотношений сторон, а также доступны расширение промпта и заменяемая целевая аудиодорожка. Решение подходит разработчикам, которым нужен массовый выпуск раскадровок, рекламных материалов или вертикальных коротких видео; подключение через единый интерфейс HiAPI.ai позволяет использовать его в производственном процессе.
Ключевые особенности
- Промпт напрямую описывает изображение, действие и звук — prompt одновременно несёт визуальное и звуковое описание, а выходное видео уже содержит подходящую звуковую дорожку, что избавляет от этапа поздней синхронизации озвучки.
- Три уровня управления расширением промпта — prompt_expansion_mode предлагает режимы disabled, balanced и quality, позволяя по необходимости выбирать между сохранением исходного замысла и повышением детализации.
- Широкий охват длительности и соотношений сторон — длительность задаётся от 0.92 до 15 секунд, доступны шесть соотношений сторон от 21:9 до 9:16, так что горизонтальные, квадратные и вертикальные материалы можно сгенерировать за одну настройку.
- Заменяемая звуковая дорожка — передача target_audio_url позволяет заменить выходную звуковую дорожку; слишком длинное аудио обрезается с начала, слишком короткое дополняется тишиной, что упрощает выравнивание под заданную музыку.
Описание возможностей
Параметризованная генерация видео по тексту: вывод управляется комбинацией prompt, duration, resolution и aspect_ratio; по умолчанию используются 768P, 16:9 и 5 секунд, а под канал размещения можно переключиться на 1080P и вертикальное соотношение сторон.
Синхронный аудиовыход: при генерации видео одновременно создаётся подходящий звук, что подходит для коротких видео, где готовый материал нужен сразу, и снижает объём последующей работы со звуком.
Расширение промпта: при краткой подсказке включите режим balanced или quality, чтобы модель дополнила детали; если требуется строго воспроизвести исходное описание, переключитесь на disabled.
Замена звуковой дорожки и ограничения длительности: при указании target_audio_url можно подставить собственное аудио, при этом нижняя граница длительности видео становится 2 секунды, чтобы слишком короткая дорожка не рассинхронизировалась с изображением.
Воспроизводимое случайное зерно: поле seed поддерживает фиксацию случайного зерна для воспроизведения одного и того же результата; явно переданный 0 передаётся как есть, что удобно для отладки и пакетного сравнения.
Сценарии применения
- Команды коротких видео: генерация образцов по однострочному описанию раскадровки — введите текст сцены и параметры длительности и соотношения сторон, чтобы быстро получить клип со звуком для проверки раскадровки и согласования с заказчиком.
- Рекламное размещение: массовый выпуск в нескольких форматах — при одном и том же промпте переключайте соотношения 16:9, 9:16, 1:1 и другие, получая вертикальные и квадратные материалы, готовые к размещению на разных каналах.
- Контент-мейкеры: генерация готового видео под музыку — передайте собственное аудио как target_audio_url, чтобы получить изображение, согласованное по длине со звуковой дорожкой, для клипов с монтажом под ритм и музыкального контента.
- Разработчики приложений: программная интеграция видеоинтерфейса — через единый интерфейс HiAPI.ai вызывайте генерацию пакетно с seed и параметрами, встраивая text-to-video в производство контента или автоматизацию маркетинга.
Ограничения и рекомендации по выбору
Максимальная длительность одной генерации — 15 секунд; для более длинного повествования нужно генерировать фрагменты по частям и затем склеивать их. Максимальное разрешение — 1080P; если требуется более высокое качество вывода, стоит рассмотреть другие линейки. При включённом расширении промпта модель дополняет детали, поэтому для строгого воспроизведения описания рекомендуется отключить его. При передаче пользовательского аудио нижняя граница длительности видео составляет 2 секунды, а звуковая дорожка обрезается или дополняется тишиной, поэтому длину материала нужно контролировать самостоятельно. Если на входе только текст, а требуется управление по референсному изображению или первому и последнему кадру, следует выбрать линейку image-to-video той же серии.
Новости
Смотреть changelog →- Новая модель Новая модель: minimax-h3 — генерация нативного видео 2K через POST /v1/tasks, поддержка текста в видео длительностью 4–15 секунд…
Частые вопросы
Все частые вопросы →-
К какому типу видеомоделей относится MiniMax H3?
Она основана на Prompt, также можно добавлять первый и последний кадры или референсные изображения, видео и аудио; различные способы управления следует комбинировать в соответствии с текущим контрактом параметров.
-
Какие выходные спецификации поддерживает MiniMax H3?
Поддерживается длительность 4-15 секунд, разрешение включает 2K, а соотношения сторон включают 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 и adaptive.
-
Можно ли генерировать звук или использовать аудиореференсы?
Доступны опциональные референсы изображений, видео и аудио; поддерживается генерация аудио
-
Как тарифицируется MiniMax H3?
Тарификация зависит от длительности вывода и тарифного уровня в реальном времени; различия, обусловленные разрешением, режимом или параметрами звука, определяются ценами на странице и записями задач.
Создать задачу генерации
https://api.hiapi.ai/v1/tasks Заголовки
AuthorizationstringОбязательноAPI-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ
Content-TypestringНеобязательноТело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.
Idempotency-KeystringНеобязательноКлюч идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.
При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.
Тело запроса
modelstringОбязательноТекущее фиксированное значение: minimax-h3-max/text-to-video
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для minimax-h3-max/text-to-video и маршрута default — см. таблицу параметров ниже.
seedintegerНеобязательноСлучайное зерно, используемое для управления случайностью результата генерации. При пропуске выбирается системой случайным образом; если нужно фиксированное зерно, при явной передаче 0 его также необходимо передать.
promptstringОбязательноminLength 1maxLength 50000pattern \SТекстовый промпт, описывающий желаемое изображение, действие, движение камеры и звуковое содержимое.
durationnumberНеобязательноПо умолчанию: 5min 0.92max 15Длительность генерируемого видео, числовое значение, по умолчанию 5.
resolutionstringНеобязательноПо умолчанию: "768P"Разрешение генерируемого видео, строка, по умолчанию 768P.
480P768P1080Paspect_ratiostringНеобязательноПо умолчанию: "16:9"Соотношение сторон генерируемого видео, строка, по умолчанию 16:9.
21:916:94:31:13:49:16target_audio_urlstringНеобязательноminLength 1pattern ^https?://[^\s/@]+(?:[/?#][^\s]*)?$Адрес целевой аудитории, используемый для замены звуковой дорожки выходного видео; аудио должно быть не короче 2 секунд и не превышать 15 МБ, длинное аудио обрезается с начала, короткое дополняется тишиной.
prompt_expansion_modestringНеобязательноПо умолчанию: "balanced"Режим расширения промпта, управляющий стратегией автоматического расширения входного промпта, по умолчанию balanced.
disabledbalancedqualitycallbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "temp"Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.
temppersistentПримеры запроса
# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3-max/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "minimax-h3-max/text-to-video",
input: {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "minimax-h3-max/text-to-video",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768P",
"aspect_ratio": "16:9",
"prompt_expansion_mode": "balanced"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Получить детали задачи
https://api.hiapi.ai/v1/tasks/:id Поля ответа
taskIdstringОбязательноИдентификатор задачи, всегда с префиксом tk-hiapi-.
modelstringОбязательноПолное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.
routestringНеобязательноПрисутствует только при явном параметре route; повторяет переданное значение.
statusstringОбязательноСтатус задачи.
queued В очереди, ещё не начата.
handling Обрабатывается.
archiving Обработка завершена, готовятся артефакты.
success Терминальное: завершено, артефакты доступны (возвращается output).
fail Терминальное: ошибка (возвращается error).
После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.
creatednumberОбязательноВремя создания задачи (Unix-секунды).
completednumberОбязательноUnix-секунды терминального состояния; до этого — 0.
outputarrayНеобязательно
Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).
Array [ object ]
Элементы массива
urlstringОбязательноURL артефакта, доступен для скачивания напрямую.
typestringОбязательноТекущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.
expireAtnumberОбязательноUnix-секунды доступности артефакта; скачайте или перенесите до истечения.
errorobjectНеобязательно
Только при status == fail.
codestringОбязательноБизнес-код ошибки.
messagestringОбязательноОписание ошибки.
Примеры ответа
Успех
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Обработка (не финальное)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Ошибка
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Статьи
Все статьи →-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
Похожие модели
Все модели →Тот же тип
-
Wan 3.0 Video Alibaba $0.040 /секунду -
Hailuo 2.3 MiniMax $0.270 /видео -
Gemini Omni Google -- -
PixVerse V6 PixVerse $0.036 /секунду -
Kling 4.0 Kuaishou $0.330 /секунду -
Veo 3.1 Google $0.290 /секунду -
Kling 3.0 Turbo Kuaishou $0.130 /секунду -
Gemini Omni 1.1 Flash Google $0.450 /видео -
Seedance 2.0 ByteDance $0.017 /секунду -
Ray 3.2 Luma $0.214 /видео -
HappyHorse 1.0 Alibaba $0.168 /секунду -
HeyGen Avatar IV HeyGen $0.150 /секунду