MiniMax H3 X API

API MiniMax H3 X объединяет доработанную версию H3 с управлением кадрами и мультимодальными референсами, от $0.022/s на SpicyAPI; это не официальный выпуск MiniMax.

Сцена H3 X принимает до 9 изображений, 2 видео общей длительностью 15 секунд и 3 аудиоклипов; роли задавайте через Image 1, Video 1 и Audio 1. В предметной сцене H3 X назначьте отдельные изображения человеку, одежде и помещению, затем опишите их взаимодействие.

Для последовательности H3 X выберите от 2 до 15 целых секунд; по умолчанию задано 5, частота вывода — 24 кадра/с. H3 X предлагает 480p, стандартное 720p и 1080p; сравнение фрагментов на SpicyAPI не показало заметного прироста деталей в файле 1920 x 1088. Для текста и референсов H3 X предлагает стандартное 16:9, а также 9:16, 1:1, 4:3, 3:4 и 21:9; начальное изображение вместо этого определяет форму кадра. H3 X выдаёт H.264 MP4 со стереозвуком AAC; реплики заключайте в двойные кавычки, отдельно описывая звуки окружения.

Все три эндпоинта H3 X относятся к NSFW-видео без цензуры; SpicyAPI не зафиксировал отказов, но часть результатов из текста или начального кадра смягчала запрос. Для H3 X получите согласие людей на использование их внешности и голоса; все изображённые люди должны быть взрослыми.

Порядок референсов H3 X определяет Image 1–Image 9; разделите роли внешности, одежды и декораций, учитывая, что в базовую оплату входят только 5 изображений. H3 X может перенять движение из 2 референсных видео общей длиной до 15 секунд; их длительность оплачивается так же, как выходные секунды. До 3 аудиореференсов задают голос H3 X; файл передаёт тембр, а слова всё равно берутся из промпта, без доплаты за аудиореференс. H3 X оплачивается по выходным секундам и разрешению; секунды референсного видео добавляются, 5 изображений включены, последующие платные, аудиореференсы бесплатны.

В референсных тестах H3 X на SpicyAPI выполнены 5 из 5 запросов с мужскими персонажами; тестовая категория Very strong достигнута в 6 из 8 случаев.

# 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-x/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": "720p",
    "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.