kling-video-o3-pro/reference-to-video

POST

/openapi/v2/kling-video-o3-pro/reference-to-video

Kling Video O3 Pro Reference-to-Video is a premium engine engineered for unmatched identity consistency across cinematic frames. By extracting features from up to 7 reference images, it ensures that characters, props, and scenes remain perfectly recognizable throughout complex sequences. As the highest fidelity model in the Kling family, it supports video-guided motion for precise action transfer while offering flexible audio options, including original sound retention or AI-generated effects. It provides a robust, professional-grade solution for transforming static references into production-ready narratives with absolute visual integrity.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "In a cyberpunk alleyway under heavy rain, the wandering samurai from the [Ref Images] draws his katana and performs a 360-degree spin following the motion from the [Ref Video]. Raindrops collide with the uniquely engraved mechanical left arm, creating realistic splashes. Lighting reflects dynamically across the metallic surfaces as he rotates. Maintain strict identity consistency for both the facial features and the intricate mechanical arm structure throughout the 15-second sequence.",
    "videoUrl": "https://www.runninghub.cn/view?filename=bad1af13062e02e5fbd35b221cfa13f169dfee794c3f709dcbd1a1070a488676.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM5MTQ4MjUwOTksInRzIjoxNzczMzEwMDI1MDk5LCJzaWduIjoiMWNkNzc2ZjE1YTkwYTMxYWU4MDc1NTNiZWQ0YWY1YzQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7107717807826933",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=c07e37eb45b827c8b0b6b2c7428ef202b9ab70613845ddf66b4a9921b40ba250.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzEwNjgxNzU3NTcsInRzIjoxNzcwNDYzMzc1NzU3LCJzaWduIjoiYmU0OTljOGVkZDA3YmFkODc1ZGY4Nzc3NDIwMzhlNTUifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.9645205288406946"
    ],
    "keepOriginalSound": true,
    "sound": false,
    "aspectRatio": "16:9",
    "duration": 5,
    "multiShot": false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/openapi/v2/kling-video-o3-pro/reference-to-video' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "In a cyberpunk alleyway under heavy rain, the wandering samurai from the [Ref Images] draws his katana and performs a 360-degree spin following the motion from the [Ref Video]. Raindrops collide with the uniquely engraved mechanical left arm, creating realistic splashes. Lighting reflects dynamically across the metallic surfaces as he rotates. Maintain strict identity consistency for both the facial features and the intricate mechanical arm structure throughout the 15-second sequence.",
    "videoUrl": "https://www.runninghub.cn/view?filename=bad1af13062e02e5fbd35b221cfa13f169dfee794c3f709dcbd1a1070a488676.mp4&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzM5MTQ4MjUwOTksInRzIjoxNzczMzEwMDI1MDk5LCJzaWduIjoiMWNkNzc2ZjE1YTkwYTMxYWU4MDc1NTNiZWQ0YWY1YzQifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7107717807826933",
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=c07e37eb45b827c8b0b6b2c7428ef202b9ab70613845ddf66b4a9921b40ba250.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NzEwNjgxNzU3NTcsInRzIjoxNzcwNDYzMzc1NzU3LCJzaWduIjoiYmU0OTljOGVkZDA3YmFkODc1ZGY4Nzc3NDIwMzhlNTUifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.9645205288406946"
    ],
    "keepOriginalSound": true,
    "sound": false,
    "aspectRatio": "16:9",
    "duration": 5,
    "multiShot": false
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

Modified at 2026-03-24 12:00:02

kling-v3.0-pro-image-to-video

kling-video-o1/image-to-video