API Free WeekHundreds of APIs are free to call this week.Browse free APIs

MiniMax H3 Max Reference to Video

minimax/h3-max/reference-to-video

MiniMax H3 Max by MiniMax generates a 5-15 second video with native audio at 480P or 768P that keeps subjects, motion, and voice consistent with reference images, videos, and audio.

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

Try the model

Playground

Open playground
Input
Text prompt for video generation. Refer to reference assets by their modality and order in the reference lists: Image 1, Image 2, Video 1, Audio 1, and so on.
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.
The native generation resolution of the video. Allowed values: 480P, 768P.
515
The duration of the video in seconds. Range: 5 to 15.

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

Up to 9 subject or style reference image URLs, referenced in the prompt as Image 1, Image 2, and so on.
How much effort to spend rewriting the prompt before generation. `balanced` returns in about a second; `quality` spends up to ~30 seconds on a richer prompt. Allowed values: balanced, quality.
Up to 3 motion or reference video URLs (2-15 seconds each, at most 15 seconds combined), referenced in the prompt as Video 1, Video 2, and so on.
Up to 3 reference audio URLs (2-15 seconds each, at most 15 seconds combined), referenced in the prompt as Audio 1, Audio 2, and so on. Audio requires at least one reference image or video.
OutputExample

Examples

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

Model card

Specifications

Pricing

Base price
$0.40 / 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-max/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

MiniMax H3 Max Reference to Video

MiniMax H3 Max reference-to-video: images, videos, and audio references keep subjects, motion, and voice consistent in a 5–15 second clip.

Fields

FieldTypeDefaultNotes
promptstring, required—Up to 50,000 characters.
aspect_ratio21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16—Output frame shape.
resolution480P / 768P768PSets the per-second rate.
durationinteger 5–155Output length in seconds.
imagesimage URL[] (≤9)—Reference images, Image 1, Image 2, …
prompt_expansion_modebalanced / qualitybalancedbalanced rewrites the prompt lightly; quality expands it more for richer detail.
videosvideo URL[] (≤3)—Reference clips, Video 1, …
audiosaudio URL[] (≤3)—Reference audio, Audio 1, …

Billing

You pay for output seconds: $0.08 at 768P and $0.05 at 480P. Very large reference sets (over 4,096 reference tokens) add $0.02 per 1,000 extra tokens.

Output768P480P
5s (default)$0.40$0.25
10s$0.80$0.50
15s$1.20$0.75

Failed runs are not charged.

Prompting

  • Describe subject, action, camera, and sound in order.
  • Quote dialogue and name the speaker.

Limits

  • Clips are 5–15 seconds.

Also on SandBase

Other MiniMax H3 Max endpoints: minimax/h3-max/text-to-video, minimax/h3-max/image-to-video, minimax/h3/reference-to-video (2K).

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-max/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-max/reference-to-video",
  "images": [
    "https://static.sandbase.ai/examples/minimax/mirrored/example_inputs/hailuo23/pro_i2v_in.jpg"
  ],
  "prompt": "Image 1 is the female protagonist. Image 2 is her small dog. Keep the woman and dog consistent with their respective reference images while they walk together through a sunlit garden.",
  "duration": 5,
  "resolution": "768P",
  "prompt_expansion_mode": "balanced"
}
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.40 / runAug 31, 2026
MiniMaxVideo$0.20 / runOct 1, 2026
MiniMaxVideo$0.20 / runSep 2, 2026
MiniMaxVideo$0.20 / runSep 2, 2026
MiniMaxVideo$0.40 / runAug 26, 2026
MiniMaxVideo$0.40 / runAug 26, 2026

Questions

FAQ

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

Create a SandBase API key, then send requests with the model ID "minimax/h3-max/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 Max Reference to Video and the other models in the catalog; you do not need to sign up with MiniMax separately.