kling/kling-3.0-turbo 的 API 参考,由 Comfy Router 从 Kling 提供。
快速开始
在你的 Comfy 工作区中创建密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段是通过原始 HTTP 执行的同一调用。
模型 ID: kling/kling-3.0-turbo
端点: POST https://api.comfy.org/v2/models/kling/kling-3.0-turbo
- Wait for the result
- Queue and collect later
结构
输入
object
常规配置,例如回调地址和水印选项。
string
任务结果回调通知 URL。当任务状态发生变化时,服务器会发送通知。
string
自定义任务 ID。不会覆盖系统生成的任务 ID,但可用于查询。在单个用户账号内必须唯一。
object
是否同时生成带水印的结果。不支持自定义水印。
boolean
true 表示生成带水印的结果,false 表示不生成。默认 false。
string
必填
提示词,可同时包含正面和负面描述。推荐长度不超过 2500 个字符。多镜头视频使用格式 “shot n, m, words; shot n, m, words;”。
object
输出配置,例如分辨率、宽高比和时长。
string
已生成画面的宽高比(width:height)。取值为 “16:9”、“9:16” 或 “1:1” 之一。默认 “16:9”。Possible values:
16:9, 9:16, 1:1integer
视频长度,以秒为单位。支持的取值为 3 到 15。默认 5。Range:
3 to 15string
已生成视频的清晰度。取值为 “720p” 或 “1080p” 之一。默认 “720p”。Possible values:
720p, 1080pGET /v2/models/kling/kling-3.0-turbo/openapi.json 提供的 schema 生成,与它在请求到达提供商之前用于校验调用的文档相同。
输出
integer
错误码。0 表示成功。
object[]
匹配该查询的任务。
object[]
任务的计费详情。
string
消耗金额,精确到小数点后两位。
string
消耗账户类型。“cash” 表示余额,“unit” 表示资源包。
string
可消耗资源包类型(仅在 charge_type 为 “unit” 时存在)。取值为 “video”、“image” 或 “audio” 之一。
integer
任务创建时间。Unix 时间戳,以毫秒为单位。Format:
int64string
此任务的自定义任务 ID(如果有)。
string
任务 ID。
string
任务状态信息,任务失败时显示失败原因。
object[]
任务已生成的输出。
string
已生成视频的时长,以秒为单位。
string
分组标记,仅对已分组的图像存在。
string
由系统生成的输出 ID。
string
已生成 MP3 音频的时长,以秒为单位。
string
已生成音频的 MP3 URL(防盗链保护)。
string
已生成素材的名称。
string
素材来源。“kling” 表示官方库;数字为创作者 ID。
string
素材状态。取值为 “succeeded” 或 “deleted” 之一。
string
输出内容类型。取值为 “video”、“image”、“audio”、“voice” 或 “element” 之一。
string
已生成结果的 URL(防盗链保护)。30 天后清除。
string
带水印结果的 URL(防盗链保护)。
string
已生成 WAV 音频的时长,以秒为单位。
string
已生成音频的 WAV URL(防盗链保护)。
string
任务状态。取值为 “submitted”、“processing”、“succeeded” 或 “failed” 之一。
integer
任务更新时间。Unix 时间戳,以毫秒为单位。Format:
int64string
报错信息。
string
由系统生成的请求 ID。
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。