How to Use the MiniMax H3 Highspeed Reference-to-Video API: reference to video integration guide (2026)

2 min · Updated 2026-07-11 · By the NamiFusion team

Learn how to call the MiniMax H3 Highspeed Reference-to-Video API on NamiFusion: parameters, pricing (from ≈$0.300) and runnable copy-paste code — try it in the playground first.

MiniMax H3 Highspeed Reference-to-Video is a reference to video model by Minimax: Generate 4–15 second videos at 768p. On NamiFusion you can try it in the playground (exact quote shown before you submit), then call it through one unified REST API — about $0.300 per typical run.

TL;DR

· Task type: reference to video, provided by Minimax

· Pricing: about $0.300 per typical run ($1 = 100 credits), pay-as-you-go

· Getting started: playground (exact quote before submit) → create an API key → one POST request

· Tunable parameters: 6 (see the table below)

· No platform watermark; commercial use allowed (per the Terms of Service)

What can you build with MiniMax H3 Highspeed Reference-to-Video?

Short-form video and ad clips: go from a prompt or a single image to publishable motion content.

Product demos and concept previews: validate storyboards and visual direction cheaply before any shoot.

A social content factory: batch vertical clips and ride trending topics fast.

Remixing existing assets: image-to-video brings static work to life and extends its lifespan.

How do you call this API?

Sign up on NamiFusion and create a key on the API Keys page (signup bonus credits can only be used on selected models).
Submit a task with the cURL example below, passing your key as a Bearer token.
Poll the task status with the returned task_uuid and read the output URLs when completed.

Submit a task

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait, dramatic rim light, shallow depth of field",
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration": 5
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

What parameters does it take?

prompt (Prompt): required

reference_images (Reference Images): optional

reference_audios (Reference Audios): optional

aspect_ratio (Aspect Ratio): optional, default "16:9"

resolution (Resolution): optional, default "768p"

duration (Duration): optional, default 5

How do you write prompts for MiniMax H3 Highspeed Reference-to-Video?

Subject first: lead with the actor and action, then add environment, lighting and style ("an astronaut sprinting through a neon street in the rain, cinematic, shallow depth of field").
Concrete nouns beat stacked adjectives: "85mm portrait lens, golden-hour backlight" works far better than "very beautiful, ultra high quality".
Change one variable per iteration: pin the seed to reproduce a result, tweak a single phrase at a time so you know what actually moved the output.
State negatives positively: instead of "no blur", ask for "sharp focus, crisp details".

How much does it cost?

Pay-per-use in credits. About $0.300 per typical run ($1 = 100 credits); the exact price varies with parameters like resolution or duration, and the playground shows the exact quote before you submit.

MiniMax H3 Highspeed Reference-to-Video

Generate 4–15 second videos at 768p.

Inputs

Parameter	Required	Type / allowed values / default
`prompt`	Required	string; max 5000 characters. Text description of the desired video scene and interactions.
`reference_images`	Optional	array; max count: 9. Up to 9 reference image URLs. At least one reference image or video is required. Images must be 256-5760 pixels per side, with a width-to-height ratio of 0.4-2.5.
`reference_videos`	Optional	array; max count: 3. Up to 3 reference video URLs. Clips are adjusted to 2-15 seconds each, with a combined maximum of 15 seconds; longer clips are trimmed and shorter clips are extended. Use MP4 or MOV, up to 50 MB per file, 256-5760 pixels per side, width-to-height ratio 0.4-2.5, and 23.976-60 FPS. At least one image or video is required.
`reference_audios`	Optional	array; max count: 3. Up to 3 optional WAV or MP3 reference audio URLs, up to 15 MB per file. Each clip must be 2-15 seconds, with a combined maximum of 15 seconds. Audio is not automatically trimmed and cannot be provided alone.
`aspect_ratio`	Optional	string; 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16; default: "16:9". Output aspect ratio.
`resolution`	Optional	string; 768p; default: "768p". Output video resolution.
`duration`	Optional	integer; 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15; default: 5. Output video duration in seconds.

Nami accepts up to 5000 prompt characters to match the current MaaS contract. Required prompts must be non-empty.

Provide at least one reference image or video; audio alone is not supported. Up to 9 images, 3 videos and 3 audio clips. Images/video frames: 256–5760 pixels per side, aspect ratio 0.4–2.5. MP4/MOV videos: up to 50 MB each, 23.976–60 FPS. Video references are adjusted to 2–15 seconds each and 15 seconds combined. WAV/MP3 reference audio: up to 15 MB each, 2–15 seconds per clip, 15 seconds combined; audio is not automatically trimmed.

Listing price

1 USD = 100 credits. Account discounts are applied separately.

768p: $0.06 per output second (6 credits). Output duration: 4–15 whole seconds; default 5.

Reference charge: $0.06 × ceil(min(sum(max(each reference-video duration, 2)), 15)). First 5 reference images are free; each additional image costs $0.03 (3 credits). Reference audio is free.

API usage

Use reachable media URLs. Submit once, then poll task_uuid until completed or failed; successful output.videos contains the video URLs.

POST https://www.namifusion.com/api/v1/marketplace/run/minimax/h3-highspeed/reference-to-video
Authorization: Bearer YOUR_NAMIFUSION_API_KEY
Content-Type: application/json

{
  "input": {
    "resolution": "768p",
    "prompt": "A colorful scene with gentle natural movement.",
    "duration": 5,
    "reference_images": [
      "https://example.com/subject.png"
    ],
    "aspect_ratio": "16:9"
  }
}

GET https://www.namifusion.com/api/v1/marketplace/run/tasks/{task_uuid}
Authorization: Bearer YOUR_NAMIFUSION_API_KEY

WaveSpeed

Full parameter reference, output schema & live pricing →

FAQ

Can I try it for free first?+

Signup bonus credits can only be used on selected models, and eligibility may change. The playground shows the exact quote before submission.

Can I use the output commercially? Is there a watermark?+

Yes, outputs are yours to use commercially, and NamiFusion adds no platform watermark — subject to the Terms of Service and applicable law.

What is the content policy?+

Pornographic content, sexualized content involving a minor, unauthorized use of real people, deceptive impersonation, fraud and false endorsements are prohibited. Lawful, consensual, non-explicit adult themes may be permitted; see the Terms of Service.

How long does a MiniMax H3 Highspeed Reference-to-Video task take?+

It depends on parameters — images usually take seconds, videos tens of seconds to minutes. The API returns a task_uuid for polling.

What are the resolution and duration limits?+

See the parameter table above — each model lists its available resolution and duration options there and in the playground.

Try it free →