QuickDreamViz

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 NameTypeDefaultDescription
ref_image_urlsArray<string>[]List of high-resolution image URLs used as structural or stylistic visual anchors for generation.
ref_strengthfloat [0.0 - 1.0]0.65Fidelity weighting for the reference asset. Values > 0.8 enforce strict geometric and character consistency.
temporal_consistencystring"high"Enforces frame-to-frame coherence when generating video sequences from reference frames (options: "standard", "high", "cinema").
audio_sync_refstring (URL)nullAudio or voice waveform URL to synchronize lip movement and acoustic pacing with reference video.
negative_promptstring""Artifacts, distortions, or style deviations to explicitly suppress during reference matching.
resolutionstring"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
QuickDreamViz

AI-powered interior design visualization for room redesigns, virtual staging, and 3D walkthroughs.

Product

  • Features
  • Pricing
  • API
  • Changelog

Resources

  • Explore Tools
  • Best AI Apps 2026
  • Free AI Design Tools
  • Free AI Room Design
  • Design Walkthrough
  • AI Magic Brush
  • Blog

Legal

  • Privacy Policy
  • Terms of Service
  • Cookie Policy

© 2026 QuickDreamViz. All rights reserved.

Made with ❤️ for interior design enthusiasts