跳转到主要内容
POST
/
v3
/
async
/
kling-v3.0-motion-control
Kling V3.0 动作控制
curl --request POST \
  --url https://api.ppio.com/v3/async/kling-v3.0-motion-control \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "video": "<string>",
  "prompt": "<string>",
  "model_name": "<string>",
  "negative_prompt": "<string>",
  "keep_original_sound": true,
  "character_orientation": "<string>"
}
'
{
  "task_id": "<string>"
}
Kling V3.0 动作控制工具可从参考视频提取运动轨迹，并将其应用到参考图像生成视频，同时保持主体一致性。支持标准与专业模式，按秒计费。
这是一个异步API，只会返回异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 来检索视频生成结果。

​
请求头

​
Content-Type
string
必填
枚举值: application/json
​
Authorization
string
必填
Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

​
请求体

​
image
string
必填
参考图像 URL 或 base64 编码图像；支持 .jpg、.jpeg、.png。 图片文件大小不得超过 10MB；宽高均需 >= 300px；宽高比需在 1:2.5 与 2.5:1 之间。
​
video
string
必填
参考运动视频 URL；支持 .mp4、.mov。 视频文件大小不得超过 10MB；宽高均需 >= 300px；时长 3-30 秒。
​
prompt
string
场景描述、风格、光线等正向提示词；长度不超过 2500 字符。长度限制：0 - 2500
​
model_name
string
默认值:"kling-v3-0-std"
必填
模型名称。kling-v3-0-std：标准模式，性价比高；kling-v3-0-pro：专业模式，视频质量更佳。可选值：kling-v3-0-std, kling-v3-0-pro
​
negative_prompt
string
反向提示词，描述需要在生成视频中避免的元素；长度不超过 2500 字符。长度限制：0 - 2500
​
keep_original_sound
boolean
默认值:true
是否保留参考视频的原始音频。
​
character_orientation
string
必填
输出帧模式：
  • image：以参考图像的人物姿态和构图为主，将动作迁移到图像人物上（输出 5 秒）
  • video：以参考视频的人物姿态和构图为主，将视频中的动作应用到图像人物上（输出时长与参考视频一致，最长 30 秒）
可选值：image, video

​
响应

​
task_id
string
必填
异步任务的 task_id。您应该使用该 task_id 请求 查询任务结果 API 以获取生成结果