Skip to main content
kling/kling-image-o1 的 API 参考,该模型来自 Kling,由 Comfy Router 提供服务。

快速开始

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

数据结构

输入

string
默认值:"\"auto\""
生成图像的宽高比(宽度:高度)。auto 表示根据传入内容智能生成图像。可选值:16:99:161:14:33:43:22:321:9auto
string (uri)
此任务结果的回调通知地址。若已配置,任务状态发生变化时服务器会主动通知。格式:uri
object[]
基于元素 ID 配置的参考元素列表。参考元素与参考图像的数量之和不得超过 10。
integer
必填
元素 ID格式:int64
string
自定义任务 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]。范围:19
string
必填
文本提示词,可包含正面和负面描述。不得超过 2,500 个字符。Omni 模型可以通过带有元素和图像的 Prompt 实现多种能力。使用 <<<>>> 格式指定图像,例如 <<<image_1>>>。
string
默认值:"\"1k\""
图像生成分辨率。1k 为 1K 标准,2k 为 2K 高清,4k 为 4K 高清。可选值:1k2k4k
string
默认值:"\"single\""
控制生成单张图像还是组图。可选值:singleseries
integer
默认值:"4"
组图中图像的数量。取值范围 [2,9]。范围:29
由 Router 在 GET /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)
已生成图像的网址格式:uri
string
结果是单张图像还是组图可选值:singleseries
object[]
组图结果列表
integer
组图序号
string (uri)
已生成图像的网址格式:uri
string
任务状态可选值:submittedprocessingsucceedfailed
string
任务状态信息,任务失败时显示失败原因(例如触发平台的内容风控等)
integer
任务更新时间,Unix 时间戳(毫秒)
string
报错信息
string
请求 ID

示例

输入

输出

发布前须知

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

请求头

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

使用 Router API

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

限制

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