MiniMax H3 Max API

MiniMax H3 Max Текст в видео превращает письменный промпт в клип длиной от 5 до 15 целых секунд в 480p или 768p; атмосфера, шумы и музыка генерируются в том же проходе. MiniMax описывает H3 Max как вариант H3 для быстрой генерации. До первого прогона важны два значения по умолчанию: соотношение сторон — 1:1, длительность — 8 секунд. Если формат сдачи известен, задайте оба явно.

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

Шесть форматов кадра, по умолчанию квадрат

aspect_ratio принимает 21:9, 16:9, 4:3, 1:1, 3:4 и 9:16, по умолчанию 1:1 — широкоформатный бриф без этого поля вернётся квадратным. Пример snow-train-window-hands построен под 21:9: поезд пересекает всю ширину кадра, пока две ладони встречаются по разные стороны стекла вагона, — такая композиция не переживёт более квадратной обрезки.

480p для черновиков, 768p для финального дубля

resolution принимает 480p или 768p, по умолчанию 768p. Вариантов 720p, 1080p или 4K нет, и схема отклоняет эти значения ещё до постановки запроса в очередь. 480p дешевле за секунду, поэтому на нём удобно пробовать формулировку, длительность и кадрирование, а дубль, который останется, рендерить в 768p.

Расширение промпта — по желанию

enable_prompt_expansion по умолчанию выключен, и промпт рендерится так, как написан. Если включить, MiniMax сначала разворачивает короткий бриф в более полное описание плана, звука и музыки, могут появиться детали, которых вы не писали, а запрос тарифицируется по ставке расширения промпта. Опубликованные примеры противопоставляют этому конкретику: промпт night-train-beckon называет зелёный бархат, полированную латунь, капокорень ореха, единственную лампу для чтения и точный жест, за которым должна следовать камера.

Мода и рекламные ролики

Пример silver-corridor — кампейн-кадр из одного абзаца: платье цвета жидкого серебра ловит жёсткий контровой свет, волосы развевает ветродуй, а в конце — взгляд прямо в объектив; 21:9, пять секунд, в аудио низкий синтезаторный гул. Движение ткани, свет и финальный взгляд написаны словами — ничего из этого не передавалось изображением.

Ретро-лук, названный по имени

Характер плёнки можно запросить напрямую. Пример roller-rink просит лук 1970-х с сильной ореольностью, выцветшими цветами, толстым зерном и лёгким дрожанием кадра и укладывает двухчастное действие в пять секунд: медленный круг по катку, затем скольжение спиной вперёд к камере с раскинутыми руками.

Этюды материалов и света

Сцены, где несколько поверхностей реагируют на движущийся свет, хорошо ложатся на письменный бриф. В night-train-beckon огни перрона прочерчивают полосы по лицу, атласу и ногам, пока камера наезжает с предельно малой глубиной резкости. Проверяйте таким брифом, читается ли световая идея, прежде чем готовить стартовые кадры для image-to-video.

# 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/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "768p",
    "aspect_ratio": "1:1",
    "duration_seconds": 8,
    "enable_prompt_expansion": false
  }
}'

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