minimax/h3-max
MiniMax H3 Max, served direct from MiniMax: the highest-quality H3 tier.
Text-to-video, image-to-video (a first frame, optionally a last frame) and reference-to-video in one model, every clip with sound; 5 to 15 seconds at 480P or 768P. Served through the async job API only: POST /v2/jobs, then poll.
Billed per second of output by resolution, from what the generator reports it rendered: 480P $0.06, 768P $0.096.
MiniMax H3 on this gateway: minimax/h3 · minimax/h3-highspeed · minimax/h3-lite · minimax/h3-max (this page) · minimax/h3-regeneration.
| Slug | minimax/h3-max |
| Kind | video |
| Vendor | minimax |
| Endpoint | POST /v2/jobs |
Charged per job from what the generator reports it rendered — your Logs show the exact figure for each one; see balance and billing.
Calling it
curl https://api.sociaro.com/v2/jobs \
-H "Authorization: Bearer $SOCIARO_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: my-request-0001" \
-d '{
"model": "minimax/h3-max",
"input": {
"content": [
{"type": "text", "text": "The paper boat drifts down the rain-soaked street."},
{"type": "image_url", "image_url": {"url": "https://your-cdn.example.com/first.png"}, "role": "first_frame"}
],
"resolution": "768P",
"duration": 10
}
}'
# then poll the job id it returns until status is succeeded:
curl https://api.sociaro.com/v2/jobs/JOB_ID \
-H "Authorization: Bearer $SOCIARO_API_KEY"Parameters
MiniMax H3 Max — the highest-quality H3 tier
| Field | Type | Required | Default | Values | What it does |
|---|---|---|---|---|---|
content | object[] | yes | — | text · image_url · video_url · audio_url | Typed parts: exactly one `{"type": "text", "text": …}` (up to 7000 characters), plus `image_url` parts with `role` first_frame, last_frame or reference_image, `video_url` parts with role reference_video and `audio_url` parts with role reference_audio. Each media part is `{"url": …}`, a public https URL or a `data:` URI. Up to 9 reference pictures, 3 clips and 3 sounds (each 2–15 s, 15 s in total per kind). Frames and reference parts cannot be mixed. |
resolution | string | yes | — | 480P · 768P | Sets the per-second rate. No 2K on this tier: any other value is a `400` before anything is rendered. |
duration | integer | yes | — | 5–15 | Whole seconds of output. 4 is not offered on this tier (the generator refuses it). |
ratio | string | no | adaptive | adaptive · 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | A text-only request needs a concrete ratio (not `adaptive`). With a first or last frame the ratio follows the picture. |
extra.prompt_expansion_mode | string | no | balanced | disabled · balanced · quality | How much the generator expands your text before rendering. Sent as `"extra": {"prompt_expansion_mode": …}`; nothing else goes inside `extra`. |
Anything not listed here is refused rather than ignored, so a typo fails loudly instead of quietly producing something else.
Worked example
curl https://api.sociaro.com/v2/jobs \
-H "Authorization: Bearer $SOCIARO_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: my-request-0002" \
-d '{ "model": "minimax/h3-max",
"input": {
"content": [ { "type": "text", "text": "The paper boat drifts down the rain-soaked street." },
{ "type": "image_url", "image_url": { "url": "https://your-cdn.example.com/first.png" }, "role": "first_frame" } ],
"resolution": "768P", "duration": 10,
"extra": { "prompt_expansion_mode": "quality" } } }'
curl https://api.sociaro.com/v2/jobs/JOB_ID -H "Authorization: Bearer $SOCIARO_API_KEY"Submit and poll. Served through the Jobs API only: POST /v2/jobs with the model in the envelope and
its fields in input, then poll GET /v2/jobs/{id} until status is succeeded. The finished MP4 is
outputs[0].url, a stable link on our CDN kept for ten years.
What is checked here. What the body decides is checked at submit, each a 400 invalid_input and no job: a field
the model's input_schema does not name, a value outside its list or range (a resolution this model does not offer, 2K for example),
a content part of the wrong shape, more parts of a kind than the generator takes (one first frame, one last frame, nine
reference pictures, three clips, three sounds), a first or last frame mixed with reference parts, a missing text part, a text-only request without a concrete
ratio, a callback_url inside input (the job's own callback_url goes at the top level, beside model and
input) and an mm_file:// url. The generator judges the media itself (the length of a clip or sound, a picture's
size and format) and refuses what it does not take before anything is billed.
prompt_enhance is not offered on these models; extra.prompt_expansion_mode is the generator's own.
How it is billed. Once, when the job completes, from what the generator reports it rendered: seconds of output at the rate of the resolution it rendered, plus any reference clips by their length at that resolution's input rate, plus each picture (first frame, last frame, reference) past the first two. Reference sounds are free. A failed job is not billed. On this tier a reference clip costs more per second than the output it feeds.
| 480P | 768P | |
|---|---|---|
| per second of output | $0.06 | $0.096 |
| per second of reference clip | $0.06636 | $0.1716 |
| per picture past the first two | $0.0888 | $0.0888 |
A 10 second 768P clip with 5 seconds of reference clips and 3 pictures: 10 × $0.096 + 5 × $0.1716 + 1 × $0.0888 = $1.9068.