> ## 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-H3 Reference · Video to video
> Creatify's post-trained H3 reference-to-video model.
[← Creatify](/api-documentation/ai-generation/models/creatify)
**Model name:** `boreal-h3/reference-to-video`\
**Generation type:** `video_to_video`\
**Endpoint:** [`POST /api/asset_generator/`](/api-reference/ai-generation/post-ai-generation)
## Pricing
| Duration | 768P | 1088P | 2K |
| - | - | - | - |
| 5s | **2.0** | **6.0** | **13.0** |
| 6s | **2.5** | **7.5** | **16.0** |
| 7s | **3.0** | **8.5** | **18.5** |
| 8s | **3.5** | **10.0** | **21.0** |
| 9s | **4.0** | **11.0** | **23.5** |
| 10s | **4.0** | **12.0** | **26.0** |
| 11s | **4.5** | **13.5** | **29.0** |
| 12s | **5.0** | **14.5** | **31.5** |
| 13s | **5.5** | **16.0** | **34.0** |
| 14s | **6.0** | **17.0** | **36.5** |
| 15s | **6.0** | **18.0** | **39.0** |
Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.
These prices assume no billable reference inputs. The charge goes up for each second of reference video (up to 15 seconds) and each reference image beyond the included ones.
## Quick start
The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.
```bash cURL theme={null}
curl --request POST \
--url https://api.creatify.ai/api/asset_generator/ \
--header 'Content-Type: application/json' \
--header 'X-API-ID: your-api-id' \
--header 'X-API-KEY: your-api-key' \
--data '{
"model_name": "boreal-h3/reference-to-video",
"input_params": {
"prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
"reference_image_urls": [
"https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
],
"reference_video_urls": [
"https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4"
],
"reference_audio_urls": [
"https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3"
]
}
}'
```
```python Python theme={null}
import requests
response = requests.post(
"https://api.creatify.ai/api/asset_generator/",
headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
json={
"model_name": "boreal-h3/reference-to-video",
"input_params": {
"prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
"reference_image_urls": [
"https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
],
"reference_video_urls": [
"https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4"
],
"reference_audio_urls": [
"https://d35ghwdno3nak3.cloudfront.net/user/18165/2025-09-15/2d20-req-3VV9TLO6qlTOflMMQBRe-0-s.mp3"
]
},
},
)
print(response.json()["id"])
```
## Input parameters
Send these fields in `input_params`.
Refer to reference assets by modality and order: Image 1, Image 2, Video 1, Audio 1, etc.
Minimum characters: `1`.
Maximum characters: `7000`.
Up to 9 reference images. First 5 free, each additional image billed separately.
Maximum items: `9`.
Up to 3 reference video clips (2-15s each, combined ≤15s). Billed per second.
Maximum items: `3`.
Up to 3 reference audio clips (free). Requires at least one image or video reference.
Maximum items: `3`.
Rewrite the prompt with Creatify's ads prompt skill (human subject) before the render. Off sends the prompt exactly as written.
The duration of the video in seconds.
Allowed values: `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`.
The aspect ratio of the generated video. Use 'adaptive' to match reference media.
Allowed values: `"adaptive"`, `"16:9"`, `"4:3"`, `"1:1"`, `"3:4"`, `"9:16"`.
768P, 1088P or 2K resolution.
Allowed values: `"768P"`, `"1088P"`, `"2K"`.
```json theme={null}
{
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"minLength": 1,
"maxLength": 7000,
"x-support-types": [
"mentions"
],
"description": "Refer to reference assets by modality and order: Image 1, Image 2, Video 1, Audio 1, etc."
},
"reference_image_urls": {
"type": "array",
"items": {
"type": "string"
},
"title": "Reference Images",
"maxItems": 9,
"x-ui-name": "image_urls",
"x-mention-prefix": "image",
"x-free-image-count": 5,
"min_width": 256,
"min_height": 256,
"max_width": 5760,
"max_height": 5760,
"max_file_size": 31457280,
"max_aspect_ratio": 2.5,
"min_aspect_ratio": 0.4,
"description": "Up to 9 reference images. First 5 free, each additional image billed separately."
},
"reference_video_urls": {
"type": "array",
"items": {
"type": "string"
},
"title": "Reference Videos",
"maxItems": 3,
"min_duration": 2,
"max_duration": 15,
"max_total_duration": 15,
"x-ui-name": "video_urls",
"description": "Up to 3 reference video clips (2-15s each, combined ≤15s). Billed per second."
},
"reference_audio_urls": {
"type": "array",
"items": {
"type": "string"
},
"title": "Reference Audio",
"maxItems": 3,
"min_duration": 2,
"max_duration": 15,
"max_total_duration": 15,
"x-ui-name": "audio_urls",
"description": "Up to 3 reference audio clips (free). Requires at least one image or video reference."
},
"enhance_prompt": {
"type": "boolean",
"title": "Enhance Prompt",
"default": true,
"description": "Rewrite the prompt with Creatify's ads prompt skill (human subject) before the render. Off sends the prompt exactly as written.",
"x-advance-settings": true
},
"duration": {
"enum": [
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
],
"type": "integer",
"title": "Duration",
"default": 5,
"description": "The duration of the video in seconds."
},
"aspect_ratio": {
"enum": [
"adaptive",
"16:9",
"4:3",
"1:1",
"3:4",
"9:16"
],
"type": "string",
"title": "Aspect Ratio",
"default": "adaptive",
"description": "The aspect ratio of the generated video. Use 'adaptive' to match reference media."
},
"resolution": {
"enum": [
"768P",
"1088P",
"2K"
],
"type": "string",
"title": "Resolution",
"default": "768P",
"description": "768P, 1088P or 2K resolution.",
"x-advance-settings": true
}
}
}
```
## Response
The request returns the task with `status: "initializing"`. Poll [GET /api/asset\_generator/\{id}/](/api-reference/ai-generation/get-ai-generation-) until `status` is `done` or `failed`, or pass a `webhook_url` to be notified. A finished task lists its files in `assets` and the credits it charged in `credits_used`.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.