Skip to main content
POST

Авторизация

string
обязательно
Все эндпоинты API требуют аутентификации по Bearer TokenПолучение API Key:Перейдите на страницу управления API Key, чтобы получить ваш API KeyДобавьте в заголовок запроса:

Режимы генерации

MiniMax-H3 автоматически выбирает подходящий режим по полям запроса. Поле mode не требуется:
Строгое взаимоисключение: поля image-to-video (first_frame_image / last_frame_image, а также first_frame / last_frame в image_with_roles) нельзя комбинировать с полями мультимодальной ссылки (image_urls, video_urls, audio_urls и reference_image в image_with_roles). Смешивание возвращает 400.
Только аудио использовать нельзя. При передаче audio_urls необходимо также указать хотя бы одно опорное изображение или опорное видео.

Параметры запроса

Общие поля

string
обязательно
Фиксированное значение: MiniMax-H3
Поле model обязательно и должно быть передано явно. Клиенты, уже интегрированные с Hailuo, могут переключиться, установив model в MiniMax-H3.
string
обязательно
Описание содержимого видео. Обязателен и непустой в любом сценарии, максимум 7000 символов на запрос.Подробно описывайте сцену, субъекта, движение и стиль для лучших результатов.Пример: "A boy playing basketball by the sea at dusk, waves crashing, cinematic camera work"
integer
по умолчанию:"5"
Длительность выходного видео (секунды)
  • Диапазон: целое число от 4 до 15
  • По умолчанию: 5
string
по умолчанию:"2K"
Разрешение видео
  • Поддерживаемое значение: только 2K (по умолчанию)
string
Соотношение сторон. Можно также передать size или ratio с тем же эффектом.Допустимые соотношения: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16Поведение в зависимости от сценария описано ниже в разделе «Правила соотношения сторон».
boolean
по умолчанию:"false"
Добавлять ли водяной знак AIGCПо умолчанию: falseСовместимый псевдоним: aigc_watermark
string
URL, на который отправляется уведомление при достижении задачей конечного состояния (успех / ошибка)
Используйте webhook. Не передавайте официальный callback_url. callback_url зарезервирован для внутреннего использования и не принимается от пользователей.

Поля Image-to-Video

Для image-to-video с первым / последним кадром роли нужно указывать явно. Не выводите их из количества элементов в image_urls.
string
URL изображения первого кадраПри передаче изображение используется как начальный кадр видео.
string
URL изображения последнего кадраПри передаче изображение используется как конечный кадр. Комбинируйте с first_frame_image для управления первым+последним кадром.

Поля мультимодальной ссылки

string[]
Массив URL опорных изображений
Каждое изображение в image_urls обрабатывается как опорное (reference_image), независимо от количества. Они никогда не сопоставляются автоматически с первым / первым+последним кадром по длине массива.
  • Количество: ≤ 9
string[]
Массив URL опорных видео
  • Количество: ≤ 3
  • Формат и ограничения: см. «Ограничения входных медиа» ниже
string[]
Массив URL опорного аудио
  • Количество: ≤ 3
  • Нельзя использовать отдельно; необходимо сочетать с опорным изображением или опорным видео

Общий массив изображений (опциональная форма)

object[]
Массив изображений с указанием ролей. Может заменить first_frame_image / last_frame_image / image_urls. Каждый элемент:Пример (первый + последний кадр):
Пример (опорное изображение):

Правила соотношения сторон

Допустимые конкретные соотношения: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.

Ограничения входных медиа

Общий размер тела запроса ≤ 64 MB. Для больших файлов используйте публичные URL; не используйте Base64.

Изображения

Видео (только мультимодальная ссылка)

Аудио (только мультимодальная ссылка)

Ограничения параметров

Нарушения отклоняются с кодом 400 (чувствительный контент может вернуть 422) и не тарифицируются:

Ответ

integer
Код статуса ответа, 200 при успехе
array
Массив данных ответа

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

Сценарий 1: Текст в видео

Сценарий 2: Изображение в видео — первый кадр

Сценарий 3: Изображение в видео — первый + последний кадр

Сценарий 4: Мультимодальная генерация по ссылкам

Сценарий 5: Первый + последний кадр через image_with_roles

Запрос результатов задачиГенерация видео — асинхронная задача, которая при отправке возвращает task_id. Используйте эндпоинт Получение статуса задачи для опроса прогресса и результатов.Рекомендуемый интервал опроса: каждые 5 ~ 10 секунд. Таймаут клиента: 15 минут. При успехе result.videos[0].url — URL mp4. URL видео истекают примерно через 24 часа — сохраняйте их своевременно. За неудачные задачи средства возвращаются автоматически.