> ## 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 V2.6 Pro 动作控制

Kling v2.6 Pro 动作控制工具可从参考视频提取运动轨迹,并将其应用到参考图像生成视频,同时保持主体一致性。

<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">
  场景描述、风格、光线等正向提示词。
</ParamField>

<ParamField body="negative_prompt" type="string">
  反向提示词；长度不超过 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>