MiniMax H3 Reference to Video

minimax/h3/reference-to-video

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

Base price
$0.65USD / run
Execution
async
Model type
video
Input fields
8
Production route

Try the model

Playground

Open playground
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.
Output aspect ratio. Omit to let the model choose from the prompt and reference inputs. Allowed values: 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.
OutputExample

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.65 / run

Context & modalities

Input
Schema-defined
Output
video

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
MiniMax
Model ID
minimax/h3/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

MiniMax H3 Reference to Video

MiniMax H3 reference-to-video: up to 9 images, 3 videos, and 3 audio clips keep characters, motion, and voice consistent in a new 2K clip.

Fields

FieldTypeDefaultNotes
promptstring, required—Up to 7,000 characters.
imagesimage URL[] (≤9)—Reference images, Image 1, Image 2, …
videosvideo URL[] (≤3)—Reference clips, Video 1, …
audiosaudio URL[] (≤3)—Reference audio, Audio 1, …
duration4–15, required5Output length in seconds.
aspect_ratio21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16—Output frame shape.
resolution768P / 2K2KSets the per-second rate.
aigc_watermarkbooleanfalseAdd MiniMax's AI-generated watermark.

Billing

You pay for output seconds: $0.13 at 2K (the default) and $0.06 at 768P. Each reference image beyond the fifth adds $0.04.

Output2K768P
4s$0.52$0.24
5s (default)$0.65$0.30
10s$1.30$0.60
15s$1.95$0.90
5s with 9 images$0.81$0.46

Failed runs are not charged.

Prompting

  • Give each reference a role: “Image 1 is the singer, Audio 1 is her voice, Video 1 sets the dance”.

Limits

  • duration is required.

Also on SandBase

Other MiniMax H3 endpoints: minimax/h3/text-to-video, minimax/h3/image-to-video, minimax/h3-max/reference-to-video (faster, cheaper).

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
minimax/h3/reference-to-video
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "minimax/h3/reference-to-video",
  "prompt": "Keep the referenced character and motion consistent while creating a cinematic garden scene with synchronized ambient sound.",
  "duration": 5,
  "resolution": "2K",
  "aigc_watermark": false
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
MiniMaxVideo$0.65 / runJul 29, 2026
MiniMaxVideo$0.20 / runOct 1, 2026
MiniMaxVideo$0.20 / runSep 2, 2026
MiniMaxVideo$0.20 / runSep 2, 2026
MiniMaxVideo$0.40 / runAug 31, 2026
MiniMaxVideo$0.40 / runAug 26, 2026

Questions

FAQ

How do I call MiniMax H3 Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "minimax/h3/reference-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate MiniMax account?

No. One SandBase API key and balance gives you access to MiniMax H3 Reference to Video and the other models in the catalog; you do not need to sign up with MiniMax separately.