Kling 3.0

使用 Kling 3.0 AI 模型生成具有高级多镜头功能和元素引用的高质量视频。

概述

Kling 3.0 是一个先进的视频生成模型，支持单镜头和多镜头视频创作，并支持元素引用功能。它提供两种生成模式（标准版和专业版）以及不同的分辨率选项，并支持音效以增强视频输出。

主要特性

多种生成模式：可在 std（标准分辨率）、pro（更高分辨率）和 4K（超高分辨率）模式之间选择

多镜头支持：创建包含多个镜头的视频，每个镜头都有自己的提示词和时长

元素引用：使用 @element_name 语法在提示词中引用图像

音效：可选的音效以增强视频输出

灵活的宽高比：支持 16:9、9:16 和 1:1 宽高比

可配置时长：视频时长从 3 到 15 秒

分辨率映射

分辨率取决于 mode 和 aspect_ratio 参数：

标准模式 (std)

专业模式 (pro)

4K模式 (4K)

宽高比	分辨率
16:9	1280×720
9:16	720×1280
1:1	720×720

4K模式提供更高分辨率的输出，但可能需要更长的生成时间并消耗更多积分。

单镜头与多镜头模式

单镜头模式 (`multi_shots: false`)

使用主 prompt 字段进行视频生成

通过 image_urls 支持首帧和尾帧图像

音效为可选

多镜头模式 (`multi_shots: true`)

使用 multi_prompt 数组定义多个镜头

每个镜头有自己的提示词和时长（1-12 秒）

仅支持首帧图像（通过 image_urls[0]）

音效默认为启用

每个镜头最大字符数为500

元素引用

您可以使用 @element_name 语法在提示词中引用图像。在 kling_elements 数组中定义元素：

图像元素：2-4 个图像 URL（JPG/PNG，每个最大 10MB）

使用描述性的元素名称，并确保 kling_elements 中的元素名称与提示词中使用的名称匹配（不带 @ 符号）。
单个任务最多引用3个元素，且每个@element占37个字符。

文件上传要求

在使用元素引用之前，请上传您的图像：

1. 上传文件

使用文件上传 API 上传您的源图像。

文件上传 API

了解如何上传文件并获取文件 URL，请参阅文件上传 API 快速入门。

2. 获取文件 URL

上传后，您将收到可用于 element_input_urls 的文件 URL。

CAUTION

图像格式：JPG、PNG（每个文件最大 10MB，每个元素 2-4 个文件）

确保文件 URL 可访问且未过期

使用示例

带元素引用的单镜头视频

{
  "model": "kling/v3-video",
  "input": {
    "prompt": "In a bright rehearsal room, sunlight streams through the window@element_dog",
    "image_urls": [
      "https://static.aiquickdraw.com/tools/example/1764851002741_i0lEiI8I.png"
    ],
    "sound": true,
    "duration": 5,
    "aspect_ratio": "16:9",
    "mode": "pro",
    "multi_shots": false,
    "kling_elements": [
      {
        "name": "element_dog",
        "description": "dog",
        "element_input_urls": [
          "https://tempfileb.aiquickdraw.com/emixai/market/1770361808044_4RfUUJrI.jpeg",
          "https://tempfileb.aiquickdraw.com/emixai/market/1770361848336_ABQqRHBi.png"
        ]
      }
    ]
  }
}

多镜头视频

{
  "model": "kling/v3-video",
  "input": {
    "multi_shots": true,
    "image_urls": [
      "https://static.aiquickdraw.com/tools/example/1764851002741_i0lEiI8I.png"
    ],
    "duration": 5,
    "aspect_ratio": "16:9",
    "mode": "pro",
    "multi_prompt": [
      {
        "prompt": "a happy dog in running @element_cat",
        "duration": 3
      },
      {
        "prompt": "a happy dog play with a cat @element_dog",
        "duration": 3
      }
    ],
    "kling_elements": [
      {
        "name": "element_cat",
        "description": "cat",
        "element_input_urls": [
          "https://your-cdn.com/element_image.jpg",
          "https://your-cdn.com/element_image2.jpg"
        ]
      },
      {
        "name": "element_dog",
        "description": "dog",
        "element_input_urls": [
          "https://tempfileb.aiquickdraw.com/emixai/market/1770361808044_4RfUUJrI.jpeg",
          "https://tempfileb.aiquickdraw.com/emixai/market/1770361808044_4RfUUJrI.jpeg"
        ]
      }
    ]
  }
}

查询任务状态

提交任务后，使用统一查询端点检查进度并检索结果：

获取任务详情

了解如何查询任务状态和检索生成结果，请参阅获取任务详情。

对于生产环境使用，我们建议使用 callBackUrl 参数在生成完成时接收自动通知，而不是轮询状态端点。

最佳实践

提示词编写：在提示词中具体且详细。包括关于运动、相机角度和场景构图的细节

元素使用：使用高质量的参考图像/视频以获得更好的效果。确保元素与视频的风格和主题匹配

时长规划：对于多镜头视频，规划镜头时长以匹配总视频时长

模式选择：当质量重要时使用 4K 模式进行最终输出，在需要快速迭代时使用 std 模式

音效：为更具沉浸感的视频启用音效，特别是动作或动态场景

概述

主要特性

分辨率映射

单镜头与多镜头模式

单镜头模式 (`multi_shots: false`)

多镜头模式 (`multi_shots: true`)

元素引用

文件上传要求

1. 上传文件

2. 获取文件 URL

使用示例

带元素引用的单镜头视频

多镜头视频

查询任务状态

最佳实践

相关资源

Request

Responses

Kling 3.0

概述#

主要特性#

分辨率映射#

单镜头与多镜头模式#

单镜头模式 (multi_shots: false)#

多镜头模式 (multi_shots: true)#

元素引用#

文件上传要求#

1. 上传文件#

2. 获取文件 URL#

使用示例#

带元素引用的单镜头视频#

多镜头视频#

查询任务状态#

最佳实践#

相关资源#

Request

Responses

概述

主要特性

分辨率映射

单镜头与多镜头模式

单镜头模式 (`multi_shots: false`)

多镜头模式 (`multi_shots: true`)

元素引用

文件上传要求

1. 上传文件

2. 获取文件 URL

使用示例

带元素引用的单镜头视频

多镜头视频

查询任务状态

最佳实践

相关资源