MiniMax | H3 | Max | Reference to Video.

MiniMax H3 Max Reference to Video Overview

H3 Max Reference-to-Video creates short AI video clips from prompts and reference images, preserving subject cues for character-driven creative scenes.

A prompt and optional reference inputs guide the subjects and appearance of a new short video.

MiniMax H3 Max Reference to Video from MiniMax is available through each::labs in the minimax-h3-max family. Required fields are prompt, prompt_expansion_mode.

reference_image_urls: Subject or style reference image URLs. reference_video_urls: Motion or visual reference video URLs, 2-15 seconds each and 15 seconds combined.

Use the MiniMax H3 Max Reference to Video API when you need this transformation or analysis as a repeatable step in an application or creative pipeline. The sections below distinguish the required material, adjustable controls and checks that matter before delivery.

Capabilities

• A prompt and optional reference inputs guide the subjects and appearance of a new short video.
• reference_image_urls: Subject or style reference image URLs.
• reference_video_urls: Motion or visual reference video URLs, 2-15 seconds each and 15 seconds combined.
• reference_audio_urls: Reference audio URLs, 2-15 seconds each and 15 seconds combined.
• Produces a video result for the next stage of your workflow.

Use Cases for MiniMax H3 Max Reference to Video

MiniMax H3 Max Reference to Video is useful when this specific operation fits between source preparation and delivery. These scenarios show how it can support different parts of a working pipeline.

Creators

Draft a character-led shot. Use a representative source or a concise brief, then inspect the result before preparing a larger set of assets.

Design and marketing teams

Explore a product-reference scene. Compare the result with the intended message, composition and destination. Keep reviewable versions of the source and output.

Developers

Create a short visual-storyboard concept. Inspect the actual returned value before connecting it to another step, and keep the chosen request settings with the result.

Start with a clear definition of the desired result and use the exposed controls to reach it. Keep any additional generation, editing or application logic in separate steps so that the effect of this operation remains easy to review.

Tips and Tricks

Describe one coherent shot before adding complex action. State the subject, movement, camera behavior and setting separately. For reference-guided requests, choose source images with clear subjects and compatible framing.

• reference_video_urls: Motion or visual reference video URLs, 2-15 seconds each and 15 seconds combined.
• reference_audio_urls: Reference audio URLs, 2-15 seconds each and 15 seconds combined.

• Example direction: “A slow camera push toward the subject; one gentle movement, consistent lighting, no scene cut.”
• Example direction: “The subject turns slightly toward the camera while the background remains still.”

Compare one deliberate adjustment at a time. Inspect the part of the result affected by that change, then check the rest of the asset or response for unwanted side effects before reusing the settings.

Technical Specifications

• Result type: video.
• Required fields: prompt, prompt_expansion_mode.
• duration: integer; default 5; minimum 5; maximum 15.
• resolution: string; options 480P, 768P, 1080P; default "768P".
• aspect_ratio: string; options adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16; default "adaptive".
• prompt: string.

Values must use the types and accepted options listed in the parameter reference. A displayed default does not remove a required-field requirement. Choose a supported output setting for this entry rather than borrowing a preset from a related model.

Things to Be Aware Of

Watch the entire clip rather than reviewing only a thumbnail. Check subject identity, object boundaries, motion continuity, camera changes and the ending; review the audio as well when the entry includes it.

Optional settings are not necessarily interchangeable with those on another entry in the same family. Use the accepted names, types and values shown for this operation.

Check the returned content against the original input and your application requirements. A successful request means the operation completed; your application still needs to verify that the response is suitable for the next step.

Key Considerations

Keep reference identities and scene instructions consistent, and inspect the full result for continuity.

Several pricing tiers apply. Check the full pricing reference for the chosen settings and supplied references rather than assuming one flat charge.

Prepare prompt, prompt_expansion_mode before starting. Optional settings include reference_image_urls, reference_video_urls, reference_audio_urls. Keep these settings aligned with the intended delivery, especially when a later step expects a particular type or format.

Run a representative request before scaling to a larger collection. Judge the result against the source and the brief, and account for all generated outputs or usage-sensitive options when estimating a batch.

Limitations

• prompt: minimum characters: 1; maximum characters: 50000.
• prompt_expansion_mode: allowed values: ["disabled", "balanced", "quality"].

Unsupported parameters do not establish additional capabilities. A generated result can differ from the intended brief, so review detail and consistency before publication.