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

POST

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

快手 O3 家族中针对“身份一致性”打造的顶级生成方案。该模型支持通过多达 7 张参考图（或 4 张图结合 1 段视频）深度提取角色、道具或场景的多视角特征，确保在复杂的动态叙事中主体形象始终稳定，彻底告别“掉脸”现象。借助 Pro 级的电影画质与运动真实感，模型不仅能通过参考视频进行精确的动作迁移与风格指引，还能灵活处理原声保留或 AI 音效合成。它是目前将特定 IP、定制角色或精密产品推向工业级视频创作的最强利器。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

{
    "prompt": "在暴雨中的赛博朋克小巷，[参考图] 中的流浪武士根据 [参考视频] 的动作轨迹，迅速拔出背后的长刀并完成一个华丽的转身。雨水击打在他那带有独特刻痕的机械左臂上，产生细腻的溅射效果。光影随着他的旋转在机械表面产生真实的反射偏移。全程保持武士的面部特征与机械臂的复杂结构高度一致。",
    "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
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/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": "在暴雨中的赛博朋克小巷，[参考图] 中的流浪武士根据 [参考视频] 的动作轨迹，迅速拔出背后的长刀并完成一个华丽的转身。雨水击打在他那带有独特刻痕的机械左臂上，产生细腻的溅射效果。光影随着他的旋转在机械表面产生真实的反射偏移。全程保持武士的面部特征与机械臂的复杂结构高度一致。",
    "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
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

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

修改于 2026-03-30 02:15:59

kling-elements

kling-video-o3-std/reference-to-video