MiniH3
MINIH3.DEV / DEVELOPER KNOWLEDGE

MiniH3 Knowledge Base

Practical notes on MiniMax H3: how to call it, what to record when you experiment, and where it fails. Browse the public index; one top-up unlocks every full text for good.

Which model should I use?Media · duration · price per secondGet a key and top upRegister · top up · first callMake your first callMinimal request and field aliasesHow billing worksCharged on requested seconds
Illustration of an imaging workbench, not H3 model output
Illustration of an imaging workbench, not H3 model output

Getting started

Register, top up, create a key, and reach a first successful call

How do I set resolution and duration?

Duration and resolution ranges, defaults, and why the length differs.

/kb/first-specs

Getting started: get a key, top up, do the math

Register, top up, create a key, and do the math on the price.

/kb/first-start

How do I pass reference images and reference audio?

URL or base64, media per model, size limits, and prompt numbering.

/kb/first-materials

How do I know the video is done, and how do I fetch it?

Which endpoint to poll, what the fields mean, and how to fetch it.

/kb/first-submit-and-fetch

Choosing a model

Eight models: required media, duration tiers, and price per second

Video from first and last frame

1 first frame + 1 last frame, both required; 1–15 seconds, up to 768p.

/kb/model-fl2va

Lip sync

1 image + 1 audio, duration explicit; 1–15 seconds, up to 1080p.

/kb/model-lipsync

Video from reference images (no sound, up to 1080p)

Images only, no sound; 1st image required; 1–10 seconds, up to 1080p.

/kb/model-r2v-1080p

Video from reference images (no sound, high quality)

Images only, no sound; 1st image required; 1–15 seconds, up to 1440p.

/kb/model-r2v-2k

Video from reference images and audio (with sound, 1080p)

Images and audio are both optional; 1–10 seconds, up to 1080p.

/kb/model-ref2va-1080p

Video from reference images and audio (with sound, high quality)

Images and audio, highest quality; 1st image required; up to 1440p.

/kb/model-ref2va-2k

Video from reference images and audio (with sound)

Images and audio are both optional; 1–15 seconds, up to 768p.

/kb/model-ref2va

Text to video (high quality)

Prompt only, no media; 1–15 seconds, up to 1440p, the priciest.

/kb/model-t2v-2k

Writing prompts

Prompt structure, camera moves, dialogue, and on-screen text

How do I write a prompt that works?

The prompt is required; order beats length, and negatives backfire.

/kb/prompt-structure

How do I write dialogue, sound, and on-screen text?

Speaker numbers, sound layers, and quoting on-screen text.

/kb/prompt-sound-text

How do I write shots and camera movement?

Camera movement is type, amplitude, and speed; when to cut instead.

/kb/prompt-camera

Should a reference image be the first frame or a reference?

Three roles: first frame, interpolation, or closing last frame.

/kb/prompt-reference-roles

API calls

Request fields, response shape, and error codes

How do I read an error?

Submit-time and runtime errors, four statuses, and silent failures.

/kb/api-failures

Which models are available, and which should I use?

Eight model ids, their media, duration, tiers, and price per second.

/kb/api-models

What do I need for my first call?

Minimal request, fields and aliases, and three traps that bill you.

/kb/api-first-call

After you submit

Queueing, polling, fetching the file, and how long it is kept

How long do I keep the finished video?

expires_at governs the link; we keep it 24 hours, then it is gone.

/kb/wait-expiry

How long does it take after I submit?

What the wait consists of, what affects it, and what you can check.

/kb/wait-time

Can I cancel, and what happens if I submit the same input twice?

No cancel endpoint; a resend is a new task with new billing.

/kb/wait-cancel-and-resubmit

Billing and top-ups

Unit price, what gets charged, tiers, and balance expiry

How does billing work, and am I charged for failures?

Charged on the seconds you request, on delivery; failures are free.

/kb/billing-rules

What's the minimum top-up, and how long does my balance last?

Why the minimum top-up is $5, and how the grant and balance are used.

/kb/billing-credits

Will the price change?

Prices change, but never suddenly, and running tasks keep their price.

/kb/billing-price-policy

Troubleshooting

Blurry frames, inconsistent characters, mismatched audio

Reference ignored, extra objects, wrong duration — what now?

Check the field name, the order, the negations, and the anchors.

/kb/troubleshoot-reference

What if the video looks blurry?

Rule out the parameters first, then add camera action and lighting.

/kb/troubleshoot-visual

What if the character changes between shots?

Repeat the same anchors every time; there is no memory of a person.

/kb/troubleshoot-character

What if the voice doesn't match, or the on-screen text is missing?

Check the speaker number, the tag, and the quotes around the text.

/kb/troubleshoot-voice-text

About us

What we provide, how your data is used, and how to reach us

What does MiniH3 provide?

Eight model ids, five ways to make a video, billed per second.

/kb/what-models

How do I contact you, and how do I report an issue?

One address for billing, task problems, moderation, and reports.

/kb/what-contact

What happens to my prompts and reference media?

No training on your data; what we log, and what we cannot control.

/kb/what-data

What do you commit to?

Four written commitments, and the three things we do not promise.

/kb/what-commitments

简体中文

The same articles in 简体中文, 36 of them.

繁體中文

The same articles in 繁體中文, 36 of them.

Español

The same articles in Español, 35 of them.

Português

The same articles in Português, 35 of them.

日本語

The same articles in 日本語, 35 of them.

API service preview

Accounts and the knowledge base are in trial. The payment channel and H3 generation are not open yet, so no real top-ups or generation requests are accepted.