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

Muse Code · VideoReleased 2026-10-07

How to Use H3 Max Relight in Muse Code

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 Muse Code

Copy an example into Muse Code, or ask in your own words.

Use H3 Max Relight on assets/product-turntable.mp4 with assets/warm-left-sphere.png. Confirm the source is between 3 and 15 seconds, request 768p, and save a comparison with the original.

H3 Max RelightMuse Code
Try asking
  • Use H3 Max Relight to process assets/trailer-excerpt.mp4 with each sphere image in assets/lighting-tests/. Use a source excerpt between 3 and 15 seconds and label each result with its reference filename.

  • Use H3 Max Relight on assets/shoe-demo.mp4 with assets/cool-key-sphere.png at 1080p. Check the returned duration and compare the shoe's outline and movement against the source.

  • Use H3 Max Relight on the 10-second performance clip in assets/performance.mp4 with assets/amber-sphere.png. Request 768p and make a review page showing the source and result with audio controls.

  • Use H3 Max Relight on assets/product-closeup.mp4 with assets/neutral-sphere.png at 2K. First confirm the clip is between 3 and 15 seconds, then add the result to the project's asset review page.

How to set up H3 Max Relight in Muse Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Install Muse Code
    curl -fsSL https://dev.meta.ai/install.sh | bash
  2. Ask Muse to add the server

    Start muse and ask:

    Add the Spiral MCP server at https://api.spiral.ai/mcp
  3. Sign in

    In your terminal, run:

    muse mcp login spiral

Use the Spiral skill

  1. Send Muse Code this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. 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: Muse Code 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.

falVideo
H3 Max Relight
minimax/h3-max/relight

Settings you can ask for

H3 Max Relight works from your video URL. Ask Muse Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Resolution480P, 768P, 1080P, or 2K768P

Output video resolution. 480P and 768P generate natively; 1080P and 2K (1440p) use latent upscaling and refinement from 768P.

Aspect ratioadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:1616:9

Output video aspect ratio.

Seeda 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 Muse Code?

You can turn project footage into lighting comparisons for product videos, trailers, and campaign assets. Have the agent pair each clip with a sphere reference and assemble the results for review.

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.

Questions about H3 Max Relight in Muse Code

Can Muse Code use H3 Max Relight?

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run H3 Max Relight like any built-in tool.

How much does H3 Max Relight cost in Muse Code?

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 Muse Code plan is separate.

Do I need a fal account to use H3 Max Relight in Muse Code?

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 Muse Code?

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

Does Muse Code wait while H3 Max Relight runs?

H3 Max Relight runs in the background. Muse Code 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.

Get started

Start using H3 Max Relight in Muse Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Muse Code:

Set up Muse Code

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options