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-H3 | image_to_video | 4–15, шаг 1 | 768p, 2k | adaptive | provider_default | first_frame, last_frame, reference_image, reference_video, reference_audio |
MiniMax-H3 | reference_to_video | 4–15, шаг 1 | 768p, 2k | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | reference_image, reference_video, reference_audio |
MiniMax-H3 | text_to_video | 4–15, шаг 1 | 768p, 2k | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | Нет |
MiniMax-H3 | video_edit | из исходной задачи | 2k | adaptive (наследуется) | provider_default | ID исходной задачи |
provider_default сохраняет настройки аудио модели и не предоставляет переключатель on / off. Пропорции, длительность и входные данные повторной генерации определяются исходной задачей.
Примеры материалов
Примеры генерации по изображению и референсу используют синюю керамическую кружку на белом столе. Оставьте пример изображения для проверки или сначала замените его публичным HTTPS-материалом, который вы вправе использовать и который соответствует ограничениям этой страницы.

Генерация по тексту
MiniMax-H3
Используйте эту операцию, если у вас есть только текстовое описание.
Задайте model равным Model ID этого подраздела, а operation — text_to_video. Используйте только поля генерации из таблицы ниже. Материалы передавайте в массиве media.
| Поле | Тип | Обязательно | Допустимые значения или диапазон | По умолчанию |
|---|---|---|---|---|
audio.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | 4 |
output.aspect_ratio | string | Да | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Нет |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 768p, 2k | 768p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
Эта операция не принимает материалы.
Ограничения сочетаний
- Для
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.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | 4 |
output.aspect_ratio | string | Нет | adaptive | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 768p, 2k | 768p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
first_frame | image, необязательно, не более 1 | jpg, jpeg, png, webp, heic, heif | размер не более 30 MB; ширина 256–5760 px; высота 256–5760 px |
last_frame | image, необязательно, не более 1 | jpg, jpeg, png, webp, heic, heif | размер не более 30 MB; ширина 256–5760 px; высота 256–5760 px |
reference_image | image, необязательно, не более 9 | jpg, jpeg, png, webp, heic, heif | размер не более 30 MB; ширина 256–5760 px; высота 256–5760 px |
reference_video | video, необязательно, не более 3 | mp4, mov | размер не более 50 MB; ширина 256–5760 px; высота 256–5760 px; длительность 2–15 с; частота кадров не ниже 23.976 fps, и не выше 60 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 3 | wav, 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.mode | string | Нет | provider_default | provider_default |
duration.mode | string | Нет | fixed | fixed |
duration.seconds | integer | Нет | 4–15, шаг 1 с; только для фиксированной длительности | 4 |
output.aspect_ratio | string | Нет | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Нет | mp4 | mp4 |
output.resolution | string | Нет | 768p, 2k | 768p |
prompt | string | Да | строка | Нет |
watermark | boolean | Нет | false, true | false |
Требования к материалам
| Роль материала | Тип и количество | Форматы | Ограничения на файл |
|---|---|---|---|
reference_image | image, необязательно, не более 9 | jpg, jpeg, png, webp, heic, heif | размер не более 30 MB; ширина 256–5760 px; высота 256–5760 px |
reference_video | video, необязательно, не более 3 | mp4, mov | размер не более 50 MB; ширина 256–5760 px; высота 256–5760 px; длительность 2–15 с; частота кадров не ниже 23.976 fps, и не выше 60 fps; всего для этой роли не более 15 с |
reference_audio | audio, необязательно, не более 3 | wav, 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 исходной задачи; не пытайтесь заменить её самостоятельно изменённым видеофайлом.
| Поле запроса | Тип | Обязательно | Значение |
|---|---|---|---|
model | string | Да | MiniMax-H3 |
operation | string | Да | video_edit |
provider_options.hailuo.source_task_id | string | Да | ID вашей подходящей исходной задачи |
watermark | boolean | Нет | 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 используйте поля этой страницы и соответствующую операцию из актуального каталога моделей.

