MiniMax H3
import { experimental_generateVideo as generateVideo } from 'ai';
const result = await generateVideo({ model: 'minimax/minimax-h3', prompt: 'A serene mountain lake at sunrise.'});Playground
Try out MiniMax H3 by MiniMax. Usage is billed to your team at API rates. Free users (those who haven't made a payment) get $5 of credits every 30 days.
Your generated video will appear here.
Providers
Route requests across multiple providers. Copy a provider slug to set your preference. Visit the docs for more info. Using a provider means you agree to their terms, listed under Legal.
| Provider |
|---|
More models by MiniMax
| Model |
|---|
About MiniMax H3
MiniMax H3, released July 30, 2026, is MiniMax's video generation model. It takes a text prompt, a starting image, a pair of first and last frames, or reference material, and returns mp4 at 2K resolution.
Four generation modes cover most production needs. Text-to-video builds a clip from a description alone. First-frame image-to-video animates a still and follows that image's aspect ratio. First-to-last keyframe transitions define both endpoints and let MiniMax H3 generate the motion between them. Multimodal reference-to-video conditions a generation on reference images, video, or audio in a single request. Reference and keyframe modes are mutually exclusive, so choose one per request.
Reference mode uses ordering to hold a subject steady. Pass source material through inputReferences and refer to each item by its position in the prompt, such as Image 1. That gives you a way to carry a character or product across several clips.
Clips run from five to 15 seconds at 2K resolution in mp4. Aspect ratios include 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16, or the output adapts to a supplied image. Pick the ratio at request time instead of cropping afterward.
Call MiniMax H3 with generateVideo from the AI SDK, imported as experimental_generateVideo. Set the model to minimax/minimax-h3, pass your prompt plus optional aspectRatio and duration, and add inputReferences when you condition on source material. Generation runs longer than a text completion, so raise pollTimeoutMs for longer clips.
AI Gateway routes MiniMax H3 across MiniMax, tracks usage and cost per request, and handles retries and failover. The listed video rate is N/A, and the pricing panel on this page shows the current rate and unit. AI Gateway reflects provider pricing with no markup and charges no platform fee on inference.
What To Consider When Choosing a Provider
- Configuration: Reference mode and keyframe mode can't be combined in one request, so decide which control you need before you build the call. Clip length caps at 15 seconds, so longer sequences take several generations stitched together downstream. Generation runs long enough that default timeouts cut it short, so raise
pollTimeoutMsand extend fetch timeouts in Node.js. When you pass a starting image, the output follows that image's aspect ratio, so crop the source to the ratio you want to deliver. - Zero Data Retention: AI Gateway does not currently support Zero Data Retention for this model. See the documentation for models that support ZDR.
- Authentication: AI Gateway authenticates requests using an API key or OIDC token. You do not need to manage provider credentials directly.
When to Use MiniMax H3
Best for
- Text-to-Video Generation: Clips built entirely from a written scene description
- Still Image Animation: Product or character stills animated from a single starting frame
- Defined Frame Transitions: Motion generated between first and last frames you supply
- Consistent Multi-Clip Subjects: Reference images, video, or audio that carry a subject across shots
- Multi-Ratio Delivery: Vertical, square, and widescreen 2K output from one model
Consider alternatives when
- Clips Beyond 15 Seconds: Longer sequences take several generations stitched together downstream
- Reference Plus Keyframes: The two modes are mutually exclusive, so split them across separate requests
- Resolution Above 2K: Output caps at 2K, so plan an upscaling step for larger delivery formats
- Text and Code Workloads: MiniMax M3 covers reasoning and engineering tasks instead of video
Conclusion
MiniMax H3 covers text-to-video, image animation, keyframe transitions, and reference conditioning in one model, with 2K mp4 output from five to 15 seconds. Call it with generateVideo from the AI SDK using minimax/minimax-h3, and try prompts first at https://ai-sdk.dev/playground/minimax:MiniMax-H3.