SandBase is live — $1 in free credits on signupStart free ›

MiniMax modelsvideo generation api

minimax/h3/reference-to-video

Generate native-stereo 2K video guided by image, video, and audio references with MiniMax H3.

Input

PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 9

Enter a JSON array.
Each clip must be 2–15 seconds; combined duration must not exceed 15 seconds.
Audio requires at least one reference image or video.
Allowed values: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
Allowed values: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
Output resolution. 768P is generated natively; 2K is upscaled via an in-context regeneration pass. Allowed values: 768P, 2K.
Whether to add an AIGC label watermark to the generated video.
Idle

Example output — click Run to generate your own

API README

MiniMax H3 Reference to Video

MiniMax H3 Reference to Video creates native-stereo video from a prompt plus optional image, video, and audio references. It can combine up to nine images, three video clips, and three audio clips, giving a single generation access to appearance, motion, scene, and sound cues.

The route supports 4–15 second outputs at 768P or 2K, with adaptive and six fixed aspect ratios. Reference clips can influence completed-task duration, so final billing prefers reported usage.total_seconds; the selected output duration is only the fallback when that usage value is absent.

Highlights

  • Unified multimodal references. Mix images, video clips, and audio clips in one request to guide character identity, motion, environment, timing, and sound.
  • Native stereo output. Generate video with synchronized stereo audio rather than treating sound as a separate post-production step.
  • Longer reference-guided shots. Select 4–15 seconds of output and provide up to three reference videos, each 2–15 seconds with a 15-second combined limit.
  • High-resolution delivery. Choose native 768P or 2K produced through an in-context regeneration upscale, with adaptive or fixed cinematic and social aspect ratios.

Pricing

Final billing uses completed-task usage.total_seconds when present. If it is absent, the selected duration is used. The time charge is $0.08 per total second at 768P or $0.13 per total second at 2K. The first five reference images are included; images 6–9 add $0.04 each. Reference audio has no separate term in this pricing formula.

Fallback duration prices below apply only when usage.total_seconds is absent and before any extra-image surcharge.

DurationResolutionFallback priceCondition
4 seconds768P$0.32Only when usage.total_seconds is absent; excludes extra-image surcharge.
4 seconds2K$0.52Only when usage.total_seconds is absent; excludes extra-image surcharge.
5 seconds768P$0.40Only when usage.total_seconds is absent; excludes extra-image surcharge.
5 seconds2K$0.65Only when usage.total_seconds is absent; excludes extra-image surcharge.
6 seconds768P$0.48Only when usage.total_seconds is absent; excludes extra-image surcharge.
6 seconds2K$0.78Only when usage.total_seconds is absent; excludes extra-image surcharge.
7 seconds768P$0.56Only when usage.total_seconds is absent; excludes extra-image surcharge.
7 seconds2K$0.91Only when usage.total_seconds is absent; excludes extra-image surcharge.
8 seconds768P$0.64Only when usage.total_seconds is absent; excludes extra-image surcharge.
8 seconds2K$1.04Only when usage.total_seconds is absent; excludes extra-image surcharge.
9 seconds768P$0.72Only when usage.total_seconds is absent; excludes extra-image surcharge.
9 seconds2K$1.17Only when usage.total_seconds is absent; excludes extra-image surcharge.
10 seconds768P$0.80Only when usage.total_seconds is absent; excludes extra-image surcharge.
10 seconds2K$1.30Only when usage.total_seconds is absent; excludes extra-image surcharge.
11 seconds768P$0.88Only when usage.total_seconds is absent; excludes extra-image surcharge.
11 seconds2K$1.43Only when usage.total_seconds is absent; excludes extra-image surcharge.
12 seconds768P$0.96Only when usage.total_seconds is absent; excludes extra-image surcharge.
12 seconds2K$1.56Only when usage.total_seconds is absent; excludes extra-image surcharge.
13 seconds768P$1.04Only when usage.total_seconds is absent; excludes extra-image surcharge.
13 seconds2K$1.69Only when usage.total_seconds is absent; excludes extra-image surcharge.
14 seconds768P$1.12Only when usage.total_seconds is absent; excludes extra-image surcharge.
14 seconds2K$1.82Only when usage.total_seconds is absent; excludes extra-image surcharge.
15 seconds768P$1.20Only when usage.total_seconds is absent; excludes extra-image surcharge.
15 seconds2K$1.95Only when usage.total_seconds is absent; excludes extra-image surcharge.
Reference imagesExtra-image surcharge
1–5$0.00
6$0.04
7$0.08
8$0.12
9$0.16

When to Use

Use caseWhy this model fits
Character-consistent scenesUse several images to establish appearance, wardrobe, props, and environment.
Motion transfer and choreographyProvide short video references for movement, pacing, or camera behavior.
Audio-led videoSupply voice, music, or ambience references to guide synchronized native-stereo output.
Reference-rich story shotsCombine visual, motion, and sound cues within one 4–15 second generation.
High-resolution social or cinematic deliveryChoose adaptive framing or a fixed ratio at 768P or 2K.

Prompt Guide

State what must remain consistent from the references, then describe the new action and scene in chronological order. Separate character, motion, camera, lighting, and audio direction into clear clauses. Use reference media only when it contributes a distinct cue, and remember that reference-video time can affect usage.total_seconds and therefore the final charge.

{
  "prompt": "Keep the lead character's face, green jacket, and silver bicycle consistent with the reference images. Follow the smooth turn and forward motion from the reference video as the character rides through a sunlit botanical garden. Begin with a medium tracking shot, arc slowly to the front, and end on a wide reveal. Preserve the referenced birdsong and add subtle bicycle-wheel movement in native stereo.",
  "images": [
    "https://example.com/character-front.jpg",
    "https://example.com/character-outfit.jpg"
  ],
  "videos": ["https://example.com/bicycle-motion.mp4"],
  "audios": ["https://example.com/garden-ambience.wav"],
  "duration": 10,
  "aspect_ratio": "16:9",
  "resolution": "2K",
  "aigc_watermark": false
}

Technical Specs

PropertyDetails
Model IDminimax/h3/reference-to-video
Required inputsprompt, duration
Reference imagesUp to 9
Reference videosUp to 3; each 2–15 seconds, maximum 15 seconds combined
Reference audioUp to 3; requires at least one reference image or video
Prompt length1–7,000 characters
Output durationWhole seconds from 4 through 15; default 5
Resolution768P or 2K (default)
Aspect ratioadaptive (default), 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Watermark controlOptional aigc_watermark; default false
OutputDownloadable video URL with optional content type
ExecutionAsynchronous

Related Models

Related Models