> ## 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 Standard (reference-to-video) Video to Video API

> Motion transfer tool, applies reference motion trajectories to new scenes.

[← Kling](https://docs.creatify.ai/api-documentation/ai-generation/models/kling.md)

**Model name:** `kling-video/o3/standard/video-to-video/reference`\
**Generation type:** `video_to_video`\
**Endpoint:** [`POST /api/asset_generator/`](https://docs.creatify.ai/api-reference/ai-generation/post-ai-generation)

## Pricing

| Duration | Credits |
| - | - |
| 3s | **4.0** |
| 4s | **5.5** |
| 5s | **6.5** |
| 6s | **8.0** |
| 7s | **9.0** |
| 8s | **10.5** |
| 9s | **11.5** |
| 10s | **13.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/standard/video-to-video/reference",
    "input_params": {
      "prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
      "video_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4",
      "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/standard/video-to-video/reference",
        "input_params": {
            "prompt": "The woman from the reference image talks to the camera in a bright café, with the gestures of the reference video.",
            "video_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/asset-generator/sample-video.mp4",
            "image_urls": [
                "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
            ]
        },
    },
)
print(response.json()["id"])
```

## Input parameters

Send these fields in `input_params`.

**prompt** `string` *required*

Take @Element1, @Element2 to reference elements and @Image1, @Image2 to reference images in order.

Maximum characters: `2500`.

**video\_url** `string` *required*

Reference video URL. Only .mp4/.mov formats supported, 3-10 seconds duration, 720-2160px resolution, aspect ratio between 1:2 and 2:1, max 200MB.

**duration** `string` (default: 5)

Video duration in seconds (3-10s).

Allowed values: `"3"`, `"4"`, `"5"`, `"6"`, `"7"`, `"8"`, `"9"`, `"10"`.

**elements** `array`

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

Maximum items: `3`.

**image\_urls** `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`.

**keep\_audio** `boolean` (default: false)

Whether to keep the original audio from the video.

**aspect\_ratio** `string` (default: auto)

The aspect ratio of the generated video frame.

Allowed values: `"auto"`, `"16:9"`, `"9:16"`, `"1:1"`.

> [accordion] Complete JSON schema
>
> ```json theme={null}
> {
>   "$schema": "http://json-schema.org/draft-07/schema#",
>   "required": [
>     "prompt",
>     "video_url"
>   ],
>   "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"
>       ],
>       "type": "string",
>       "title": "Duration",
>       "default": "5",
>       "description": "Video duration in seconds (3-10s)."
>     },
>     "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,
>       "maxItems": 3,
>       "min_width": 300,
>       "min_height": 300,
>       "max_file_size": 10485760,
>       "min_aspect_ratio": 0.4,
>       "max_aspect_ratio": 2.5
>     },
>     "video_url": {
>       "type": "string",
>       "title": "Video Url",
>       "max_width": 2160,
>       "min_width": 720,
>       "max_height": 2160,
>       "min_height": 720,
>       "description": "Reference video URL. Only .mp4/.mov formats supported, 3-10 seconds duration, 720-2160px resolution, aspect ratio between 1:2 and 2:1, max 200MB.",
>       "max_duration": 9.99,
>       "min_duration": 3,
>       "max_file_size": 209715200,
>       "max_aspect_ratio": 2.0,
>       "min_aspect_ratio": 0.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
>     },
>     "keep_audio": {
>       "type": "boolean",
>       "title": "Keep Audio",
>       "default": false,
>       "description": "Whether to keep the original audio from the video.",
>       "x-advance-settings": true
>     },
>     "aspect_ratio": {
>       "enum": [
>         "auto",
>         "16:9",
>         "9:16",
>         "1:1"
>       ],
>       "type": "string",
>       "title": "Aspect Ratio",
>       "default": "auto",
>       "description": "The aspect ratio of the generated video frame."
>     }
>   }
> }
> ```

## Response

The request returns the task with `status: "initializing"`. Poll [GET /api/asset\_generator/\{id}/](https://docs.creatify.ai/api-reference/ai-generation/get-ai-generation-.md) 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.