Spiral gives your agent every tool with one account. Browse the tools →

falVideoAvailable nowReleased 2026-10-07

H3 Max Relight

minimax/h3-max/relight

Edit 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

FieldKindDefaultDescription
video_url requiredURL 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 requiredtext—

Sphere render showing the target lighting.

resolutionone 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_ratioone of
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
16:9

Output video aspect ratio.

seednumber (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.