MiniMax-H3 API

Используйте точный идентификатор модели MiniMax-H3. Поле модели должно точно соответствовать этой странице.

Пример выводаMiniMax-H3POST /v1/videos5.2s

Параметры: duration=5resolution=2Kratio=16:9

Промпт: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Запрос, по которому был создан этот образец

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Аутентификация и конечная точка

Используйте ключ API Modelflare с https://modelflare.dev/v1. Точка входа шлюза — POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Создать задачу

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Опрос и загрузка

Сохраните идентификатор задачи. Опросите GET /v1/videos/{task_id} и загрузите с помощью GET /v1/videos/{task_id}/content. Срок действия URL-адресов результатов может истечь, поэтому передайте файл как можно скорее.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Запросить примечания

MiniMax-H3 использует content[] с управляющим выходом resolution, duration и ratio.

Запрос параметров

MiniMax-H3 использует мультимодальный массив content[]. Опросить путь запроса MiniMax после создания задачи; Роли first_frame/last_frame и reference_* — это разные рабочие процессы.

Поле	Обязательно	Примечания
model	Да	MiniMax-H3
content[]	Да	Ровно один элемент text; может включать first_frame, last_frame, reference_image, reference_video или reference_audio
resolution	Да	768P / 2K
duration	Да	4–15 секунд
ratio	Условно	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Условно	Используйте first_frame/last_frame для преобразования изображения в видео и reference_* для эталонных рабочих процессов; не смешивайте группы
content[].url	Нет	Требуется общедоступный URL-адрес HTTP/HTTPS; Носитель Base64 не поддерживается.
aigc_watermark	Нет	Добавлять ли водяной знак
callback_url	Нет	URL обратного вызова для статуса задачи

Пределы ввода и вывода

Выходное разрешение 768P или 2K в течение 4–15 секунд. Для текстовых запросов требуется конкретный ratio; преобразование изображения в видео допускает один первый кадр и один последний кадр, в то время как для эталонных рабочих процессов требуется как минимум одно эталонное изображение или видео, и они не могут использовать только звук. Не смешивайте две ролевые группы.

Документированные примеры рабочих процессов

MiniMax-H3 URL-адреса мультимедиа должны быть общедоступными и не могут использовать Base64; Рабочие процессы первого/конечного кадра и эталонные нельзя смешивать.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Ошибки и невыполненные задачи

Неверные параметры модели возвращают 4xx с идентификатором запроса. Асинхронная задача также может оказаться неудачной после успешного создания; используйте error_code и error_message из ответа на опрос в качестве окончательной причины задачи. Не повторяйте тот же запрос с другой формой JSON.

Поддерживаемая область применения

На этой странице описаны вызовы создания и редактирования модели Modelflare. Поиск или расширение карты, голосовое управление и управление библиотекой элементов — это API-интерфейсы ресурсов, находящиеся за пределами этой общедоступной поверхности вызова модели, и они не являются обязательными полями запроса.

Цены и выставление счетов

В этой модели используется посекундная оплата видео. Текущую цену для клиентов, цену по справочному прейскуранту и полную спецификацию см. на странице цен модели .

Заметка

На этой странице документирован публичный интерфейс Modelflare; показанные здесь поля и ограничения соответствуют текущему контракту.

Варианты

Идентификатор модели	Разница
MiniMax-H3	Модель, описанная на этой странице.