[Integrations](https://spiral.ai/integrations) › [n8n](https://spiral.ai/integrations/n8n) › [Boreal](https://spiral.ai/integrations/n8n/boreal)

# How to Use Boreal in n8n

Boreal makes short product ads, creator-style clips, and presenter videos with synchronized sound. Its strongest fit is a simple scene with one clear action, including shots animated from a product photo.

|  |  |
| --- | --- |
| Model | Boreal |
| Available through | fal |
| Category | Video |
| Price | Up to $0.13 per run at the default inputs. `resolution`: 720p (default) $0.13, 1080p $0.39, 2k $1.56. $0.013 per unit of `duration`. |
| Returns | video |
| Runs | In the background |
| Setup | About 2 minutes, with a Spiral API key |

## Prompts to try with Boreal in n8n

- Every Monday, use Boreal to create three five-second vertical product drafts from the approved product photo at 720p. Keep the product and background consistent while changing the camera movement. Request ambient sound, no speech, and no on-screen text. Present the drafts for review.
- Each weekday, use Boreal to make one three-second widescreen café cutaway at 720p. Rotate between coffee pouring, steam rising, and a cup being set down, using only one action per clip. Request matching café sounds, no dialogue, and no on-screen text.
- Every Friday, use Boreal to create two six-second creator-style ad drafts at 720p from the approved campaign message. Change only the short English opening line. Keep the setting and camera still, request quiet ambience, and prepare both takes for review.
- At the start of each campaign week, use Boreal to animate the approved product photo into a five-second square lifestyle shot at 720p. Choose one setting from the campaign brief and one slow camera move. Request matching ambience with no speech or on-screen text.
- Every Wednesday, use Boreal to create a five-second vertical presenter draft at 720p using one short English sentence from the approved message. Request one person, a plain background, natural delivery, and no on-screen text. Include a reminder to review the lip-sync.

## How to set up Boreal 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 Boreal in a workflow step**: Give the step an instruction like the ones below and run it on your trigger or schedule. Spiral finds Boreal, 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 Boreal**: 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": "creatify/boreal",
    "input": {
      "prompt": "[VISUAL]\nA cinematic product close-up of a sparkling-water can on wet black stone.\nCondensation rolls down the can as the camera makes a slow…"
    }
  }'
```

Then paste one of the prompts above: n8n finds Boreal on Spiral, shows the price and runs it.

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

## Boreal tools and prices

- [Boreal](https://spiral.ai/tools/fal/creatify/boreal) (fal): Up to $0.13 per run at the default inputs. `resolution`: 720p (default) $0.13, 1080p $0.39, 2k $1.56. Per unit of `duration`: 720p (default) $0.013, 1080p $0.039, 2k $0.156.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| image_url |  | — | Optional reference image to animate. Guides identity, composition, and appearance; the output follows this image's aspect ratio. |
| audio_url |  | — | Optional driving audio (narration, dialogue, or a soundtrack). When provided it is preserved in the output instead of generated speech. |
| negative_prompt |  |  | Content or artifacts to avoid in the generated video. |
| resolution | 720p, 1080p, 2k | 720p | Delivery tier. `2k` is 2016 px on the long edge for 16:9 and 9:16, and the 1440p row for 1:1, 4:3 and 3:4. |
| aspect_ratio | auto, 16:9, 9:16, 1:1, 4:3, 3:4 | auto | Frame ratio. `auto` follows the reference image's own ratio, and is landscape (16:9) when there is no image. A named ratio renders that ratio; with an image it centre-crops the image to it. |
| duration | 1 to 20 | 10 | Length of the generated video in seconds at 24 FPS, rounded by the model to the nearest legal frame count (5 s -> 121 frames, 10 s -> 241, 15 s -> 361). With `audio_url`, the first `duration` seconds of the audio are used; shorter audio is padded with silence. |

## What can you do with Boreal in n8n?

Prepare recurring batches of short ad concepts and social footage for review. An always-on agent can keep each batch focused on a single campaign idea and change one creative choice at a time.

### Product hero shots

Animate a product photo into a five-second close-up with a slow camera move and matching ambient sound. Review the product's shape and label before choosing a take.

### Product lifestyle scenes

Use a product photo to guide a short scene on a kitchen counter, desk, or café table. Keep the action focused on one item.

### Creator-style ad concepts

Generate a short direct-to-camera pitch with one English line. Compare different openings while keeping the setting and action consistent.

### Presenter inserts

Make a brief presenter segment for an explainer or product introduction. Check speech and mouth movement before adding it to the edit.

### Social opening shots

Create a two- or three-second opening built around one visible action, such as a lid opening or coffee pouring. Specify the accompanying sound.

### B-roll for an existing edit

Generate a short cutaway of a workspace, café, or product detail. Match the camera direction, lighting, and duration to the surrounding footage.

### Ad concept comparisons

Produce several short takes of the same concept, changing only the opening line or camera movement. Compare the results before developing the chosen direction.

## Overview

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

## Boreal in other agents

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

## More n8n guides

- [Auto Subtitle](https://spiral.ai/integrations/n8n/auto-subtitle)
- [Bria VRMBG 3.0](https://spiral.ai/integrations/n8n/bria-vrmbg-3-0)
- [Yahoo NBA player news](https://spiral.ai/integrations/n8n/yahoo-nba-player-news)
- [Bria Video Background Removal](https://spiral.ai/integrations/n8n/bria-video-background-removal)
- [Yahoo Fantasy Football public team roster](https://spiral.ai/integrations/n8n/yahoo-fantasy-football-public-team-roster)
- [Bria Video Eraser](https://spiral.ai/integrations/n8n/bria-video-eraser)

## Questions about Boreal in n8n

**Can n8n use Boreal?**

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

**How much does Boreal cost in n8n?**

Up to $0.13 per run at the default inputs. `resolution`: 720p (default) $0.13, 1080p $0.39, 2k $1.56. $0.013 per unit of `duration`. 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 Boreal in n8n?**

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

**How long does it take to set up Boreal in n8n?**

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

**Does n8n wait while Boreal runs?**

Boreal runs in the background. n8n starts the run, checks on it and gives you the video when it's ready.

**What is Boreal best at?**

Short product ads, creator-style clips, and presenter videos with synchronized sound. Creatify says short clips and simple scenes are its strongest fit, so start with one subject and one clear action.

**Where does Boreal need closer review?**

Review speaking shots carefully. Creatify reports that lip-sync holds level with Boreal's base model, so check mouth movement against the spoken line before using a take.

**How should I write a Boreal prompt?**

Use four labeled sections: [VISUAL], [SPEECH], [SOUNDS], and [TEXT]. Describe the action and camera movement, write the spoken line explicitly, and state whether any text should appear.

**Which language should I use with Boreal?**

English is the validated language in the documentation. Use English for directions and dialogue when you want to stay within the documented language guidance.

**How long should a Boreal shot be?**

The documented short-clip range is 1 to 20 seconds. Start with a three- to six-second shot containing one action, then review it before attempting a longer scene.

