[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [H3 Max Relight](https://spiral.ai/integrations/n8n/h3-max-relight)

# How to Use H3 Max Relight in n8n

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.

|  |  |
| --- | --- |
| Model | H3 Max Relight |
| Available through | fal |
| Category | Video |
| Price | 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. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with H3 Max Relight in n8n

- Every Monday, use H3 Max Relight on newly approved product clips between 3 and 15 seconds with our approved warm sphere reference. Make 768p comparisons and collect them for review.
- Each morning, use H3 Max Relight to apply our neutral sphere reference to new product clips between 3 and 15 seconds. Report each source and returned duration alongside the comparison.
- Every Friday, use H3 Max Relight to test our warm and cool sphere references on the latest approved 10-second campaign clip. Make 1080p results and prepare a labeled review.
- When a game trailer excerpt between 3 and 15 seconds is approved, use H3 Max Relight with our approved red sphere reference. Make a 768p comparison for the creative review.
- Each week, use H3 Max Relight with our neutral sphere reference on newly approved product close-ups between 3 and 15 seconds. Request 2K and collect the outputs for visual review.

## How to set up H3 Max Relight in n8n

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

### Use the Spiral skill

1. **Send n8n 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 Spiral's MCP server

1. **Create a key**: Create a key under API keys in the console.

2. **Add an MCP Client node**: In a workflow, add an MCP Client node (or, under an AI Agent node, an MCP Client Tool) and set:

```text
https://api.spiral.ai/mcp
```

3. **Pick a tool**: The node lists Spiral's tools. In an MCP Client node pick one, such as `run`, and give it its arguments:

```json
{
  "provider": "fal",
  "model": "fal-ai/flux/schnell",
  "input": { "prompt": "a lighthouse at dawn" },
  "wait": true
}
```

4. **Run H3 Max Relight in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds H3 Max Relight, prices it and runs it each time the step fires.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
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.

```bash
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: n8n finds H3 Max Relight on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/n8n

## H3 Max Relight tools and prices

- [H3 Max Relight](https://spiral.ai/tools/fal/minimax/h3-max/relight) (fal): 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

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| resolution | 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 | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | 16:9 | Output video aspect ratio. |
| seed |  | — | Random seed for video generation. |

## What can you do with H3 Max Relight in n8n?

You can build recurring lighting reviews from incoming short clips and approved sphere references. Have the agent collect comparisons for review and flag clips whose returned duration needs attention.

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

## Overview

- [fal](https://spiral.ai/providers/fal)
- [All n8n guides](https://spiral.ai/integrations/n8n)

## H3 Max Relight in other agents

- [Amp](https://spiral.ai/integrations/amp/h3-max-relight)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/h3-max-relight)
- [Claude](https://spiral.ai/integrations/claude-desktop/h3-max-relight)
- [Claude Code](https://spiral.ai/integrations/claude-code/h3-max-relight)
- [Cline](https://spiral.ai/integrations/cline/h3-max-relight)
- [Codex](https://spiral.ai/integrations/codex/h3-max-relight)
- [Cursor](https://spiral.ai/integrations/cursor/h3-max-relight)
- [Devin](https://spiral.ai/integrations/devin/h3-max-relight)
- [dots](https://spiral.ai/integrations/dots/h3-max-relight)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/h3-max-relight)
- [Gemini](https://spiral.ai/integrations/gemini/h3-max-relight)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/h3-max-relight)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/h3-max-relight)
- [goose](https://spiral.ai/integrations/goose/h3-max-relight)
- [Grok](https://spiral.ai/integrations/grok/h3-max-relight)
- [Grok Build](https://spiral.ai/integrations/grok-build/h3-max-relight)
- [Hermes](https://spiral.ai/integrations/hermes/h3-max-relight)
- [Instinct](https://spiral.ai/integrations/instinct/h3-max-relight)
- [Manus](https://spiral.ai/integrations/manus/h3-max-relight)
- [Muse](https://spiral.ai/integrations/muse/h3-max-relight)
- [Muse Code](https://spiral.ai/integrations/muse-code/h3-max-relight)
- [Notion](https://spiral.ai/integrations/notion/h3-max-relight)
- [OpenClaw](https://spiral.ai/integrations/openclaw/h3-max-relight)
- [opencode](https://spiral.ai/integrations/opencode/h3-max-relight)
- [Perplexity](https://spiral.ai/integrations/perplexity/h3-max-relight)
- [Raycast](https://spiral.ai/integrations/raycast/h3-max-relight)
- [VS Code](https://spiral.ai/integrations/vscode/h3-max-relight)
- [Windsurf](https://spiral.ai/integrations/windsurf/h3-max-relight)
- [Zapier](https://spiral.ai/integrations/zapier/h3-max-relight)

## More n8n guides

- [H3 Max Reframe Video](https://spiral.ai/integrations/n8n/h3-max-reframe-video)
- [H3 Max Text to Video](https://spiral.ai/integrations/n8n/h3-max-text-to-video)
- [H3 Max Reference to Video](https://spiral.ai/integrations/n8n/h3-max-reference-to-video)
- [H3 Max Turbo Extend Video](https://spiral.ai/integrations/n8n/h3-max-turbo-extend-video)
- [H3 Max Lip Sync](https://spiral.ai/integrations/n8n/h3-max-lip-sync)
- [H3 Max Turbo Image to Video](https://spiral.ai/integrations/n8n/h3-max-turbo-image-to-video)

## Questions about H3 Max Relight in n8n

**Can n8n use H3 Max Relight?**

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

**How much does H3 Max Relight cost in n8n?**

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

**Do I need a fal account to use H3 Max Relight in n8n?**

You need no fal account. n8n uses one Spiral API key for every tool, and Spiral runs H3 Max Relight on its own fal account.

**How long does it take to set up H3 Max Relight in n8n?**

About two minutes: create a key, then add an MCP Client node, then pick a tool.

**Does n8n wait while H3 Max Relight runs?**

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

