MiniMax-H3 AI Video API
MiniMax-H3 is MiniMax's multimodal video model. Official documentation lists text, image, video, and audio references, 768P or 2K output, and 4–15-second clips; Flatkey exposes the asynchronous /v1/videos flow.
Output
PreviewGenerated with Seedance 2.0
Request summary
- Endpoint
- POST /v1/videos
- Model ID
- MiniMax-H3
- Aspect ratio
- 16:9
- Resolution
- 768P
- Duration
- 6s
- Reference media
- None
Preview only. Sign in to submit this request to Flatkey.
{
"model": "MiniMax-H3",
"content": [
{
"type": "text",
"text": "Creative direction: A person in a yellow raincoat waits beside a bench at a rainy station, notices a torn letter, and picks it up to read. Move from the wet platform to a close view of the paper and hold on the reader's concerned expression.\n\nVisual treatment: Rainy character drama with subdued station colors and a yellow raincoat focal accent.\n\nShot sequence: 1. Establish the raincoat figure beside the station bench.; 2. Move closer as the torn letter is noticed and lifted.; 3. Hold the concerned face with the letter visible and rain continuing behind.\n\nContinuity: Keep the character's face, clothing and key prop consistent; preserve screen direction across cuts.\nExclude: extra people or props, text, logos and watermarks."
}
],
"resolution": "768P",
"duration": 6,
"ratio": "16:9",
"aigc_watermark": false
}Performance
MiniMax-H3 video API performance and availability
Live Flatkey request telemetry appears here when enough MiniMax-H3 traffic is available; no quality ranking is inferred.
Activity
MiniMax-H3 video API usage and generation activity
This chart uses live Flatkey generation requests and stays unreported until enough traffic is collected.
Pricing
MiniMax H3 video API pricing by resolution and duration
Prices below are calculated from Flatkey pricing data for this model and the visible groups currently returned by our pricing API.
Add credits
Use the same Flatkey balance and API key across image, video, audio, and text models.
- Model Type
- Text to Video
- API
- /v1/videos
- Billing basis
- second
- Duration
- 4–15s
- Aspect ratio
- 21:9 · 16:9 · 4:3 · 1:1 · 3:4 · 9:16 · adaptive
MiniMax H3 video generation and production capabilities
Use these documented capabilities to plan a production workflow; request fields remain in the API section below.
Text-to-video and image-to-video
Start a scene from a written brief or a designed frame and develop it into a short clip.
Reference-led motion
Use text, image, video, or audio references to keep the subject and creative direction coherent.
Camera and pacing direction
Shape how the camera, subject movement, duration, and framing progress through the shot.
Production-ready variants
Create product, UGC, and storyboard versions that can move from testing into an editing workflow.
Compare
MiniMax H3 hosted API vs open-weight or local deployment
Compare documented hosted request fields with open-weight or local assumptions; MiniMax upstream terms and Flatkey routing are separate.
| Capability | Open-weight / local deployment | Verified hosted API |
|---|---|---|
| Resolution | 768P base; 2K via hosted regeneration | 768P or 2K |
| Duration | 4–15 seconds | 4–15 seconds |
| Ratio | Text-to-video requires a fixed ratio; adaptive is for reference routes | Route-specific fixed/adaptive ratio rules |
| AIGC watermark | Not verified | Flatkey route field; availability varies |
| ComfyUI or local weights | MiniMax documents open-source weights and ComfyUI options upstream | Native Flatkey local/ComfyUI delivery not verified |
| Upstream vs Flatkey | Open-source/local use follows MiniMax upstream documentation | Flatkey routes and bills hosted API access |
Prompt library
MiniMax-H3 prompting guide: product, UGC, and storyboard shots
Describe the subject, action, camera position, duration, and output ratio; keep the request fields separate from the scene prompt.
Generated with Seedance 2.0
Creative direction: A person in a yellow raincoat waits beside a bench at a rainy station, notices a torn letter, and picks it up to read. Move from the wet platform to a close view of the paper and hold on the reader's concerned expression. Visual treatment: Rainy character drama with subdued station colors and a yellow raincoat focal accent. Shot sequence: 1. Establish the raincoat figure beside the station bench.; 2. Move closer as the torn letter is noticed and lifted.; 3. Hold the concerned face with the letter visible and rain continuing behind. Continuity: Keep the character's face, clothing and key prop consistent; preserve screen direction across cuts. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A teal reusable bottle with water droplets stands on bright marble beside an open canvas tote. One hand grips the bottle, lifts it and slides it into the tote side pocket. End with the bottle still visible above the pocket and daylight catching its wet surface. Visual treatment: Photoreal lifestyle commercial with soft window daylight, teal enamel and tactile canvas and marble textures. Shot sequence: 1. Frame the bottle and the open tote together; 2. Follow the hand as it lifts the bottle into the side pocket; 3. Hold the packed tote with the bottle visible and upright Continuity: Keep the product silhouette, cap or hinge, materials and prop positions stable; hold the final hero frame. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A man walks from a dark interior into an empty glass-domed observatory at dawn. Follow him toward the telescope as cool sky light fills the dome, then settle behind the figure and instrument facing the bright horizon. Visual treatment: Live-action observatory reveal with cool dawn skylight and a dark foreground silhouette. Shot sequence: 1. Follow the man out of the dark interior into the glass dome.; 2. Continue toward the telescope as dawn sky fills the background.; 3. Settle behind the figure and telescope facing the bright horizon. Continuity: Maintain scene geography, subject scale and motivated light direction throughout the camera move. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A cyberpunk fighter crouches on a wet neon plaza, bursts into a sprint, and slides to a stop. A blue circular energy shield opens in front of the fighter as the low camera tracks the movement and holds on the glowing barrier. Visual treatment: Rendered cyberpunk action with neon reflections and localized blue shield emission. Shot sequence: 1. Start low on the crouched fighter in the wet plaza.; 2. Track the acceleration and slide, keeping foot contact legible.; 3. Stop with the fighter as the blue shield opens in front. Continuity: Maintain character design, equipment geometry and travel direction from first to final frame. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: Miniature island and map pieces assemble on a blue tabletop around a white lighthouse. The land sections lock together, the lighthouse rises upright, and its lamp turns on while the overhead view reveals the completed coastal model. Visual treatment: Miniature map animation with distinct island layers and a blue tabletop. Shot sequence: 1. Establish separated island pieces and the lighthouse from overhead.; 2. Slide the land sections together and raise the lighthouse upright.; 3. Turn on the lamp and hold the completed coastal model. Continuity: Keep demonstration props, layout and hand contact consistent so the action remains legible. Exclude: extra people or props, text, logos and watermarks.
Generated with Seedance 2.0
Creative direction: A chrome ring-and-ribbon sculpture rotates above a reflective black floor under blue and red light. The metal loops bend and morph into a new interlocking shape while the camera holds a symmetrical gallery-style composition. Visual treatment: Reflective abstract sculpture animation with chrome, black and controlled blue-red light. Shot sequence: 1. Center the chrome loops above the black reflective floor.; 2. Rotate the sculpture while ribbons bend into the next interlocking shape.; 3. Slow the rotation and hold the new silhouette with its reflection aligned. Continuity: Keep the main subject, palette and light behavior consistent as the visual pattern develops. Exclude: extra people or props, text, logos and watermarks.
Why use Flatkey for MiniMax-H3?
A practical MiniMax H3 video API workflow
Keep video settings, asynchronous task handling, and pricing boundaries visible while you move from a prompt draft to a real request.
Video fields are explicit
Choose 768P or 2K, 4–15 seconds, a supported ratio, and the AIGC watermark boolean.
Prompting guide included
Product, UGC, and storyboard examples describe subject, action, camera, and ending rather than repeating a generic cinematic prompt.
Async result path
Save the task ID returned by POST /v1/videos and retrieve the generated content when the task is ready.
ComfyUI/local boundary
MiniMax documents open-source H3 weights and ComfyUI/local options upstream; this page only promises Flatkey hosted delivery, not native local packaging.
API
Use the MiniMax H3 video API with an async task
MiniMax's upstream API and Flatkey's hosted route use different paths; save the returned task ID and retrieve the result when ready.
curl https://router.flatkey.ai/v1/videos \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-..." \ -d '{ "model": "MiniMax-H3", "content": [ { "type": "text", "text": "A paper boat crosses a rain puddle at street level, cinematic macro shot, soft reflections, 6 seconds." } ], "resolution": "768P", "duration": 6, "ratio": "16:9", "aigc_watermark": false }'
FAQ
MiniMax H3 video API
pricing and ComfyUI questions
Answers about MiniMax-H3 video API fields, prompting, per-second pricing, asynchronous tasks, ComfyUI/local boundaries, and moderation claims.