MiniMax

MiniMax H3 Max Turbo

minimax-h3-max-turbo/image-to-video

Скоростная версия видеомодели MiniMax, поддерживает генерацию видео из текста и из изображения (можно указать первый кадр и опциональный последний кадр), создаёт за один раз фрагменты длительностью от 1 до 15 секунд и разрешением от 480P до 1080P, подходит для быстрой подготовки коротких маркетинговых роликов и превизуализации раскадровок

minimax-h3-max-turbo/image-to-video minimax-h3-max-turbo/text-to-video

Попробовать minimax-h3-max-turbo/image-to-video

Ввод

Работы

Все работы

Вывод

video

Заполните параметры и сгенерируйте — результаты появятся здесь.

Неоновый дождь ночью · переход между начальным и конечным кадром на уличном углу

Стиль Кинематографичный · Городская ночь · neon

Референсные входы

Изображение первого кадра
Изображение последнего кадра

Промпт

Кинематографичный кадр ночного городского перекрёстка под дождём: начните с низкого угла над мокрым чёрным асфальтом, неоновые вывески круглосуточного магазина размываются в лужах красными и бирюзовыми отражениями, группа прохожих с зонтами пересекает кадр, затем камера поднимается и скользит вдоль тротуара к перекрёстку, в световых конусах уличных фонарей видны капли дождя, шины шипят по мокрому покрытию, камера в итоге останавливается на потоке машин, стоящих на красный свет, а из подземного перехода вдали льётся тёплый янтарный свет. Медленный наезд с постепенным ускорением, малая глубина резкости, плёночное зерно, естественное уличное освещение, холодные синие тени контрастируют с тёплым светом витрин.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

minimax-h3-max-turbo/image-to-video per second

Характеристики	Цена за единицу
480P	$0.025
768P	$0.040
1080P	$0.080

Краткое описание

Генерирует видеоклип, используя одно изображение в качестве первого кадра; соотношение сторон выходного холста соответствует входному изображению. Подходит разработчикам, которым нужно превратить статичное изображение в динамичный короткий ролик, — для быстрого создания контента для соцсетей, динамичной раскадровки рекламы или анимированного показа графических материалов. Поддерживает опциональное изображение последнего кадра для ограничения финального изображения, а также управление результатом через промпт, длительность и разрешение.

Ключевые особенности

Генерация на основе первого кадра — загрузите изображение как первый кадр, и выходной видеохолст унаследует его пропорции, сохраняя ту же отправную композицию.
Опциональное ограничение последним кадром — дополнительно укажите изображение конечного кадра, чтобы финальный кадр видео сходился к заданному изображению; подходит для переходов или стоп-кадрового завершения.
Настраиваемые длительность и разрешение — длительность одного прохода выбирается от 1 до 15 секунд, разрешение — одно из трёх: 480P, 768P или 1080P.
Управляемый и воспроизводимый seed — параметр seed фиксирует случайное зерно, что упрощает воспроизведение или тонкую настройку одного и того же направления изображения при пакетной генерации.

Описание возможностей

Видео из первого кадра: укажите первое изображение в image_url и сгенерируйте динамичное видео вместе с prompt; выходной холст наследует пропорции этого изображения, что подходит для превращения статичной картинки в динамичный фрагмент.

Ограничение последним кадром: помимо первого кадра можно дополнительно передать end_image_url как конечный кадр, чтобы финальное изображение видео приближалось к заданному изображению; используется для переходов или стоп-кадровых планов.

Управление длительностью и разрешением: duration задаётся в диапазоне от 1 до 15 секунд, фактический вывод может быть примерно на 0,7 секунды длиннее запрошенного; resolution — одно из трёх значений: 480P, 768P или 1080P, где 1080P получается апскейлом и доработкой нативного результата 768P.

Настройка расширения промпта: prompt_expansion_mode может быть disabled, balanced или quality — соответственно пропуск расширения, быстрый возврат или примерно 30 секунд на генерацию более богатого промпта, что помогает управлять детализацией генерации.

Сценарии применения

Анимирование изображений для соцсетей — специалисты по контенту используют изображение продукта или постер как первый кадр и вместе с коротким промптом быстро создают динамичный короткий ролик для публикации в соцсетях или в ленте.
Динамичная раскадровка рекламы — команды предпродакшена рекламы или кино используют ключевые кадры плюс изображение последнего кадра для создания переходных фрагментов как динамичной раскадровки для внутренних презентаций или съёмочных референсов.
Превращение графики в видеоклипы — авторы контента берут фотографию или иллюстрацию как первый кадр и создают динамичный ролик длительностью несколько секунд для портфолио или переходных планов в монтаже.
Создание стоп-кадрового финального плана — двумя изображениями, первым и последним кадром, задаются начало и конец, и создаётся ролик с переходом от начального изображения к заданному конечному — для стоп-кадровых эффектов в начале или конце видео.

