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

> 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](/api-documentation/boreal/boreal). For start and end frames or reference media, use [Boreal-H3](/api-documentation/boreal/model-boreal-h3).

## 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](/api-documentation/boreal/boreal#-pricing-limits-and-retention) to compare every model.

## Requests

<CodeGroup>
  ```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
  }
  ```
</CodeGroup>

## 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).

<div className="mx-auto w-full" style={{ maxWidth: "360px" }}>
  <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" className="block w-full rounded-xl bg-black" style={{ aspectRatio: "9 / 16" }} />

  <div className="mt-2 text-sm text-center text-gray-500 dark:text-gray-400">Audio driven</div>
</div>

## Parameters

| Parameter | Required | Description |
| - | - | - |
| `model` | No | `boreal` (default). For `boreal-h3`, see [Boreal-H3](/api-documentation/boreal/model-boreal-h3). |
| `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.