How to Use H3 Max Relight in Claude
H3 Max Relight changes the lighting in an existing video using a lighting sphere reference. Use it to try new light directions and colors while retaining the subjects, motion, camera, and soundtrack.
Prompts to try with H3 Max Relight in Claude
Copy an example into Claude, or ask in your own words.
Use H3 Max Relight on this 8-second product clip with the attached warm lighting sphere. Make a 768p result and show it beside the original.
Use H3 Max Relight on this 10-second performance excerpt with the attached cool lighting sphere. Make a 1080p result and help me check the movement and soundtrack.
Use H3 Max Relight to compare the two attached sphere references on this 6-second shoe video. Make both results at 768p and label them warm and cool.
Use H3 Max Relight on this 12-second game clip with the attached red lighting sphere. Show the result beside the source so I can judge the mood and visibility.
Use H3 Max Relight on this 5-second product close-up with the attached neutral lighting sphere. Request 2K and show me the result for review.
How to set up H3 Max Relight in Claude
Pick the way that suits you. Each takes about two minutes.
Use the Claude connector
- Add Spiral to Claude
Click Add Spiral in Claude above. Claude opens Add custom connector with Spiral and its URL filled in; check them and click Continue. Without the link: in Claude open Customize › Connectors › Add › Add custom connector and paste this URL:
https://api.spiral.ai/mcp
- Keep the detected sign-in and click Add
Claude finds Spiral's sign-in by itself: leave Sign in now and Use Claude's published identity selected.
- Click Connect
The connector page opens. Connect takes you to Spiral in your browser.
Use the Spiral skill
- Send Claude this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run H3 Max Relight
One request; the result comes back by polling or a webhook.
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>" } }'
Then paste one of the prompts above: Claude finds H3 Max Relight on Spiral, shows the price and runs it.
H3 Max Relight providers and prices
Spiral runs H3 Max Relight through fal. Open a card for today's price, with every fee included.
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.
Settings you can ask for
H3 Max Relight works from your video URL. Ask Claude for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Resolution | 480P, 768P, 1080P, or 2K | 768P | Output video resolution. 480P and 768P generate natively; 1080P and 2K (1440p) use latent upscaling and refinement from 768P. |
| Aspect ratio | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16 | 16:9 | Output video aspect ratio. |
| Seed | a whole number | Random seed for video generation. |
Every API field of H3 Max Relight is on its tool page: open its card above.
What can you do with H3 Max Relight in Claude?
You can compare new lighting looks on footage you already like. Ask the agent to use a supplied sphere reference, then review the subjects, movement, and soundtrack against the original.
Product lighting comparisons
Try warm and cool sphere references on the same short product clip. Compare how each treatment changes highlights and shadows.
Seasonal product ads
Test an amber lighting reference on an existing product video for a fall campaign. Review the product's appearance before using the result.
Lighting continuity studies
Apply one lighting reference to several short shots and compare them together. Use the results to assess whether their lighting feels consistent.
Game trailer mood tests
Try directional colored light on a short gameplay or cutscene clip. Compare the mood while checking that the original action remains intact.
Music video look development
Test contrasting lighting references on a short performance excerpt. Review the treatment alongside the original movement and soundtrack.
Lighting reference reviews
Run several sphere references against one approved clip and assemble a comparison. Choose a direction before applying it to more footage.
More on H3 Max Relight and Claude
Overview
H3 Max Relight in other agents
Questions about H3 Max Relight in Claude
Can Claude use H3 Max Relight?
Yes. Add Spiral to Claude as an MCP server, and Claude can find and run H3 Max Relight like any built-in tool.
How much does H3 Max Relight cost in Claude?
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 from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude plan is separate.
Do I need a fal account to use H3 Max Relight in Claude?
No. Spiral runs H3 Max Relight on its own fal account. You sign in to Spiral once and never paste a key.
How long does it take to set up H3 Max Relight in Claude?
About two minutes: add Spiral to Claude, then keep the detected sign-in and click Add, then click Connect.
Does Claude wait while H3 Max Relight runs?
H3 Max Relight runs in the background. Claude starts the run, checks on it and gives you the video when it's ready.
What is H3 Max Relight useful for?
Use it to try different lighting on footage whose subjects and movement you already want to keep. Product clips, lighting comparisons, and mood studies are practical starting points.
How do I describe the lighting I want?
Show it in a lighting sphere image. H3 Max Relight takes no text prompt, so instructions to your agent should identify the reference to use or describe the reference you need prepared.
How long can the source clip be?
The source can be up to 15 seconds. Preparation converts it to 24 fps and trims it to a supported frame count, so check the returned duration before placing it in an edit.
Does H3 Max Relight generate native 2K video?
Its native outputs are 480p and 768p. The 1080p and 2K outputs use upscaling and refinement from 768p; 2K means 1440p here.
Will the result match the reference lighting exactly?
Treat the reference as a target and review the result. In fal's published test, eight setups transferred only partly and the backlit silhouette did not transfer.
Start using H3 Max Relight in Claude
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude:
set up https://spiral.ai/SKILL.md


