Kling O3 Pro (reference-to-video) · Image to video

← Kling Model name: kling-video/o3/pro/reference-to-video
Generation type: image_to_video
Endpoint: POST /api/asset_generator/

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.

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"
      ]
    }
  }'

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.

string

required

Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.Maximum characters: 2500.

string

default:"5"

Video duration in seconds (3-15s).Allowed values: "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15".

array

Elements (characters/objects) to include in the video. Reference in prompt as @Element1, @Element2, etc. Maximum 7 total (elements + reference images + start image).

string[]

Additional reference images for style/appearance. Reference in prompt as @Image1, @Image2, etc. Maximum 7 total (elements + reference images + start image).Maximum items: 4.

string

Image to use as the last frame of the video

boolean

default:true

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.

string

Start Image Url

string

default:"16:9"

The aspect ratio of the generated video frame.Allowed values: "16:9", "9:16", "1:1".

Complete JSON schema

{
  "$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}/ 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.

Get Started

URL to Video

Aurora

Boreal

Stock AI Avatar

Custom Avatar

Custom Template

Asset Generator

Ad Clone

Text to Speech

IAB Images

HTML Interactive Ad

Link Parser

AI Ad Script

Stock AI Voice

Stock AI Music

Workspace

AI Shorts (Deprecated)

AI Editing (Deprecated)

Product Video (Deprecated)

Kling O3 Pro (reference-to-video) · Image to video

Pricing

Quick start

Input parameters

Response

​Pricing

​Quick start

​Input parameters

​Response

Pricing

Quick start

Input parameters

Response