H3 Max Relight
minimax/h3-max/relightEdit and transform video with H3 Max Relight from fal through one Spiral API key. Relight any video with H3 Max from a lighting sphere image, while preserving the source subjects, motion, camera and audio. It runs in the background and returns video. Pay as you go, with no subscription.
Pricing
Up to $6.24 per run at the default inputs for 60 seconds of input. resolution: 480P $3.90, 768P (default) $6.24, 1080P $12.48, 2K $24.96.
Limits
- Runs
- In the background
- Returns
- video
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 930 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
video_url required | URL or file | — | Source video up to 15 seconds long. Converted to constant 24 fps and trimmed at the end to the closest 17n+5 frame count, with at least 56 frames (about 2.33 seconds) remaining. The output matches this prepared video's frame count and duration. |
reference_image_url required | text | — | Sphere render showing the target lighting. |
resolution | one of 480P, 768P, 1080P, 2K | 768P | Output video resolution. 480P and 768P generate natively; 1080P and 2K (1440p) use latent upscaling and refinement from 768P. |
aspect_ratio | one of adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 16:9 | Output video aspect ratio. |
seed | number (whole) | — | Random seed for video generation. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "fal",
"model": "minimax/h3-max/relight",
"input": {
"video_url": "<video_url>",
"reference_image_url": "<reference_image_url>"
}
}'Frequently asked questions
How much does H3 Max Relight cost?
Up to $6.24 per run at the default inputs for 60 seconds of input. `resolution`: 480P $3.90, 768P (default) $6.24, 1080P $12.48, 2K $24.96. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use H3 Max Relight through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "minimax/h3-max/relight"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with fal to use H3 Max Relight?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use H3 Max Relight?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.