MiniMax H3 Max Text to Video API

minimax/h3-max/text-to-video
480p / 768p / 1080p · 5–15 sec

MiniMax H3 Max Text to Video turns text prompts into cinematic video with native stereo audio, faster-than-real-time generation, and precise instruction following. It renders complex camera work and physical motion with fine detail across multiple resolutions and common aspect ratios.

Input
683/50000
OutputExample
5 sec × $0.080/sec = $0.400
Continue with

Examples

A single uninterrupted lateral tracking shot in an old sunlit fencing salle. Two adult women in plain white fencing uniforms and protective masks face each other on a wooden piste. The nearer fencer advances one step and lunges; her opponent makes one clean parry, the blades briefly contact, and both settle back into guard. Keep the two people distinct with anatomically correct arms and stable swords. Crisp footwork, believable fabric momentum, the metallic tap exactly on blade contact and soft rubber soles on wood. Controlled athletic rehearsal, no injury. Five seconds, natural cinema, no slow motion, no captions, logos or text.

One continuous medium-wide shot inside a historic mountain observatory at blue hour. An elderly astronomer beside a large brass telescope presses a small wall lever. The curved dome shutter rolls open above him, exposing a narrow band of deep violet sky and a bright moon. The moving opening casts a cool strip of light across his face; he looks up and smiles quietly. Slow upward camera tilt follows his eyeline without a cut. Heavy gears rotate consistently, subtle dust in the light, natural scale. Native synchronized mechanical rumble and wind entering the dome, no music. Five seconds, no subtitles, logos or on-screen text.

MiniMax H3 Max Text to Video

MiniMax H3 Max Text to Video is built for high-throughput video production, combining generation faster than real time with precise prompt adherence. It natively synthesizes synchronized stereo audio and video with physical action across multiple shots. With 5–15 second durations, resolutions from 480p to 1080p, and multiple aspect ratios, it offers cost-effective production for film previs, animated concept shorts, and creative advertising.

Why choose the MiniMax H3 Max Text to Video API?

  • High-throughput generation faster than real timeAdvanced post-training optimization and accelerated inference can render a 5-second video in about 3 seconds under ideal conditions, shortening creative validation and batch-production cycles.

  • Precise adherence to complex promptsUnderstands subject features, action choreography, shot-size changes, and lighting instructions, with substantially improved fidelity to long, multi-stage descriptions compared with the base model.

  • Native synchronized stereo audio and videoGenerate ambient effects, action sounds, and atmospheric soundscapes aligned with the visual rhythm in a single pass, without adding separate audio in post-production.

  • Six standard aspect ratios for commercial useNatively supports six aspect ratios, from 21:9 ultrawide and 16:9 landscape to 9:16 vertical shorts, covering film previs and major social platforms.

  • Flexible durations with transparent per-second billingChoose any whole-second duration from 5–15 seconds and 480p, 768p, or 1080p resolution. Billing follows the requested duration parameter for predictable budgeting.

Parameters

ParameterRequirementDescription
promptRequired

Describe the subject, setting, actions, camera work, and soundscape. The original input must not exceed 50,000 characters, including leading and trailing whitespace, and must not be empty after trimming.

Default—
durationOptional

Generation duration: any whole number from 5–15 seconds. Defaults to 5 seconds.

Default5
resolutionOptional

Output resolution tiers: 480p, 768p (default), and 1080p.

Default768p
enable_safety_checkerOptional

Whether to enable the generated-content safety checker to filter prohibited visuals and sensitive content.

Defaulttrue
aspect_ratioOptional

Aspect ratio: six fixed options, 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16.

Default16:9

How to Use

  1. Describe the subject and settingDefine the main subject, appearance, clothing textures, time and place, weather, and lighting.

  2. Plan the main action and camera workUse clear verbs to describe character or object movement, and specify camera pushes, pulls, pans, tracking paths, and shot-size changes.

  3. Add synchronized sound cuesInclude descriptions of ambient sound, impact effects, or background audio to guide matching native stereo sound.

  4. Set output specifications and framingChoose a whole-second duration from 5–15 seconds, 480p/768p/1080p resolution, and an aspect ratio suited to your delivery channel.

  5. Submit the task and retrieve the videoSubmit a generation request through the API to receive a task ID, then poll the status endpoint or configure a callback URL to receive the completed MP4 file.

Usage and billing

The MiniMax H3 Max Text to Video API uses transparent per-second pricing by resolution tier. Cost depends only on the requested duration parameter and selected resolution, with no hidden conditions.

