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

# How to Use Boreal in Notion

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, no API key |

## Prompts to try with Boreal in Notion

- 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 Notion

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

### Use the Spiral skill

1. **Send Notion 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. **Allow custom MCP servers**: A workspace owner opens Settings › Connections, then the Manage tab, and turns on Enable custom MCP servers. Where members may install only approved connections, also add Spiral under Approved connections › Add approved connection › Custom MCP server with the URL below.

2. **Add Spiral to a custom agent**: Open the custom agent (or create one), then Settings › Tools & Access › Add connection › Custom MCP server. Paste this URL, name it Spiral, keep OAuth and click Connect.

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

3. **Sign in to Spiral and approve**: Spiral opens: sign in, pick the organization and click Authorize. No API key. Spiral gives the connection its own key; Notion never sees it, and you can remove it under Settings › Connected apps in the console.

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: Notion finds Boreal on Spiral, shows the price and runs it.

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

## 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 Notion?

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 Notion guides](https://spiral.ai/integrations/notion)

## 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)
- [n8n](https://spiral.ai/integrations/n8n/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 Notion guides

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

## Questions about Boreal in Notion

**Can Notion use Boreal?**

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

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

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

**Do I need a fal account to use Boreal in Notion?**

No. Spiral runs Boreal on its own fal account. You sign in to Spiral once and never paste a key.

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

About two minutes: allow custom MCP servers, then add Spiral to a custom agent, then sign in to Spiral and approve.

**Does Notion wait while Boreal runs?**

Boreal runs in the background. Notion 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.

