MiniMax H3 Lite API

API MiniMax H3 Lite для генерации видео по референсам создаёт клипы со звуком длиной 4–15 секунд в 480p или 768p по изображениям, видео и аудио. Назовите в промпте каждое изображение, клип и голос и убедитесь, что состав героев работает, прежде чем планировать серию. Облегчённая версия подходит для проверки идей и создания нескольких вариантов. Один запрос даёт ровно один MP4, где изображение и звук создаются одновременно.

Выберите режим по исходным материалам

До 15 референсов

MiniMax H3 Lite принимает в одном запросе до 9 изображений, 3 видеоклипов (15 секунд суммарно) и 3 аудиоклипов. Каждый файл может давать своё: человека, одежду, комнату, движение или голос.

Называйте их в промпте

Ссылайтесь так: «женщина на Image 1», «движение Video 1» и «голос Audio 1». Порядок в списках — это порядок номеров.

Оплата следует за входами

Пять изображений входят в стоимость запроса, каждое следующее добавляет небольшую плату; секунды видеореференсов считаются как секунды результата, а аудио бесплатно.

Сцены из отдельных файлов

Портрет, фото образа и снимок комнаты можно отправить как три изображения, и MiniMax H3 Lite поместит этого человека в эту одежду и в это место, а если персонаж говорит — с аудиоклипом голоса как Audio 1.

Один персонаж в нескольких клипах

Отправляйте один и тот же портрет как Image 1 в каждом запросе, и MiniMax H3 Lite сохраняет лицо и одежду, пока сцена вокруг меняется. Так повторяющийся герой или виртуальный ведущий остаётся узнаваемым на протяжении всей серии клипов.

Перенос движения

Отправьте короткий клип как Video 1 и попросите MiniMax H3 Lite воспроизвести его движение с человеком из Image 1 — для танца, жеста или движения камеры. Короткий и чистый референсный клип делает движение читаемым и снижает счёт, ведь его секунды оплачиваются.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3-lite/reference-to-video",
  "input": {
    "aspect_ratio": "16:9",
    "duration_seconds": 5,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ]
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.