> ## 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 4K 文生视频

Kling v3.0 4K 文本转视频可根据文字提示生成原生 4K 超高清视频，具备电影级画质、流畅的运动效果、精准的提示词遵循能力，并支持可选的原生音频共同生成。支持 3-15 秒时长和多种画面比例。

<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="sound" type="boolean" default={false}>
  是否在生成视频时同时生成音频。支持中文和英文语音输出。
</ParamField>

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

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

<ParamField body="duration" type="integer" default={5}>
  生成视频的持续时间（秒）。支持 3 至 15 秒灵活时长。

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

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

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

<ParamField body="aspect_ratio" type="string" default="16:9">
  生成视频的宽高比。

  可选值：`16:9`, `9:16`, `1:1`
</ParamField>

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

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

## 响应

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