API docs / Video models

MiniMax H3 Max (Text to video) API

Create a 5-15 second 480P or 768P shot with synchronized native audio from a written brief.

Model id
minimax/h3-max/text-to-video
Provider
MiniMax
Output
Video
Price
From 50 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "minimax/h3-max/text-to-video". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3-max/text-to-video",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light",
    "prompt_expansion_mode": "balanced"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Text prompt for video generation

Up to 50000 characters

first_framearray of URLs

Optional URL of the image to use as the first frame. When provided, the output aspect ratio follows this image. When omitted, the request is handled as text-to-video (16:9 by default).

Up to 1 files · Accepts image/*

last_framearray of URLs

Optional URL of the image to use as the last frame, for first-to-last keyframe generation.

Up to 1 files · Accepts image/*

aspect_ratiostring

The aspect ratio of the generated video.

Default: 16:9

One of: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

resolutionstring

The native generation resolution of the video.

Default: 480p

One of: 480p, 768p

duration_secondsnumber

The duration of the video in seconds.

Default: 5

Min 5 · Max 15

seednumber

Random seed. A random seed is selected when omitted.

prompt_expansion_moderequiredstring

How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt.

Default: balanced

One of: disabled, balanced, quality