Boreal
creatify/borealGenerate 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.
Pricing
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.
Limits
- Runs
- In the background
- Returns
- video
- 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 | Default | Description |
|---|---|---|---|
prompt required | text | — | Direction for the visuals, spoken dialogue, sounds, and on-screen text. Structure it with |
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. |
aspect_ratio | one of auto, 16:9, 9:16, 1:1, 4:3, 3:4 | auto | Frame ratio. |
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 |
manifest_disclosure | true or false | false | Add a visible |
Same request in code
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…"
}
}'Frequently asked questions
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. Per unit of `duration`: 720p (default) $0.013, 1080p $0.039, 2k $0.156. 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.