# Boreal

Generate video from text and reference media with Boreal from fal through one Spiral API key. It runs in the background and returns video. Pay as you go, with no subscription.

- Provider: fal
- Category: Video
- Runs: In the background
- Returns: video
- Tool id: `fal` / `creatify/boreal`
- Page: https://spiral.ai/tools/fal/creatify/boreal

## Pricing

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

## Limits

- Longest queue wait: 1 hour
- Run deadline: 1 hour
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `prompt` (required) | text |  | — | Direction for the visuals, spoken dialogue, sounds, and on-screen text. Structure it with `[VISUAL]`, `[SPEECH]`, `[SOUNDS]`, and `[TEXT]` sections for best results. English is the validated language. |
| `image_url` | URL or file |  | — | Optional reference image to animate. Guides identity, composition, and appearance; the output follows this image's aspect ratio. |
| `audio_url` | URL or file |  | — | Optional driving audio (narration, dialogue, or a soundtrack). When provided it is preserved in the output instead of generated speech. |
| `negative_prompt` | text |  |  | Content or artifacts to avoid in the generated video. |
| `resolution` | one of | 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` | one of | 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` | number | 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. |
| `manifest_disclosure` | true or false |  | false | Add a visible `AI-generated` disclosure label to the video. Invisible C2PA metadata and watermarking are always applied. |

## Example

```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…"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=creatify%2Fboreal

## Common questions

### Boreal

**How much does Boreal cost?**

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 as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Boreal through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "creatify/boreal"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Boreal?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Boreal?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

