MiniMax H3 API for Video Generation

Choose the H3 Model That Matches Your Inputs
hailuo_h3: Text, First Frame, or First-and-Last Frame
hailuo_h3 for text-to-video, image-to-video with image_url, or first-and-last-frame control with optional image_end_url. The prompt is required and can contain up to 7,000 characters. See the live playground and full parameter reference.
hailuo_h3_refs: Reference-Driven Generation
hailuo_h3_refs when one request needs up to 9 reference images, 3 reference videos, and 3 reference audio clips. This route uses MiniMax’s official channel and offers 768P and 2K output. See the reference-to-video endpoint.
Independent Unified API Access

MiniMax H3 API Parameters and Limits
Shared endpoint and asynchronous response
POST https://api.goenhance.ai/api/v1/videos/generations. The response returns an img_uuid; generation continues asynchronously.hailuo_h3 duration and prompt
duration must be an integer from 5 through 15 seconds and defaults to 5. Non-integer or out-of-range values are rejected before token deduction. prompt is required and accepts up to 7,000 characters.hailuo_h3 resolution and aspect ratio
ratio accepts 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16. When image_url supplies a first frame, output follows that image and the ratio parameter is not used.hailuo_h3 frame inputs
image_url for a first frame and optional image_end_url for a last frame. This model ID covers text-to-video, image-to-video, and first-and-last-frame generation.hailuo_h3_refs reference inputs
ref_imgs, 3 videos in ref_videos, and 3 audio clips in ref_audios. Duration is an integer from 5 through 15 seconds and defaults to 5; resolution is 768P or 2K.Native stereo audio
MiniMax H3 Pricing Per Second
hailuo_h3 — 480p: $0.030 per second
hailuo_h3 — 720p: $0.060 per second
hailuo_h3 — 2K: $0.090 per second
hailuo_h3_refs — 768P: $0.099 per second
hailuo_h3_refs — 2K: $0.143 per second
Tokens, refunds, and concurrency
Integrate the MiniMax H3 Video API
1. Create and protect an API key
Authorization: Bearer <API key>; do not expose it in browser code or logs.2. Select a model and validate the request
hailuo_h3 for text or frame control, or hailuo_h3_refs for reference media. Validate duration, resolution, ratio applicability, prompt length, and input counts before submission.3. Submit and persist img_uuid
https://api.goenhance.ai/api/v1/videos/generations. Store the returned img_uuid with your own job record because the task is asynchronous.4. Poll or receive callbacks
GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., or register a callback URL. A callback with status=0 fires when the task starts running; a terminal callback carries the result.5. Handle validation, failure, and concurrency
What Developers Ship with H3
Programmatic ad variants
Product clip pipelines
Localized video spots
UGC production systems
MiniMax H3 API FAQ
What duration does the MiniMax H3 API accept?
Both hailuo_h3 and hailuo_h3_refs accept any integer from 5 through 15 seconds and default to 5. Non-integer or out-of-range values are rejected before tokens are deducted.
Why are there two H3 model IDs?
MiniMax treats frame control and reference material as mutually exclusive. GoEnhance therefore exposes hailuo_h3 for first/last-frame workflows and hailuo_h3_refs for reference-driven generation instead of combining parameters that conflict at runtime.
Are 480p and 720p official MiniMax output tiers?
No. MiniMax officially outputs 2K only. The 480p and 720p tiers on hailuo_h3 run on GoEnhance’s own pipeline. They let you iterate more cheaply, then use 2K only for takes you keep.
Why does hailuo_h3_refs cost more?
hailuo_h3_refs runs only through MiniMax’s official channel. Its available resolutions are 768P and 2K, with per-second rates of $0.099 and $0.143 respectively.
How does billing work?
Usage is token-based: $10 buys 500 tokens, or $0.02 per token. Video billing is per second at the listed rate. Points are deducted once when the task is submitted and refunded in full if generation fails.
Does MiniMax H3 generate audio?
Yes. H3 generates native stereo dialogue, sound effects, and room tone in the same pass as the video rather than adding a dub afterward.
How do I know when a video is ready?
Save the returned img_uuid and poll the job-detail endpoint, or register a callback URL. The start callback uses status=0; a terminal callback carries the result.
Is GoEnhance Open API affiliated with MiniMax or Hailuo?
No. GoEnhance Open API is an independent third-party API platform. It is not MiniMax or Hailuo and is not affiliated with or endorsed by MiniMax. The names identify the model and belong to their owner.
Where is the no-code MiniMax H3 editor?
This page is for REST API integration. For a consumer-facing editor, visit the MiniMax H3 video model page.
