> ## 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 Standard 图生视频

Kling v3.0 Standard 图像转视频工具可将静态图像转换为动态视频，在保持主体一致性的同时，生成自然运动与流畅的场景动态效果，支持音频同步生成和多段提示词组合。

<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}>
  视频首帧图片；支持 `.jpg`、`.jpeg`、`.png`。
  图片文件大小不得超过 10MB；宽高均需 >= 300px；宽高比需在 1:2.5 与 2.5:1 之间。
</ParamField>

<ParamField body="sound" type="boolean" default={false}>
  是否在生成视频时同时生成音频。
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  生成视频的正向提示词文本，描述场景运动、镜头移动、动作、声音风格、氛围和音效；不可超过 2500 个字符。
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  生成视频的持续时间（秒），范围 3-15。

  可选值：`3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`
</ParamField>

<ParamField body="cfg_scale" type="number" default={0.5}>
  控制视频生成的灵活性。数值越低运动越自然；数值越高，生成内容对提示词的贴合度越高。

  取值范围：\[0, 1]
</ParamField>

<ParamField body="end_image" type="string">
  尾帧图片 URL，用于引导起始帧与结束帧之间的过渡。格式约束与 image 相同。不可与 multi\_prompt 同时使用。
</ParamField>

<ParamField body="multi_prompt" type="array">
  多段提示词数组，用于多镜头视频组合。每项包含一个提示词和该段的时长。不可与 end\_image 同时使用。

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={true}>
      该视频段落的运动描述。
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      该段落的持续时间（秒），范围 3-15。

      取值范围：\[3, 15]
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="negative_prompt" type="string">
  反向提示词，指定要在画面和音频中避免的元素；长度不超过 2500 字符。
</ParamField>

## 响应

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