MiniMax
MiniMax H3 Max Turbo
minimax-h3-max-turbo/text-to-video
Скоростная версия видеомодели MiniMax, поддерживает генерацию видео из текста и из изображения (можно указать первый кадр и опциональный последний кадр), создаёт за один раз фрагменты длительностью от 1 до 15 секунд и разрешением от 480P до 1080P, подходит для быстрой подготовки коротких маркетинговых роликов и превизуализации раскадровок
Попробовать minimax-h3-max-turbo/text-to-video
Ввод
Работы
Все работыВывод
videoЦены
minimax-h3-max-turbo/text-to-video per second
| Характеристики | Цена за единицу |
|---|---|
| 480P | $0.025 |
| 768P | $0.040 |
| 1080P | $0.080 |
Краткое описание
Это модель текст-в-видео: она принимает текстовое описание и сразу генерирует видеоклип. За один раз можно создать ролик длительностью от 1 до 15 секунд; доступны три разрешения — 480P, 768P и 1080P — и шесть соотношений сторон: 21:9, 16:9, 4:3, 1:1, 3:4 и 9:16. Промпт может содержать до 50 000 символов, также можно задать случайное зерно для воспроизводимости. Модель подходит для быстрой пакетной генерации коротких маркетинговых роликов, раскадровок-превизуализаций и контента для соцсетей — везде, где динамичное изображение нужно создать с нуля.
Ключевые особенности
- Видео напрямую из текста длительностью до 15 секунд — длительность задаётся в диапазоне от 1 до 15 секунд, итоговый ролик может быть примерно на 0,7 секунды длиннее запрошенного; подходит для самостоятельных коротких клипов.
- Три разрешения и шесть форматов кадра — 480P, 768P и 1080P выбираются по потребности, а шесть соотношений сторон, включая горизонтальные и вертикальные, покрывают основные площадки публикации.
- Регулируемое расширение промпта — режим disabled пропускает переписывание, balanced возвращает результат примерно за секунду, quality может работать до ~30 секунд и создавать более насыщенный промпт.
Возможности
Генерация видео по текстовому описанию: достаточно ввести текстовый промпт, чтобы получить видеоклип; промпт может содержать до 50 000 символов. Подходит для случаев, когда готовых материалов нет и изображение нужно построить с нуля.
Выбор длительности и разрешения: в каждом запросе выбирается длительность от 1 до 15 секунд и одно из разрешений — 480P, 768P или 1080P, что позволяет балансировать детализацию и характеристики под задачу.
Шесть соотношений сторон: можно выбрать 21:9, 16:9, 4:3, 1:1, 3:4 или 9:16 — под горизонтальное воспроизведение, квадратную ленту и вертикальные короткие видео на разных площадках.
Управление зерном и расширением промпта: можно задать случайное зерно, чтобы зафиксировать точку старта генерации; расширение промпта поддерживает три режима — выключено, сбалансированный и высококачественный, — и выбирается с учётом темпа генерации.
Сценарии применения
- Быстрое создание нескольких версий коротких роликов маркетинговой командой — по текстовому описанию преимуществ продукта или темы кампании генерируется пакет кандидатных клипов для сравнения материалов перед запуском в соцсетях.
- Вертикальный контент для авторов соцсетей — описание сцены в формате 9:16 и с короткой длительностью даёт клипы, которые можно сразу публиковать на платформах коротких видео.
- Динамическая превизуализация раскадровок на этапе препродакшена — по тексту сценария раскадровки генерируются динамичные наброски, помогающие режиссёру и художникам до начала основного производства проверить ритм кадра и композицию.
- Проверка рекламных креативных концепций — краткое текстовое описание идеи и быстрая генерация с небольшой длительностью позволяют показать клиенту динамическое направление, а не финальный ролик.
Ограничения и рекомендации по выбору
Диапазон длительности — от 1 до 15 секунд, итоговый ролик может быть примерно на 0,7 секунды длиннее запрошенного; 1080P является потенциальным апскейлом из нативного источника 768P, а не нативной генерацией. Промпт может содержать до 50 000 символов. Модель поддерживает только генерацию видео из текста, не может использовать референсные изображения, фрагменты видео или аудио для сохранения единообразия персонажей и стиля, а также не обладает возможностями видеоредактирования.
Новости
Смотреть changelog →- Новая модель MiniMax H3 Max Turbo запущен: генерация видео по тексту и из изображений с первым и последним кадром
Частые вопросы
Все частые вопросы →-
Этот 1080P у модели генерируется нативно?
Это не нативная генерация: 1080P получается путём доработки в латентном пространстве из источника 768P; максимальный нативный уровень генерации модели — 768P. Если к детализации изображения предъявляются жёсткие требования, рекомендуется оценивать по нативной генерации 768P или перейти на уровень, поддерживающий мастер-версию 2K.
-
Можно ли при генерации видео из изображения зафиксировать персонажа с помощью референсного изображения?
В настоящее время генерация видео по референсному изображению не поддерживается. image_url используется только как начальный кадр: холст генерации следует за этим изображением, и зафиксировать персонажа и стиль с помощью референсного изображения, референсного фрагмента или аудио невозможно. В сценариях, где требуется согласованность персонажа, следует перейти на тариф, поддерживающий генерацию видео по референсному изображению.
-
Как настроить первый и последний кадры, чтобы контролировать точку окончания движения камеры?
Используйте image_url, чтобы задать первый кадр, и необязательный end_image_url, чтобы задать последний кадр; модель достроит движение между ними. Первый кадр определяет всё выходное полотно, поэтому композиция и пропорции последнего кадра должны быть близки к первому, иначе при интерполяции легко возникают деформации.
-
Может ли длительность сгенерированного видео превышать 15 секунд?
Одно поколение длится максимум 15 секунд, за один раз создать более длинный фрагмент невозможно. Фактический результат может быть примерно на 0.7 секунды длиннее, чем указанное значение duration. Если нужен более длинный итоговый ролик, генерируйте его по кадрам по отдельности, а затем склеивайте.
Создать задачу генерации
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-turbo/text-to-video
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для minimax-h3-max-turbo/text-to-video и маршрута default — см. таблицу параметров ниже.
seedintegerНеобязательноСлучайное зерно для управления случайностью результата генерации; если не указано, система автоматически выберет случайное зерно.
promptstringОбязательноminLength 1maxLength 50000Текстовый промпт для генерации видео, описывающий желаемое содержимое кадра.
durationnumberНеобязательноПо умолчанию: 5min 1max 15Длительность видео (в секундах), можно задать от 1 до 15 секунд, по умолчанию 5 секунд; фактический результат может быть примерно на 0,7 секунды длиннее запрошенного значения. При использовании target_audio_url длительность должна быть не менее 2 секунд.
resolutionstringНеобязательноПо умолчанию: "768P"Разрешение генерации: 480P, 768P или 1080P, по умолчанию 768P; 1080P — это доработка в латентном пространстве из нативного источника 768P, а не нативная генерация.
480P768P1080Paspect_ratiostringНеобязательноПо умолчанию: "16:9"Соотношение сторон генерируемого видео: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, по умолчанию 16:9.
21:916:94:31:13:49:16target_audio_urlstringНеобязательноНеобязательно: URL аудио длительностью не менее 2 секунд и размером не более 15 МБ, используемого для фиксации звуковой дорожки генерируемого видео.
prompt_expansion_modestringНеобязательноПо умолчанию: "balanced"Интенсивность переработки промпта перед генерацией, по умолчанию balanced. disabled — пропустить расширение промпта; balanced — ответ примерно за 1 секунду; quality — до примерно 30 секунд для создания более богатого промпта.
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-turbo/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-turbo/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-turbo/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"
}
}
} Статьи
Все статьи →Похожие модели
Все модели →Тот же тип
-
Kling 3.0 Turbo Kuaishou $0.144 /секунду -
Muse Video 1.0 Meta $0.034 /видео -
FLUX 3 Video Black Forest Labs $0.090 /секунду -
PixVerse V6 Max PixVerse $0.030 /секунду -
HeyGen Avatar V HeyGen $0.150 /секунду -
Kling 4.0 Flash Kuaishou $0.122 /секунду -
P-Video 2 Pro Avatar Pruna AI $0.029 /секунду -
Wan 3.0 Video Alibaba $0.040 /секунду -
Veo 3.1 Lite Google $0.060 /секунду -
HappyHorse 1.0 Alibaba $0.168 /секунду -
Grok Imagine 1.5 xAI $0.011 /секунду -
MiniMax H3 Max Turbo MiniMax $0.025 /секунду