UsageRateDetails
480p10 credits / second$0.050 / second. A 5-second video costs 50 credits; 10 seconds costs 100 credits. Suitable for frequent creative drafts and quick validation.
768p16 credits / second$0.080 / second. A 5-second video costs 80 credits; 10 seconds costs 160 credits. Balances throughput and visual detail.
1080p32 credits / second$0.160 / second. A 5-second video costs 160 credits; 10 seconds costs 320 credits. Suitable for final commercial delivery and large-screen viewing.

Best Use Cases

  • Film and animation previsQuickly turn written scripts into animated storyboards with sound to assess camera rhythm, blocking, and dramatic impact.

  • Frequent social media shortsBatch-generate topical shorts and ad concepts in 9:16 or 16:9 to reduce production costs.

  • Ad concepts and visual explorationTry different art styles, lighting, and narrative ideas early in a project, then quickly share concept prototypes with clients and teams.

  • Game cinematics and environment previewsQuickly create moving landscapes, sci-fi rainy nights, or complex city scenes for game backgrounds, atmosphere previews, and promotional assets.

Pro Tips

  • Structure your prompt in sections: start with the main subject and appearance, then the action sequence, camera placement and movement, and finally lighting and color style.
  • Describe sound effects clearly: add specific sounds at the end of the prompt, such as footsteps, rain hitting a car window, or train wheels striking the rails, to improve audiovisual alignment.
  • Keep each shot focused on one main event: for short 5–8 second shots, build around a coherent action rather than unrelated characters or abrupt changes of scene.
  • Match composition to aspect ratio: for 21:9 widescreen or 9:16 vertical output, emphasize scene depth or vertical composition in the prompt accordingly.
  • Validate quickly at 768p: use 768p to generate and compare iterations at scale, then render the selected shot at 1080p for final delivery.

Notes

  • The MiniMax H3 Max Text to Video API accepts text prompts only. Source images, reference video, and audio inputs are not supported.
  • Successful submission immediately returns a task_id. Tasks run asynchronously, and the video can be downloaded only after generation finishes.
  • Poll the status endpoint every 2 seconds while the task is not_started or running. Stop once it reaches finished or failed.
  • Pass callback_url at the request's top level to automatically receive an asynchronous Webhook notification when generation finishes or ends in an error.

Related Models

MiniMax H3 Max Text to Video API FAQ

What is the MiniMax H3 Max Text to Video API?

MiniMax H3 Max Text to Video is a text-to-video model from MiniMax, optimized through extensive post-training. It generates cinematic 5–15 second videos from text alone, with throughput faster than real time, strong adherence to complex instructions, and native synchronized stereo audio. Its spatiotemporal diffusion architecture preserves plausible physical motion and temporal continuity while rendering detailed lighting and camera paths. Access it programmatically through the API or try it directly in the playground above.

How fast is MiniMax H3 Max Text to Video?

With optimized inference architecture and compute scheduling, the core generation of a 5-second 768p video can finish in about 3 seconds under typical network and server conditions. Actual end-to-end time includes queuing and scheduling. Its high throughput, well beyond real-time speed, helps shorten turnaround in production pipelines.

How does MiniMax H3 Max Text to Video generate native audio?

The model synthesizes two-channel stereo audio alongside the video, without requiring a separate voice or sound-effects model in post-production. Add specific descriptions of ambient sounds and action effects, such as doors opening or closing, wind and rain, or engines, to the prompt. The generated audio aligns naturally and precisely with the timing of the visual actions.

Which durations and resolutions does MiniMax H3 Max Text to Video support?

Choose any whole-second duration from 5–15 seconds, with a default of 5 seconds. Resolution tiers are 480p for standard-definition tests, 768p for standard HD output (default), and 1080p for full HD commercial output. All three tiers support six aspect ratios: 21:9, 16:9, 4:3, 1:1, 3:4, and 9:16.

How is MiniMax H3 Max Text to Video billed?

The API bills by the requested duration parameter in seconds, with the credit rate determined by resolution: 480p costs 10 credits per second (about $0.050/second), 768p costs 16 credits per second (about $0.080/second), and 1080p costs 32 credits per second (about $0.160/second). For example, a 5-second 768p video costs 80 credits. The dashboard dynamically estimates the required credits before submission.

How should I choose between MiniMax H3 Max and the original MiniMax H3?

Choose MiniMax H3 Max for higher throughput, fast creative iteration, faithful prompt details, and native synchronized stereo audio. If your project depends on native 2K or 4K ultra-high resolution, the original MiniMax H3 is recommended.

How can I write prompts to control camera movement precisely?

Use cinematography terms to specify placement and movement, such as "the camera slowly tracks from a wide shot into a medium shot," "a low-angle tracking shot close to the ground," or "the camera orbits the character." Describe subject actions and camera paths separately, then add depth-of-field and lighting-direction cues to help the model follow your shot design.