MiniMax H3: справочник по API

С одним ключом PopNow API вы вызываете MiniMax H3 прямо из своего кода. Здесь собраны ID модели, которые нужно передать, все поля, которые она принимает, стоимость запроса в кредитах и готовый запрос — его можно вставить в терминал и запустить.

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

Кратко

Разработчик: MiniMax
Результат: Видео
От: 5.55 кр. за секунду результата ($0.0555)
Обычное время: около 33 с
ID модели: minimax/h3/text-to-video
minimax/h3/image-to-video
minimax/h3/reference-to-video
minimax/h3/video-extend

1 кредит = 0,01 $. При приёме задачи резервируется максимально возможная сумма, а после завершения списывается фактический расход с округлением вверх до целого кредита; остаток возвращается. За задачи, завершившиеся ошибкой, плата не взимается. Точную сумму до запуска покажет POST /api/v1/jobs/quote.

Создать видео

minimax/h3/text-to-video

Цена

Вариант	Кредиты (за секунду результата)	Доллары США
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Параметры

Поле	Тип	По умолчанию	Допустимые значения	Назначение
`prompt`Обязательно	`string`	—	до 7 000 символов	Describe the picture, the action, the camera, the sound, and the boundaries for the shot.
`aspect_ratio`Необязательно	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9	Output aspect ratio.
`resolution`Необязательно	`string`	`768p`	768p, 2k	Output resolution.
`duration_seconds`Необязательно	`integer`	`5`	от 5 до 15	Requested output length in seconds.
`enable_prompt_expansion`Необязательно	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

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

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Видео из картинки

minimax/h3/image-to-video

Цена

Вариант	Кредиты (за секунду результата)	Доллары США
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Параметры

Поле	Тип	По умолчанию	Допустимые значения	Назначение
`prompt`Обязательно	`string`	—	до 7 000 символов	Describe what happens after the opening frame: the action, the camera, and the sound.
`image_url`Обязательно	`string (uri)`	—	—	Authorised opening frame.
`last_image_url`Необязательно	`string (uri)`	—	—	Optional closing frame the clip should resolve to.
`resolution`Необязательно	`string`	`768p`	768p, 2k	Output resolution.
`duration_seconds`Необязательно	`integer`	`5`	от 4 до 15	Requested output length in seconds.
`enable_prompt_expansion`Необязательно	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

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

В примере в image_url стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Видео по референсам

minimax/h3/reference-to-video

Цена

Вариант	Кредиты (за секунду результата)	Доллары США
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Параметры

Поле	Тип	По умолчанию	Допустимые значения	Назначение
`prompt`Обязательно	`string`	—	до 7 000 символов	Refer to the references by number and describe the shot they should produce.
`reference_image_urls`Обязательно	`array<string (uri)>`	—	до 9 элементов	Authorised image references, up to nine.
`reference_video_urls`Необязательно	`array<string (uri)>`	—	до 3 элементов	Up to three reference videos, 2 to 15 seconds each and 15 seconds in total. Refer to them in the prompt as <Video 1> and so on. Their seconds have their own per-second rate, lower than output seconds.
`reference_audio_urls`Необязательно	`array<string (uri)>`	—	до 3 элементов	Up to three reference audio clips (WAV or MP3), 2 to 15 seconds each and 15 seconds in total, for a voice or a sound.
`aspect_ratio`Необязательно	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9	Output aspect ratio.
`resolution`Необязательно	`string`	`768p`	768p, 2k	Output resolution.
`duration_seconds`Необязательно	`integer`	`5`	от 4 до 15	Requested output length in seconds.
`enable_prompt_expansion`Необязательно	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

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

В примере в reference_image_urls стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Продлить видео

minimax/h3/video-extend

Цена

Вариант	Кредиты (за секунду результата)	Доллары США
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Параметры

Поле	Тип	По умолчанию	Допустимые значения	Назначение
`prompt`Обязательно	`string`	—	до 7 000 символов	Describe what happens next: the action that follows, the camera move and the sound.
`video_url`Обязательно	`string (uri)`	—	—	The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
`last_image_url`Необязательно	`string (uri)`	—	—	Optional target end frame: the new segment closes on this image.
`resolution`Необязательно	`string`	`768p`	768p, 2k	Resolution of the new segment. It sets how sharp the new part is generated; match your source clip.
`duration_seconds`Необязательно	`integer`	`5`	от 4 до 15	Length of the new segment in seconds, from 4 to 15. The source clip is added on top and is not billed.
`enable_prompt_expansion`Необязательно	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

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

В примере в video_url стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

MiniMax H3: справочник по API

Кратко

Создать видео

Цена

Параметры

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

Видео из картинки

Цена

Параметры

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

Видео по референсам

Цена

Параметры

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

Продлить видео

Цена

Параметры

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

Что дальше

На этой странице