MiniMax
MiniMax H3
minimax-h3
Универсальная мультимодальная видеомодель: в одном контексте одновременно обрабатывает текст, изображения, видео и аудио, поддерживает генерацию видео из текста, из изображения, по референсу и редактирование по инструкции, а также создание синхронизированного аудио
Попробовать minimax-h3
Ввод
Работы
Все работыВывод
videoЦены
minimax-h3 per second
| Цена за единицу | $0.1189 |
|---|
Краткое описание позиционирования
MiniMax H3 — это универсальная модель генерации видео от MiniMax, которая в едином контексте одновременно обрабатывает текст, изображения, видео и аудио, поддерживает преобразование текста в видео, изображения в видео, управление первым и последним кадром, генерацию видео по мультимодальным референсам, а также выдаёт нативное 2K-изображение. Вызов через унифицированный интерфейс HiAPI.ai подходит разработчикам, которым нужна одна модель для раскадровки, анимации материалов и коротких роликов с единообразием стиля персонажей, и особенно командам, совмещающим в едином рабочем процессе несколько режимов генерации.
Ключевые особенности
- Единый контекст для мультимодального ввода — в рамках одной модели можно комбинировать текстовые, графические, видео- и аудиореференсы, снижая затраты на переключение между специализированными моделями для разных задач.
- Нативный вывод 2K — в настоящее время генерация выполняется только в нативном разрешении 2K, формат кадра охватывает от 21:9 до 9:16 и адаптивный, что отвечает требованиям размещения в горизонтальной и вертикальной ориентации.
- Управление переходом кадра через первый и последний кадры — задав изображения первого и последнего кадра, можно управлять переходом между двумя изображениями, что удобно для создания переходов и кадров «до/после».
- Согласованность за счёт мультимодальных референсов — поддерживается до 5 референсных изображений, 3 референсных видео и 3 референсных аудио для продолжения персонажей, стиля и ритма.
Описание возможностей
Текст в видео: по одному текстовому запросу генерируется видео длительностью от 4 до 15 секунд с шагом в 1 секунду; формат кадра — 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 или адаптивный, по умолчанию 16:9.
Изображение в видео и управление первым/последним кадром: видео генерируется по одному публичному изображению в качестве первого кадра либо с одновременной подачей первого и последнего кадров для управления переходом; управление кадрами и поля референсных медиа взаимоисключающие, поэтому линию нужно определять заранее.
Генерация видео по мультимодальным референсам: принимает до 5 референсных изображений, 3 референсных видео длительностью 2–15 секунд и до 3 референсных аудио общей длительностью не более 15 секунд; аудио нельзя использовать отдельно — оно должно сопровождаться хотя бы одним изображением или одним видео.
Необязательный водяной знак AIGC: параметр watermark определяет, будет ли на выходном видео водяной знак AIGC; по умолчанию он не добавляется, что позволяет переключаться в соответствии с требованиями каналов публикации.
Сценарии применения
- Быстрая раскадровка рекламными командами по текстовым запросам — генерация фрагментов длительностью 4–15 секунд по многокадровым запросам в качестве материалов для предварительной раскадровки при креативной оценке и презентациях клиентам.
- Анимация товарных изображений в короткие ролики для e-commerce дизайна — генерация 2K-видео по товарному изображению или иллюстрации в качестве первого кадра для непосредственного использования в карточках товаров и материалах для ленты.
- Создание переходов контент-мейкерами с помощью первого и последнего кадров — управление переходом по двум заданным изображениям «до/после» для получения переходных кадров в монтаже коротких видео или демонстрациях сравнения.
- Генерация коротких роликов с единообразием персонажей по мультимодальным референсам — комбинирование изображений персонажей, стилевых видео и референсных аудио для создания фрагментов в едином стиле при серийном производстве контента.
Ограничения и рекомендации по выбору
Максимальная длительность одного поколения — 15 секунд; более длинный контент нужно генерировать по частям и затем склеивать. Управление первым/последним кадром и поля референсных медиа нельзя смешивать; в режиме референсов необходимо по правилам организовывать ввод изображений, видео и аудио, что создаёт определённый порог при составлении запросов; референсное аудио нельзя использовать отдельно. Если задача требует непрерывного длинного кадра более 15 секунд, разрешения ниже 2K или более простого процесса генерации только по тексту, стоит рассмотреть другие линии или модели.
Новости
Смотреть 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
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для minimax-h3 и маршрута default — см. таблицу параметров ниже.
promptstringОбязательноminLength 1maxLength 7000Текстовый промпт содержания видео; обязателен для всех режимов генерации, максимальная длина 7000 символов.
durationintegerНеобязательноПо умолчанию: 5min 4max 15Длительность генерируемого видео в целых секундах, по умолчанию 5 секунд.
watermarkbooleanНеобязательноПо умолчанию: falseДобавлять ли водяной знак AIGC в сгенерированное видео; логическое значение, по умолчанию false.
audio_urlsarrayНеобязательноmaxItems 3Массив URL референсных аудио; не более трёх фрагментов общей длительностью не более 15 секунд; аудио нельзя использовать отдельно, необходимо хотя бы одно референсное изображение или одно референсное видео.
Array [ string ]
image_urlsarrayНеобязательноmaxItems 5Массив URL референсных изображений для мультимодальной генерации видео по референсам; HiAPI принимает не более пяти изображений; нельзя использовать одновременно с управлением первым и последним кадрами.
Array [ string ]
resolutionstringНеобязательноПо умолчанию: "2K"Выходное разрешение; MiniMax H3 в настоящее время поддерживает только нативную генерацию 2K, по умолчанию 2K.
2Kvideo_urlsarrayНеобязательноmaxItems 3Массив URL референсных видео для мультимодальной генерации видео по референсам; не более трёх фрагментов, каждый длительностью 2–15 секунд, общая длительность не более 15 секунд.
Array [ string ]
aspect_ratiostringНеобязательноПо умолчанию: "16:9"Соотношение сторон выходного изображения, по умолчанию 16:9; для генерации видео по тексту по умолчанию используется 16:9, для видео с управлением первым и последним кадрами — как у входного изображения, в режиме референсов возможна адаптивная подстройка.
21:916:94:31:13:49:16adaptivelast_frame_imagestringНеобязательноПубличный URL изображения, используемого в качестве последнего кадра; необходимо также указать first_frame_image.
first_frame_imagestringНеобязательноПубличный URL изображения, используемого в качестве первого кадра; управление первым и последним кадрами нельзя использовать одновременно с полями референсных медиа; обязателен при указании last_frame_image.
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите 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",
"input": {
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "2K",
"aspect_ratio": "16:9"
}
}' 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",
input: {
"prompt": "…",
"duration": 5,
"watermark": false,
"resolution": "2K",
"aspect_ratio": "16:9"
}
}),
});
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",
"input": {
"prompt": "…",
"duration": 5,
"watermark": False,
"resolution": "2K",
"aspect_ratio": "16:9"
}
},
)
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"
}
}
} Статьи
Все статьи →-
Руководство
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 — горизонтальное сравнение: как выбрать модель «изображение в видео» и что учесть при миграции
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
-
Сравнительный обзор
Recraft v4.1 Flash 文生图横向对比:开发者选型与迁移指南
用每张 $0.01 的成本与纯文生图能力,判断它是否适合你的图像生成流水线
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Практика генерации изображений по тексту с recraft-v4.1-flash: 5 ценных бизнес-сценариев и ключевые моменты интеграции
Отталкиваясь от стоимости $0.01 за изображение, спланируйте внедрение генерации изображений в реальные бизнес-процессы
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
Похожие модели
Все модели →Тот же тип
-
Veo 3.1 Fast Google $0.170 /секунду -
Kandinsky 6.0 Pro $1.93 /видео -
HappyHorse 1.0 Alibaba $0.168 /секунду -
HeyGen Avatar IV HeyGen $0.150 /секунду -
Kling 4.0 Kuaishou $0.330 /секунду -
FLUX 3 Max Black Forest Labs $0.061 /секунду -
Kling 2.5 Kuaishou $0.060 /секунду -
Seedance 2.0 ByteDance $0.017 /секунду -
Grok Imagine 1.5 xAI $0.011 /секунду -
HeyGen Avatar V HeyGen $0.150 /секунду -
Gemini Omni 1.1 Flash Google $0.450 /видео -
Gemini Omni Google --


