使用 kling-3.0 模型生成视频

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

概述

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

主要特性

双生成模式：在 std（标准分辨率）和 pro（更高分辨率）模式之间选择

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

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

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

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

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

分辨率映射

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

标准模式 (std)

专业模式 (pro)

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

单镜头与多镜头模式

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

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

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

音效为可选

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

使用 multi_prompt 数组定义多个镜头

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

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

音效默认为启用

元素引用

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

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

视频元素：1 个视频 URL（MP4/MOV，最大 50MB）

文件上传要求

在使用元素引用之前，请上传您的图像或视频文件：

1. 上传文件

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

文件上传 API

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

2. 获取文件 URL

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

使用示例

带元素引用的单镜头视频

{
  "model": "kling-3.0",
  "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/kieai/market/1770361808044_4RfUUJrI.jpeg",
          "https://tempfileb.aiquickdraw.com/kieai/market/1770361848336_ABQqRHBi.png"
        ]
      }
    ]
  }
}

多镜头视频

{
  "model": "kling-3.0",
  "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_video_urls": [
          "https://your-cdn.com/element_video.mp4"
        ]
      },
      {
        "name": "element_dog",
        "description": "dog",
        "element_input_urls": [
          "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg"
        ]
      }
    ]
  }
}

查询任务状态

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

获取任务详情

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

最佳实践

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

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

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

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

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

相关资源

探索所有可用的模型

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://api.kie.ai/api/v1/jobs/createTask' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "model": "kling-3.0/video", "callBackUrl": "https://your-domain.com/api/callback", "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, "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_dog", "description": "dog", "element_input_urls": [ "https://tempfileb.aiquickdraw.com/kieai/market/1770361808044_4RfUUJrI.jpeg", "https://tempfileb.aiquickdraw.com/kieai/market/1770361848336_ABQqRHBi.png" ] }, { "name": "element_cat", "description": "cat", "element_input_video_urls": [ "https://your-cdn.com/element_video.mp4" ] } ] } }'

使用 kling-3.0 模型生成视频

概述

主要特性

分辨率映射

单镜头与多镜头模式

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

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

元素引用

文件上传要求

1. 上传文件

2. 获取文件 URL

使用示例

带元素引用的单镜头视频

多镜头视频

查询任务状态

最佳实践

相关资源

🏪 市场概览

⚙️ 通用 API

Request

Responses

使用 kling-3.0 模型生成视频

概述#

主要特性#

分辨率映射#

单镜头与多镜头模式#

单镜头模式 (multi_shots: false)#

多镜头模式 (multi_shots: true)#

元素引用#

文件上传要求#

1. 上传文件#

2. 获取文件 URL#

使用示例#

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

多镜头视频#

查询任务状态#

最佳实践#

相关资源#

🏪 市场概览#

⚙️ 通用 API#

Request

Responses

概述

主要特性

分辨率映射

单镜头与多镜头模式

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

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

元素引用

文件上传要求

1. 上传文件

2. 获取文件 URL

使用示例

带元素引用的单镜头视频

多镜头视频

查询任务状态

最佳实践

相关资源

🏪 市场概览

⚙️ 通用 API