> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling V3.0 动作控制

Kling V3.0 动作控制工具可从参考视频提取运动轨迹，并将其应用到参考图像生成视频，同时保持主体一致性。支持标准与专业模式，按秒计费。

<Tip>
  这是一个**异步**API，只会返回异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 来检索视频生成结果。
</Tip>

## 请求头

<ParamField header="Content-Type" type="string" required={true}>
  枚举值: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 请求体

<ParamField body="image" type="string" required={true}>
  参考图像 URL 或 base64 编码图像；支持 .jpg、.jpeg、.png。
  图片文件大小不得超过 10MB；宽高均需 >= 300px；宽高比需在 1:2.5 与 2.5:1 之间。
</ParamField>

<ParamField body="video" type="string" required={true}>
  参考运动视频 URL；支持 .mp4、.mov。
  视频文件大小不得超过 10MB；宽高均需 >= 300px；时长 3-30 秒。
</ParamField>

<ParamField body="prompt" type="string">
  场景描述、风格、光线等正向提示词；长度不超过 2500 字符。

  长度限制：0 - 2500
</ParamField>

<ParamField body="model_name" type="string" required={true} default="kling-v3-0-std">
  模型名称。kling-v3-0-std：标准模式，性价比高；kling-v3-0-pro：专业模式，视频质量更佳。

  可选值：`kling-v3-0-std`, `kling-v3-0-pro`
</ParamField>

<ParamField body="negative_prompt" type="string">
  反向提示词，描述需要在生成视频中避免的元素；长度不超过 2500 字符。

  长度限制：0 - 2500
</ParamField>

<ParamField body="keep_original_sound" type="boolean" default={true}>
  是否保留参考视频的原始音频。
</ParamField>

<ParamField body="character_orientation" type="string" required={true}>
  输出帧模式：

  * image：以参考图像的人物姿态和构图为主，将动作迁移到图像人物上（输出 5 秒）
  * video：以参考视频的人物姿态和构图为主，将视频中的动作应用到图像人物上（输出时长与参考视频一致，最长 30 秒）

  可选值：`image`, `video`
</ParamField>

## 响应

<ResponseField name="task_id" type="string" required={true}>
  异步任务的 task\_id。您应该使用该 task\_id 请求 [查询任务结果 API](/models/reference-get-async-task-result) 以获取生成结果
</ResponseField>