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

# How to Use Boreal in Codex

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 Codex

- Use Boreal to animate the product photo in this project's assets into a five-second vertical clip at 720p. Request a slow push-in, soft window light, quiet room ambience, no speech, and no on-screen text. Preserve the product's shape and label.
- Read the campaign brief in this repository and use Boreal to create three six-second creator-style ad drafts at 720p. Give each one a different short English opening line. Keep the presenter, setting, and camera direction consistent, and save the drafts for review.
- Use Boreal to create a four-second widescreen café cutaway for this project's edit at 1080p. Show a barista pouring coffee into one ceramic cup with a slow camera push-in. Request pouring sounds and café ambience, no dialogue, and no on-screen text.
- Use Boreal with the product photo in this repository to make two five-second square ad drafts at 720p. Keep the scene identical, but request a static camera in one and a slow sideways camera move in the other. Include quiet ambience and no speech.
- Use Boreal to generate a six-second presenter insert from this project's approved campaign copy at 720p. Choose one short English sentence, one presenter facing the camera, and a still background. Structure the generation prompt into visuals, speech, sounds, and text sections.

## How to set up Boreal in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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.

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

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

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

Turn a project's product images and campaign copy into short ad shots with synchronized sound. A coding agent can prepare several focused takes and place the selected footage into the project's existing video edit.

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

## 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)
- [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)
- [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 Codex guides

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

## Questions about Boreal in Codex

**Can Codex use Boreal?**

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

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

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

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

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 Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while Boreal runs?**

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

