H3 Max Reference to Video
minimax/h3-max/reference-to-videoH3 Max is MiniMax's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.
- Base price
- $0.40USD / run
- Execution
- async
- Model type
- video
- Input fields
- 9
Try the model
Playground
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
Your output will appear here
Complete the inputs, then click Run.
Specifications
Pricing
- Base price
- $0.40 / run
- Billing formula
- (usage.duration ?? params.duration ?? 5.0) * 0.08 + Math.max((usage.reference_tokens ?? 4096.0) - 4096.0, 0.0) * 0.00002
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
- API
- Unified Run API
- Endpoint
- /v1/run
API README
MiniMax H3 Max Reference to Video
Generate video from a text prompt plus image, video, and audio references with MiniMax H3 Max. Reference assets can establish subject identity, appearance, motion, timing, dialogue, ambience, and style.
The endpoint supports 5–15 second output at 480P or 768P, adaptive or fixed aspect ratios, and up to 12 reference files in total. Audio cannot be the only reference modality.
Pricing
fal charges $0.08 per generated second. Reference inputs share a 4,096-token free allowance; usage above the allowance costs $0.02 per 1,000 tokens.
Technical Specs
- Model ID:
minimax/h3-max/reference-to-video - Required input:
prompt - Duration: 5–15 seconds; default 5
- Resolution:
480Por768P; default768P - References: images, videos, and audio; maximum 12 files combined
- Reference video/audio duration: 2–15 seconds each; maximum 15 seconds combined per modality
- Output: downloadable video URL
- Execution: asynchronous
Start building
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
# 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",
"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",
"reference_image_urls": [
"https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"
],
"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
| Model | Context | Input / 1M | Output / 1M | Released |
|---|---|---|---|---|
H3 Max Reference to VideoThis model MiniMax | — | — | — | Aug 31, 2026 |
MiniMax | — | — | — | Aug 26, 2026 |
MiniMax | — | — | — | Aug 26, 2026 |
MiniMax | — | — | — | Aug 14, 2026 |
MiniMax | — | — | — | Jul 29, 2026 |
MiniMax | — | — | — | Jul 29, 2026 |
