MiniMax H3 Max

tk-minimax-h3-max

POST /v1/videos

Multi-asset reference generation (images, videos, and audio together) with a dedicated reference-video rate.

• Resolutions: 480P, 768P
• Duration: 5–15 s (this model does not accept 4 s)
• Reference media: images (≤9), videos (≤3), audio (≤3); first/last frames supported
• Free input images: first 2 per task; additional input images are billed per image
• metadata.extra (object or JSON string) is forwarded to the model, e.g. {"prompt_expansion_mode": "quality"}

See the family page for the shared request shape, media limits, aspect-ratio rules, and billing rules: MiniMax H3.

Supported parameters

API field	Type	Required	Values / limit
model	string	Yes	tk-minimax-h3-max
prompt	string	Yes	Nonempty; at most 7,000 characters
seconds	integer	No	5–15; default 5
metadata.resolution	string	Yes	480P, 768P
metadata.ratio	string	See rules	16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive
metadata.media	array	No	{type, url} entries
metadata.extra	object	No	Forwarded to the model unchanged

Billing

This model has a separate, higher rate for reference-video input seconds (the other H3 models bill reference video at the output rate):

• Output video: per second at the 480P or 768P rate.
• Reference video input: per second at the input-video rate for the output resolution — measured from the completion response (multi-clip durations are rounded to whole seconds).
• Input images: first 2 free, then per image.
• Reference audio: free. Failed tasks: not billed.

Request example

curl https://api.apimart.cc/v1/videos \
  -H "Authorization: Bearer $HIPIX_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"model": "tk-minimax-h3-max", "prompt": "The girl in @Image1 running on the beach, narrated in the voice of @Audio1", "seconds": 5, "metadata": {"resolution": "768P", "ratio": "16:9", "media": [{"type": "reference_image", "url": "https://example.com/girl.jpg"}, {"type": "reference_audio", "url": "https://example.com/voice.mp3"}]}}'