kling/kling-image-o1 的 API 参考,该模型来自 Kling,由 Comfy Router 提供服务。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发起的相同调用。
模型 ID: kling/kling-image-o1
端点: POST https://api.comfy.org/v2/models/kling/kling-image-o1
- Wait for the result
- Queue and collect later
数据结构
输入
string
默认值:"\"auto\""
生成图像的宽高比(宽度:高度)。auto 表示根据传入内容智能生成图像。可选值:
16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9、autostring (uri)
此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。格式:
uriobject[]
基于元素 ID 配置的参考元素列表。参考元素与参考图像的数量之和不得超过 10。
integer
必填
元素 ID格式:
int64string
自定义任务 ID。在单个用户账户内必须唯一。
object[]
参考图像列表。支持传入图像 Base64 编码或图像网址(确保可访问)。支持的格式包括 .jpg/.jpeg/.png。文件大小不能超过 10MB。宽度和高度尺寸不得小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间。参考元素与参考图像的数量之和不得超过 10。
string
必填
图像 Base64 编码或图像网址(确保可访问)
string
模型名。使用 Comfy Router 时可省略或传 null;模型由请求路径选择。如果提供了名称,则必须与该路径匹配。
integer
默认值:"1"
生成图像的数量。取值范围 [1,9]。范围:
1 至 9string
必填
文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。Omni 模型可以通过带有元素和图像的 Prompt 实现多种能力。使用 <<<>>> 格式指定图像,例如 <<<image_1>>>。
string
默认值:"\"1k\""
图像生成分辨率。1k 为 1K 标准,2k 为 2K 高清,4k 为 4K 高清。可选值:
1k、2k、4kstring
默认值:"\"single\""
控制生成单张图像还是组图。可选值:
single、seriesinteger
默认值:"4"
组图中图像的数量。取值范围 [2,9]。范围:
2 至 9GET /v2/models/kling/kling-image-o1/openapi.json 提供的 Schema 生成,与请求到达提供商之前用于校验调用的文档为同一份。
输出
integer
错误码
object
integer
任务创建时间,Unix 时间戳(毫秒)
string
任务的扣减单位
string
任务 ID
object
string
客户自定义任务 ID
object
object[]
integer
图像编号(0-9)
string (uri)
已生成图像的网址格式:
uristring
结果是单张图像还是组图可选值:
single、seriesobject[]
组图结果列表
integer
组图序号
string (uri)
已生成图像的网址格式:
uristring
任务状态可选值:
submitted、processing、succeed、failedstring
任务状态信息,任务失败时显示失败原因(例如触发平台的内容风控等)
integer
任务更新时间,Unix 时间戳(毫秒)
string
报错信息
string
请求 ID
示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入。生成的资源请及时下载,因为结果链接会过期。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、校验错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。