> ## 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.
# Kling O3 Pro (reference-to-video) · Image to video
> Style reference tool, Pro precisely clones features for commercial-grade consistency.
[← Kling](/api-documentation/ai-generation/models/kling)
**Model name:** `kling-video/o3/pro/reference-to-video`\
**Generation type:** `image_to_video`\
**Endpoint:** [`POST /api/asset_generator/`](/api-reference/ai-generation/post-ai-generation)
## Pricing
| Duration | Credits |
| - | - |
| 3s | **4.5** |
| 4s | **6.0** |
| 5s | **7.0** |
| 6s | **8.5** |
| 7s | **10.0** |
| 8s | **11.5** |
| 9s | **13.0** |
| 10s | **14.0** |
| 11s | **15.5** |
| 12s | **17.0** |
| 13s | **18.5** |
| 14s | **20.0** |
| 15s | **21.0** |
Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.
## 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": "kling-video/o3/pro/reference-to-video",
"input_params": {
"prompt": "She looks up from her laptop and smiles at the camera.",
"image_urls": [
"https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
]
}
}'
```
```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": "kling-video/o3/pro/reference-to-video",
"input_params": {
"prompt": "She looks up from her laptop and smiles at the camera.",
"image_urls": [
"https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
]
},
},
)
print(response.json()["id"])
```
## Input parameters
Send these fields in `input_params`.
Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.
Maximum characters: `2500`.
Video duration in seconds (3-15s).
Allowed values: `"3"`, `"4"`, `"5"`, `"6"`, `"7"`, `"8"`, `"9"`, `"10"`, `"11"`, `"12"`, `"13"`, `"14"`, `"15"`.
Elements (characters/objects) to include in the video. Reference in prompt as @Element1, @Element2, etc. Maximum 7 total (elements + reference images + start image).
Additional reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images + start image).
Maximum items: `4`.
Image to use as the last frame of the video
Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase.
Start Image Url
The aspect ratio of the generated video frame.
Allowed values: `"16:9"`, `"9:16"`, `"1:1"`.
```json theme={null}
{
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"title": "Prompt",
"maxLength": 2500,
"description": "Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.",
"x-ui-tooltips": "Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.",
"x-support-types": [
"mentions"
]
},
"duration": {
"enum": [
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12",
"13",
"14",
"15"
],
"type": "string",
"title": "Duration",
"default": "5",
"description": "Video duration in seconds (3-15s)."
},
"elements": {
"type": "array",
"title": "Elements",
"description": "Elements (characters/objects) to include in the video. Reference in prompt as @Element1, @Element2, etc. Maximum 7 total (elements + reference images + start image).",
"x-advance-settings": true,
"x-mention-prefix": "element",
"x-is-hidden": true,
"min_width": 300,
"min_height": 300,
"max_file_size": 10485760,
"min_aspect_ratio": 0.4,
"max_aspect_ratio": 2.5
},
"image_urls": {
"type": "array",
"items": {
"type": "string",
"limit_description": "Max file size: 10.0MB, Min width: 300px, Min height: 300px, Min aspect ratio: 0.40, Max aspect ratio: 2.50, Timeout: 20.0s"
},
"title": "Image Urls",
"timeout": 20,
"maxItems": 4,
"min_width": 300,
"min_height": 300,
"description": "Additional reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images + start image).",
"max_file_size": 10485760,
"max_aspect_ratio": 2.5,
"min_aspect_ratio": 0.4
},
"end_image_url": {
"type": "string",
"title": "End Image Url",
"timeout": 20,
"min_width": 300,
"x-ui-name": "end_image",
"min_height": 300,
"description": "Image to use as the last frame of the video",
"max_file_size": 10485760,
"max_aspect_ratio": 2.5,
"min_aspect_ratio": 0.4
},
"generate_audio": {
"type": "boolean",
"title": "Generate Audio",
"default": true,
"description": "Whether to generate native audio for the video. Supports Chinese and English voice output. Other languages are automatically translated to English. For English speech, use lowercase letters; for acronyms or proper nouns, use uppercase.",
"x-advance-settings": true
},
"start_image_url": {
"type": "string",
"title": "Image Url",
"timeout": 20,
"min_width": 300,
"x-ui-name": "start_image",
"min_height": 300,
"description": "Start Image Url",
"max_file_size": 10485760,
"max_aspect_ratio": 2.5,
"min_aspect_ratio": 0.4
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"title": "Aspect Ratio",
"default": "16:9",
"description": "The aspect ratio of the generated video frame.",
"tooltips": "Aspect ratio won’t apply if a start image exists."
}
}
}
```
## 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.