MiniMax H3 Reference to Video API

Build a MiniMax H3 clip around your own characters, products or locations. Send model: hailuo_h3_refs to POST /api/v1/videos/generations with 1 to 9 ref_imgs, an optional reference video and up to 3 audio clips, and cite them in the prompt as <Picture 1>, <Video 1> and <Audio 1>.
Get API Key
Two sculpted character maquettes on a turntable lit like a film set

Pictures Define Who and Where, the Prompt Defines What Happens

Up to nine pictures in one scene

Pass 1 to 9 JPG, PNG or WEBP images (up to 10 MB each, shortest side at least 300 px). Array order sets the numbering, so "<Picture 1> and <Picture 2> fight an epic battle" puts both characters in one shot.
A row of framed character portraits leading toward a film set

Optional video and audio references

Add one ref_videos item as <Video 1> and up to 3 ref_audios as <Audio 1>…<Audio 3>. Only the first 15 seconds of each is used. A reference video takes noticeably longer to render; the price stays the same.
Projector casting moving light onto a wall beside a vintage microphone

Three resolutions, one per-second rate each

Choose 480p, 720p or 2K (the default). 2K is rendered at 720p and then upscaled, so it takes longer than 720p. Every resolution supports 5 to 15 seconds and seven aspect ratios.
Three monitors of increasing size showing the same ocean scene
model, prompt and ref_imgs are required. First and last frames are not supported here.

MiniMax H3 Reference to Video Request Fields and Limits

model

Always hailuo_h3_refs. For first and last frame control use hailuo_h3 instead.

prompt (required)

Up to 7000 characters. Refer to references by position: <Picture 1>…<Picture 9>, <Video 1>, <Audio 1>…<Audio 3>.

ref_imgs (required)

1 to 9 image URLs, JPG, PNG or WEBP, up to 10 MB each, shortest side at least 300 px.

ref_videos and ref_audios

Optional: 0 or 1 video and 0 to 3 audio URLs. Only the first 15 seconds of each is used.

resolution and duration

resolution: 480p, 720p or 2K (default 2K), which also sets the price. duration: any integer from 5 to 15 seconds (default 5).

ratio and callback

ratio: 16:9 (default), 9:16, 1:1, 4:3, 3:4, 3:2 or 2:3, always applied. custom_callback_url: optional public HTTPS URL, retried up to 3 times.
Billed per second of output, by resolution. References do not change the price.

MiniMax H3 Reference to Video API Pricing

480p: 1.5 tokens ($0.03) per second

A 5-second 480p clip costs 7.5 tokens ($0.15).

720p: 3 tokens ($0.06) per second

A 5-second 720p clip costs 15 tokens ($0.30); a 15-second one costs 45 tokens ($0.90).

2K: 4.5 tokens ($0.09) per second

The default resolution. A 5-second 2K clip costs 22.5 tokens ($0.45). Set resolution explicitly if you want a cheaper tier.

Refunded if the job fails

Tokens are deducted when the task is accepted; the response's cost is the amount charged, and failed generations are refunded automatically.

Integrate the MiniMax H3 Reference to Video API

1

1. Get an API key

Create one at /keys and send Authorization: Bearer <key> from your server.
2

2. Order the reference images

Put character, product or location images into ref_imgs in the order you want to cite them; the first is <Picture 1>.
3

3. Submit the request

POST {"model": "hailuo_h3_refs", "prompt": "…", "ref_imgs": ["https://…"], "resolution": "720p"} to /api/v1/videos/generations and keep the img_uuid.
4

4. Collect the video

Poll GET /api/v1/jobs/detail or wait for the callback, then download the result from json[].value within 24 hours.
Create an API Key
Clips that must keep specific characters, products or places recognizable.

What Developers Build with MiniMax H3 Reference to Video

Character-consistent story scenes

Reuse the same character sheet across episodes so recurring characters look the same in every clip.

Multi-character action shots

Combine several character images in one prompt for duels, meetings or group scenes.

Product in a new setting

Pair a product photo with a location image to place it in a lifestyle scene without a shoot.

Music-timed clips

Add a reference audio clip so the generated scene follows a given track or sound.
Inputs, tags, resolutions and pricing.

MiniMax H3 Reference to Video API FAQ

What model value do I send?

hailuo_h3_refs, to POST https://api.goenhance.ai/api/v1/videos/generations.

How many reference images can I use?

Between 1 and 9. At least one image is required even if you also send a video or audio.

Can I set a first or last frame?

No. This endpoint is reference-only; use hailuo_h3 for first and last frame control.

Does a reference video cost more?

No, the price depends only on resolution and duration. A reference video does make rendering noticeably slower.

What is the default resolution?

2K at 4.5 tokens ($0.09) per second. It is rendered at 720p and upscaled, so it takes longer than 720p.

Which aspect ratios are supported?

16:9, 9:16, 1:1, 4:3, 3:4, 3:2 and 2:3. The ratio value is always used because there is no input frame to follow.

Start Building with the MiniMax H3 Reference to Video API

MiniMax H3 Reference to Video API: Pricing | GoEnhance