Перейти к содержимому
Зарегистрироваться бесплатно
MiniMax H3

MiniMax H3 Video API: генерация и повторная генерация

Подключите MiniMax H3 с BetterToken API Key и выбирайте поля, материалы и способ генерации по Model ID и операции.

Создавайте видео по тексту, первому и последнему кадрам или референсам. Также можно повторно сгенерировать собственное подходящее видео H3 768p в 2k. Повторная генерация принимает только ID исходной задачи, без новых URL материалов.

Подготовьте BetterToken API Key. Base URL — https://bettertoken.ai/v1, авторизация — Authorization: Bearer YOUR_API_KEY. Копируйте Model ID точно, с учётом регистра.

Каждый request.json ниже использует общий процесс: расчёт, подтверждение создания, опрос и скачивание. Расчёт не запускает генерацию; создание отправляет платную задачу. Актуальная стоимость — в каталоге моделей.

Модели и операции

Таблица показывает допустимые значения по операциям. Значения по умолчанию, количество материалов и ограничения сочетаний приведены в соответствующих разделах. Размеры материалов указаны из расчёта 1 MB = 1048576 байт.

Model IDОперацияДлительность (секунды)Качество выводаПропорцииАудиоРоли материалов
MiniMax-H3image_to_video4–15, шаг 1768p, 2kadaptiveprovider_defaultfirst_frame, last_frame, reference_image, reference_video, reference_audio
MiniMax-H3reference_to_video4–15, шаг 1768p, 2kadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16provider_defaultreference_image, reference_video, reference_audio
MiniMax-H3text_to_video4–15, шаг 1768p, 2k21:9, 16:9, 4:3, 1:1, 3:4, 9:16provider_defaultНет
MiniMax-H3video_editиз исходной задачи2kadaptive (наследуется)provider_defaultID исходной задачи

provider_default сохраняет настройки аудио модели и не предоставляет переключатель on / off. Пропорции, длительность и входные данные повторной генерации определяются исходной задачей.

Примеры материалов

Примеры генерации по изображению и референсу используют синюю керамическую кружку на белом столе. Оставьте пример изображения для проверки или сначала замените его публичным HTTPS-материалом, который вы вправе использовать и который соответствует ограничениям этой страницы.

Референс для генерации видео: синяя керамическая кружка на белом столе

Генерация по тексту

MiniMax-H3

Используйте эту операцию, если у вас есть только текстовое описание.

Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixedfixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительности4
output.aspect_ratiostringДа21:9, 16:9, 4:3, 1:1, 3:4, 9:16Нет
output.formatstringНетmp4mp4
output.resolutionstringНет768p, 2k768p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Эта операция не принимает материалы.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "MiniMax-H3",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "768p",
"aspect_ratio": "16:9"
}
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.

Генерация по изображению

MiniMax-H3

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

Задайте model равным Model ID этого подраздела, а operation — image_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixedfixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительности4
output.aspect_ratiostringНетadaptiveadaptive
output.formatstringНетmp4mp4
output.resolutionstringНет768p, 2k768p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
first_frameimage, необязательно, не более 1jpg, jpeg, png, webp, heic, heifразмер не более 30 MB; ширина 256–5760 px; высота 256–5760 px
last_frameimage, необязательно, не более 1jpg, jpeg, png, webp, heic, heifразмер не более 30 MB; ширина 256–5760 px; высота 256–5760 px
reference_imageimage, необязательно, не более 9jpg, jpeg, png, webp, heic, heifразмер не более 30 MB; ширина 256–5760 px; высота 256–5760 px
reference_videovideo, необязательно, не более 3mp4, movразмер не более 50 MB; ширина 256–5760 px; высота 256–5760 px; длительность 2–15 с; частота кадров не ниже 23.976 fps, и не выше 60 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 3wav, mp3размер не более 15 MB; длительность 2–15 с; всего для этой роли не более 15 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • Передайте хотя бы одну роль: first_frame, last_frame.
  • Нельзя сочетать первый или последний кадр с референсными изображениями, видео или аудио. Для кадров используйте генерацию по изображению, для референсов — генерацию по референсам.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "MiniMax-H3",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "768p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.
mutually_exclusive_rolesИспользуйте первый/последний кадры отдельно от референсов.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

Генерация по референсам

MiniMax-H3

Используйте эту операцию, чтобы сохранить особенности объекта или движения из референсов.