Ограничения и рекомендации по выбору

Первое изображение image_url обязательно; генерация только по тексту не поддерживается. Изображение последнего кадра — опциональное ограничение, точное схождение изображения к нему не гарантируется. При выборе resolution 1080P вывод получается апскейлом и доработкой нативного результата 768P, а не нативной генерацией 1080P. duration задаётся от 1 до 15 секунд, фактический вывод может быть примерно на 0,7 секунды длиннее запрошенного. Промпт — до 50000 символов, ссылка на изображение — до 50000 символов. Абсолютное постоянство персонажей или точное воспроизведение изображения не гарантируются.

Новости

Смотреть changelog →

Новая модель MiniMax H3 Max Turbo запущен: генерация видео по тексту и из изображений с первым и последним кадром Nov 12, 2026

Частые вопросы

Все частые вопросы →

Этот 1080P у модели генерируется нативно?

Это не нативная генерация: 1080P получается путём доработки в латентном пространстве из источника 768P; максимальный нативный уровень генерации модели — 768P. Если к детализации изображения предъявляются жёсткие требования, рекомендуется оценивать по нативной генерации 768P или перейти на уровень, поддерживающий мастер-версию 2K.
Можно ли при генерации видео из изображения зафиксировать персонажа с помощью референсного изображения?

В настоящее время генерация видео по референсному изображению не поддерживается. image_url используется только как начальный кадр: холст генерации следует за этим изображением, и зафиксировать персонажа и стиль с помощью референсного изображения, референсного фрагмента или аудио невозможно. В сценариях, где требуется согласованность персонажа, следует перейти на тариф, поддерживающий генерацию видео по референсному изображению.
Как настроить первый и последний кадры, чтобы контролировать точку окончания движения камеры?

Используйте image_url, чтобы задать первый кадр, и необязательный end_image_url, чтобы задать последний кадр; модель достроит движение между ними. Первый кадр определяет всё выходное полотно, поэтому композиция и пропорции последнего кадра должны быть близки к первому, иначе при интерполяции легко возникают деформации.
Может ли длительность сгенерированного видео превышать 15 секунд?

Одно поколение длится максимум 15 секунд, за один раз создать более длинный фрагмент невозможно. Фактический результат может быть примерно на 0.7 секунды длиннее, чем указанное значение duration. Если нужен более длинный итоговый ролик, генерируйте его по кадрам по отдельности, а затем склеивайте.

Создать задачу генерации

POST 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/image-to-video

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для minimax-h3-max-turbo/image-to-video и маршрута default — см. таблицу параметров ниже.

seedintegerНеобязательно

Случайное зерно для управления случайностью результата генерации; если не указано, выбирается автоматически.

promptstringОбязательноminLength 1maxLength 50000

Текстовый промпт для генерации видео.

durationnumberНеобязательноПо умолчанию: 5min 1max 15

Длительность видео в секундах, по умолчанию 5 секунд; фактический результат может быть примерно на 0,7 секунды длиннее запрошенного значения. При указании target_audio_url длительность должна быть не менее 2 секунд.

image_urlstringОбязательноmaxLength 50000

URL изображения, используемого в качестве первого кадра; выходной холст будет соответствовать этому изображению.

resolutionstringНеобязательноПо умолчанию: "768P"

Разрешение генерации, по умолчанию 768P; можно также указать 1080P, в этом случае выполняется уточнение в латентном пространстве из исходного разрешения 768P.

Варианты:480P768P1080P

end_image_urlstringНеобязательно

Необязательно: URL изображения, используемого в качестве последнего кадра.

target_audio_urlstringНеобязательно

Необязательно: URL аудиофрагмента, который закрепляется за генерируемым саундтреком; аудио должно длиться не менее 2 секунд, максимальный размер — 15 MB.

prompt_expansion_modestringНеобязательноПо умолчанию: "balanced"

Степень переработки промпта перед генерацией, по умолчанию balanced: disabled пропускает расширение промпта, balanced возвращает результат примерно за 1 секунду, quality тратит до примерно 30 секунд на создание более подробного промпта.

Варианты:disabledbalancedquality

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "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/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_url": "…",
    "resolution": "768P",
    "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/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_url": "…",
      "resolution": "768P",
      "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/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_url": "…",
          "resolution": "768P",
          "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"
}

Получить детали задачи

GET 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"
    }
  }
}