MiniMax H3 Max API

MiniMax H3 Max Изображение в видео оживляет стартовый кадр из image_url, превращая его в клип длиной от 5 до 15 целых секунд в 480p или 768p; звук генерируется в том же проходе. Необязательный last_image_url фиксирует ещё и финальный кадр. Форму вывода задаёт стартовый кадр, а запрос без указанной длительности длится 8 секунд.

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

Кадр задаёт объект, одежду и форму

У этого эндпоинта нет поля соотношения сторон: рамку клипа определяет переданный кадр. В примере laundromat-spin про помещение, одежду и плоский свет люминесцентных ламп не написано ничего — всё это уже решил стартовый кадр. Промпт описывает только то, как машина уходит в отжим, и реакцию героини.

Закрепите оба конца плана

last_image_url добавляет финальный кадр и отправляется только вместе с image_url. Пример frame-to-frame начинается с одной композиции и за восемь секунд приходит к другой, поэтому клип чисто встаёт в монтаж. Финальный кадр ограничивает концовку, а не середину, и два кадра, которые расходятся по свету или одежде, дают заметный торг между ними.

Минимум пять секунд, два разрешения

Длительность — от 5 до 15 целых секунд, по умолчанию 8. resolution принимает 480p или 768p, по умолчанию 768p; 480p дешевле за секунду и подходит для черновиков. Даже самый короткий запрос — уже законченный момент: в клип laundromat-spin за пять секунд помещаются отжим, смех, взмах ногами и взгляд на барабан.

Наклон камеры от предмета к человеку

Одно непрерывное движение камеры делает порядок раскрытия всем брифом. Пример grimoire-to-bare-shoulder начинается с раскрытой книги и за восемь секунд поднимается к читательнице в кресле с высокой спинкой, а свет печатей со страниц скользит по её плечу. Стартовую композицию фиксирует изображение, поэтому промпт тратит слова на то, что камера находит и когда.

Завершить клип на известной композиции

Когда монтаж требует, чтобы клип закончился на определённом кадре, передайте оба. Подготовьте финальный кадр как продолжение стартового и опишите действие, которое их связывает. В frame-to-frame это проход к камере по мраморному коридору, который заканчивается прямым взглядом в объектив, — с жёстким контровым светом, ветродуем и низким синтезаторным гулом.

Оживить сцену со статичной камерой

Статичный общий план может нести сразу несколько мелких движений. Промпт laundromat-spin просит неподвижную камеру, барабан, вращающийся за стеклом, и лампу, которая мигает один раз, вдобавок к реакции героини, а в аудио звучит тихий механический гул.

# 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-max/image-to-video",
  "input": {
    "duration_seconds": 8,
    "enable_prompt_expansion": false,
    "image_url": "https://example.com/reference.png",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p"
  }
}'

# 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.