Multimodal API Reference
MiniMax H3-Max Ref: Reference Generation Manual & Parameter Spec
Technical tutorial and complete API parameter reference for MiniMax H3-Max Ref. Master image, video, and audio reference-conditioned generation for developer pipelines.
Overview: What is MiniMax H3-Max Ref?
MiniMax H3-Max Ref is the high-fidelity conditioning mode of the MiniMax H3-Max model family. It allows developers to pass visual, acoustic, and spatial reference assets (ref parameters) alongside text prompts, ensuring persistent identity, structural preservation, and zero stylistic drift across generated media.
Image-to-Video Anchor
Preserves character identity, lighting conditions, and architectural boundaries from seed photos.
Motion Trajectory Match
Matches camera pan, tilt, and rotational physics from a guide video clip.
Acoustic Synchronization
Aligns visual pacing and procedural motion to beats or speech waveforms.
Full Parameter Reference Table
Below are the core schema fields accepted by the /v1/generation/h3-max-ref endpoint:
| Parameter Name | Type | Default | Description |
|---|---|---|---|
| ref_image_urls | Array<string> | [] | List of high-resolution image URLs used as structural or stylistic visual anchors for generation. |
| ref_strength | float [0.0 - 1.0] | 0.65 | Fidelity weighting for the reference asset. Values > 0.8 enforce strict geometric and character consistency. |
| temporal_consistency | string | "high" | Enforces frame-to-frame coherence when generating video sequences from reference frames (options: "standard", "high", "cinema"). |
| audio_sync_ref | string (URL) | null | Audio or voice waveform URL to synchronize lip movement and acoustic pacing with reference video. |
| negative_prompt | string | "" | Artifacts, distortions, or style deviations to explicitly suppress during reference matching. |
| resolution | string | "1080p" | Output visual resolution target: "720p", "1080p", "2K", or "4K". |
Developer Integration Snippet (Node.js / cURL)
Example request payload executing reference-conditioned video synthesis using MiniMax H3-Max Ref:
// POST https://api.minimax.io/v1/generation/h3-max-ref
const response = await fetch('https://api.minimax.io/v1/generation/h3-max-ref', { method: 'POST', headers: { 'Authorization': 'Bearer ' + process.env.MINIMAX_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ model: 'minimax-h3-max', prompt: 'Cinematic 3D interior walkthrough, smooth forward dolly movement into the living room', ref_image_urls: ['https://assets.quickdreamviz.com/reference-room.png'], ref_strength: 0.75, temporal_consistency: 'high', resolution: '1080p', duration_seconds: 6 }) }); const data = await response.json();
Experience AI Visual Rendering in Production
Try QuickDreamViz for instant room photo restyling and cinematic 3D walkthrough videos built with state-of-the-art vision models.
Try QuickDreamViz Free