> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Boreal API: Videos up to 60 Seconds

> The original Boreal model: up to 60 seconds of video from a prompt, a start image or an audio track.

`boreal` is the default when `model` is omitted. It renders longer videos than Boreal-H3 (up to 60 seconds at 720p) and can be driven by an audio track. For the request lifecycle (polling and webhooks), see the [Boreal overview](https://docs.creatify.ai/api-documentation/boreal/boreal.md). For start and end frames or reference media, use [Boreal-H3](https://docs.creatify.ai/api-documentation/boreal/model-boreal-h3.md).

## Pricing

Billing is per started 10 seconds of video. Each resolution has a maximum video length, which applies to `duration` and to the length of `audio_url`:

| Resolution | Maximum length | Credits per 10 seconds |
| - | - | - |
| 720p | 60 seconds | 1 |
| 1080p | 30 seconds | 3 |
| 2k | 15 seconds | 12 |

For example, a 15-second 720p video costs 2 credits.

Failed videos are refunded automatically, and generated videos stay available for at least 7 days. See [Pricing, limits and retention](https://docs.creatify.ai/api-documentation/boreal/boreal.md#-pricing-limits-and-retention) to compare every model.

## Requests

```bash Text to video theme={null}
curl --request POST \
    --url https://api.creatify.ai/api/boreal/ \
    --header 'Content-Type: application/json' \
    --header 'X-API-ID: your-api-id' \
    --header 'X-API-KEY: your-api-key' \
    --data '{
    "prompt": "A barista pours latte art into a white ceramic cup. Slow push-in, warm morning light, soft cafe chatter in the background.",
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "duration": 10,
    "webhook_url": "https://webhook.example"
  }'
```

```bash Image to video theme={null}
curl --request POST \
    --url https://api.creatify.ai/api/boreal/ \
    --header 'Content-Type: application/json' \
    --header 'X-API-ID: your-api-id' \
    --header 'X-API-KEY: your-api-key' \
    --data '{
    "prompt": "The woman looks into the camera and says with a warm smile: \"Planning your next trip just got easier.\" Handheld UGC sway, soft natural light.",
    "image_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg",
    "resolution": "720p",
    "duration": 10,
    "webhook_url": "https://webhook.example"
  }'
```

```bash Audio driven theme={null}
curl --request POST \
    --url https://api.creatify.ai/api/boreal/ \
    --header 'Content-Type: application/json' \
    --header 'X-API-ID: your-api-id' \
    --header 'X-API-KEY: your-api-key' \
    --data '{
    "prompt": "The woman talks to the camera with natural hand gestures, soft natural light.",
    "image_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/boreal-presenter.jpg",
    "audio_url": "https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3",
    "resolution": "2k",
    "webhook_url": "https://webhook.example"
  }'
```

```json Example Response (pending) theme={null}
{
    "id": "8f0b3c6e-2d4a-4a57-9c1e-5b7f2e9d1a34",
    "created_at": "2026-09-15T10:30:06.296630-07:00",
    "updated_at": "2026-09-15T10:30:06.296681-07:00",
    "model": "boreal",
    "prompt": "A barista pours latte art into a white ceramic cup. Slow push-in, warm morning light, soft cafe chatter in the background.",
    "image_url": null,
    "end_image_url": null,
    "audio_url": null,
    "reference_image_urls": [],
    "reference_video_urls": [],
    "reference_audio_urls": [],
    "resolution": "720p",
    "aspect_ratio": "9:16",
    "duration": 10.0,
    "negative_prompt": null,
    "prompt_enhancement": null,
    "webhook_url": "https://webhook.example",
    "status": "pending",
    "failed_reason": null,
    "video_output": null,
    "credits_used": 0,
    "progress": 0
}
```

## Examples

The "Audio driven" request above, rendered at `2k`. The video is as long as its 10.4-second audio, billed as two 10-second units (24 credits).

<video controls playsInline preload="metadata" poster="https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/boreal-audio-driven-2k.jpg" src="https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/boreal-audio-driven-2k.mp4" />

Audio driven

## Parameters

| Parameter | Required | Description |
| - | - | - |
| `model` | No | `boreal` (default). For `boreal-h3`, see [Boreal-H3](https://docs.creatify.ai/api-documentation/boreal/model-boreal-h3.md). |
| `prompt` | Yes | What the video should show: subject, action, camera, and any dialogue or sound. |
| `image_url` | No | Start frame. The video follows the image's own aspect ratio unless `aspect_ratio` names one, which centre-crops the image to it. |
| `audio_url` | No | Audio track (`mp3` or `wav`) that drives the video. When set, the video is as long as the audio (within the same length limit as `duration`) and `duration` is ignored. |
| `resolution` | No | `720p` (default), `1080p` or `2k`. 2k is 2016 px on the long edge for 16:9 and 9:16, and 1440p for 1:1, 4:3 and 3:4. |
| `aspect_ratio` | No | `auto` (default), `16:9`, `9:16`, `1:1`, `4:3` or `3:4`. `auto` follows the start image, and is 16:9 without an image. |
| `duration` | No | Video length in seconds, greater than 0. Up to 60 at 720p, 30 at 1080p and 15 at 2k. Default `10`. |
| `negative_prompt` | No | What the video should avoid. |
| `webhook_url` | No | URL that receives the result when the video is ready. |

Sending a Boreal-H3-only input (`end_image_url`, `reference_*_urls`, `prompt_enhancement`) or a Boreal-H3 resolution (`768p`, `1088p`) with `model: "boreal"` returns a 400 error.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.