Задайте model равным Model ID этого подраздела, а operation — reference_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.

ПолеТипОбязательноДопустимые значения или диапазонПо умолчанию
audio.modestringНетprovider_defaultprovider_default
duration.modestringНетfixedfixed
duration.secondsintegerНет4–15, шаг 1 с; только для фиксированной длительности4
output.aspect_ratiostringНетadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringНетmp4mp4
output.resolutionstringНет768p, 2k768p
promptstringДастрокаНет
watermarkbooleanНетfalse, truefalse

Требования к материалам

Роль материалаТип и количествоФорматыОграничения на файл
reference_imageimage, необязательно, не более 9jpg, jpeg, png, webp, heic, heifразмер не более 30 MB; ширина 256–5760 px; высота 256–5760 px
reference_videovideo, необязательно, не более 3mp4, movразмер не более 50 MB; ширина 256–5760 px; высота 256–5760 px; длительность 2–15 с; частота кадров не ниже 23.976 fps, и не выше 60 fps; всего для этой роли не более 15 с
reference_audioaudio, необязательно, не более 3wav, mp3размер не более 15 MB; длительность 2–15 с; всего для этой роли не более 15 с

Обязательность материалов также определяется ограничениями сочетаний ниже.

Ограничения сочетаний

  • Для duration.mode="fixed" требуется duration.seconds. При явном указании fixed также задайте число секунд.
  • Передайте хотя бы одну роль: reference_image, reference_video, reference_audio.
  • Нельзя сочетать первый или последний кадр с референсными изображениями, видео или аудио. Для кадров используйте генерацию по изображению, для референсов — генерацию по референсам.

Пример запроса

Сохраните JSON ниже в request.json, затем следуйте общему процессу: сначала расчёт, после подтверждения — создание.

{
"model": "MiniMax-H3",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "768p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

Частые ошибки 422

Код ошибки 422Действие
enum / range / stepИсправьте значения и шаг по таблице полей этого подраздела.
unsupported_fieldУдалите поля, отсутствующие в таблице этой операции.
requiresДобавьте секунды, пропорции, настройки аудио или материалы по ограничениям сочетаний этого подраздела.
mutually_exclusive_rolesИспользуйте первый/последний кадры отдельно от референсов.
count / media_roleИсправьте роли и количество по таблице материалов этого подраздела.
video_input_unsupportedПроверьте публичный HTTPS-адрес, Content-Type и формат файла, затем повторите расчёт.

Повторная генерация видео

MiniMax-H3

Используйте эту операцию, чтобы повторно сгенерировать собственное видео H3 768p в 2k с тем же содержимым. Произвольные видеофайлы не принимаются.

Исходная задача должна соответствовать всем условиям:

  • Принадлежит вашему аккаунту, Model ID — MiniMax-H3.
  • Генерация завершилась успешно, видео ещё доступно для скачивания.
  • Вывод настроен на 768p.
  • С момента создания прошло не более 7 дней.

Сервер также проверяет формат исходного видео. Несоответствие возвращает 422 video_regeneration_source_invalid. Для расчёта используйте ID исходной задачи; не пытайтесь заменить её самостоятельно изменённым видеофайлом.

Поле запросаТипОбязательноЗначение
modelstringДаMiniMax-H3
operationstringДаvideo_edit
provider_options.hailuo.source_task_idstringДаID вашей подходящей исходной задачи
watermarkbooleanНетfalse / true, по умолчанию false

Не передавайте prompt, duration, output, audio или media. Повторная генерация наследует содержимое и входные данные исходной задачи; результат — 2k, adaptive, MP4.

Замените REPLACE_WITH_YOUR_H3_TASK_ID на ID своей исходной задачи до расчёта и создания. Будет создана новая платная задача, поэтому используйте новый файл состояния.

{
"model": "MiniMax-H3",
"operation": "video_edit",
"provider_options": {
"hailuo": {
"source_task_id": "REPLACE_WITH_YOUR_H3_TASK_ID"
}
}
}

Если исходная задача не подходит или не существует, расчёт вернёт 422 video_regeneration_source_invalid, где field_path — provider_options.hailuo.source_task_id. Следующий пример помогает распознать эту ошибку и не подходит для генерации:

{
"model": "MiniMax-H3",
"operation": "video_edit",
"provider_options": {
"hailuo": {
"source_task_id": "video_DOES_NOT_EXIST"
}
}
}

Официальные материалы

При обращении к BetterToken используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.