Skip to main content
kling/kling-v2-1 的 API 参考,由 Comfy Router 从 Kling 提供。

快速开始

你的 Comfy 工作区中创建密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发出的同一调用。 模型 ID: kling/kling-v2-1 端点: POST https://api.comfy.org/v2/models/kling/kling-v2-1

数据结构

输入

string (uri)
回调通知地址。任务状态发生变化时,服务器将通过该地址进行通知。格式:uri
object
object
number
控制相机沿水平轴(x 轴)的移动。负值表示向左,正值表示向右。范围:-1010
number
控制相机在竖直平面内的旋转(x 轴)。负值表示向下旋转,正值表示向上旋转。范围:-1010
number
控制相机的翻滚数量(z 轴)。负值表示逆时针,正值表示顺时针。范围:-1010
number
控制相机在水平平面内的旋转(y 轴)。负值表示向左旋转,正值表示向右旋转。范围:-1010
number
控制相机沿竖直轴(y 轴)的移动。负值表示向下,正值表示向上。范围:-1010
number
控制相机焦距的变化。负值表示视野变窄,正值表示视野变宽。范围:-1010
string
预设的相机运动类型。simple:可自定义的相机运动。down_back:相机下降并向后移动。forward_up:相机向前移动并向上倾斜。right_turn_forward:向右旋转并向前移动。left_turn_forward:向左旋转并向前移动。可选值:simpledown_backforward_upright_turn_forwardleft_turn_forward
number
默认值:"0.5"
视频生成的灵活度。该值越高,模型的灵活度越低,与用户提示词的相关性越强。范围:01格式:float
string
默认值:"\"5\""
视频时长,单位为秒可选值:3456789101112131415
object[]
动态画笔配置列表(最多 6 组)。对于 5 秒的视频,轨迹长度不得超过 77 个坐标点。
string (uri)
动态画笔的应用区域(由用户使用运动画笔创建的遮罩图像)。宽高比必须与输入图像一致。格式:uri
object[]
integer
轨迹点的水平坐标。以图像左下角为原点 (0,0)。
integer
轨迹点的竖直坐标。以图像左下角为原点 (0,0)。
object[]
基于元素 ID 配置的参考元素列表。最多支持 3 个参考元素。element_list 与 voice_list 参数互斥。
integer
必填
元素 ID格式:int64
string
自定义任务 ID。在单个用户账户内必须唯一。
string
参考图像 - URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px,宽高比在 1:2.5 ~ 2.5:1 之间。Base64 不应包含 data:image 前缀。
string
参考图像 - 结束帧控制。URL 或 Base64 编码字符串,不能超过 10MB,分辨率不低于 300*300px。Base64 不应包含 data:image 前缀。不能与 dynamic_masks/static_mask 或 camera_control 同时使用。
string
默认值:"\"std\""
视频生成模式。std:标准模式,更具性价比。pro:专业模式,可生成时长更长、质量更高的视频。可选值:stdpro
string
模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径决定。若提供名称,则必须与请求路径一致。
object[]
每个分镜的信息,例如提示词和时长。最多支持 6 个分镜,最少 1 个。当 multi_shot 为 true 且 shot_type 为 customize 时必填。
string
该分镜的时长,单位为秒。不得超过任务总时长,且不得小于 1。所有分镜时长之和等于任务总时长。
integer
镜头序号
string
该分镜的提示词。最大长度为 512 个字符。
boolean
默认值:"false"
是否生成多镜头视频。为 true 时,prompt 参数无效。为 false 时,shot_type 和 multi_prompt 参数无效。
string
Negative text prompt。推荐直接在正向提示词中通过否定语句补充负面提示词信息。
string
Positive text prompt。使用 <<<voice_1>>> 指定与 voice_list 参数顺序相匹配的声音。一个任务最多可引用 2 个音色。指定音色时,sound 参数值必须为 on。
string
Storyboard method。当 multi_shot 参数设置为 true 时必填。Possible values: customize, intelligence
string
默认值:"\"off\""
Whether to generate sound simultaneously when generating videos。仅 V2.6 及后续版本的模型支持此参数。Possible values: on, off
string
Static Brush Application Area(用户使用运动画笔创建的遮罩图像)。宽高比必须与输入图像一致。
object[]
生成视频时引用的声音列表。最多支持 2 个声音。element_list 与 voice_list 参数互斥。
string
必填
通过声音自定义 API 返回的声音 ID,或系统预设的声音 ID。
object
Whether to generate watermarked results simultaneously。目前不支持自定义水印。
boolean
true means generate watermark, false means do not generate。
Generated from the schema Router serves at GET /v2/models/kling/kling-v2-1/openapi.json, the same document it validates a call against before the request reaches the provider。

输出

integer
错误码
object
integer
任务创建时间,Unix 时间戳(毫秒)
string
任务的扣减单元
string
任务 ID
object
string
object
object[]
string
视频总时长,单位为秒
string
已生成视频 ID
string (uri)
已生成视频的 URL格式:uri
string (uri)
带水印的已生成视频 URL,防盗链格式格式:uri
string
任务状态可能的值:submittedprocessingsucceedfailed
string
任务状态信息,任务失败时显示失败原因
integer
任务更新时间,Unix 时间戳(毫秒)
object
boolean
string
报错信息
string
请求 ID

示例

输入

输出

发布前须知

SDK 会生成 Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。 请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期

请求头

身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。

使用 Router API

模型发现、校验错误、重试与计费。

限制

Router 目前不支持的功能,以及替代方案。