Skip to main content
recraft/recraftv4_1_utility 的 API 参考,由 Comfy Router 提供,模型来自 Recraft。

Quick start

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

Schema

输入

object
用于已生成图像的控制项
integer
定义图像的艺术基调。在简单级别下,人物以静态、简洁的风格直视相机。动态和古怪的级别会引入动感与创意。范围:05
object
RGB 颜色值
integer[]
必填
object[]
一个偏好颜色的数组
integer[]
必填
boolean
不嵌入文本版式
string
用于生成的模型(例如 “recraftv3”)。此字段不受枚举约束:代理会原样转发调用方发送的内容。Comfy 提供的拼写(即 Comfy Router 以 recraft/<model> 寻址的那一组)包括 recraftv2、recraftv3、recraftv4、recraftv4_pro、recraftv4_1、recraftv4_1_utility、recraftv4_1_pro、recraftv4_1_utility_pro、recraftv4_styles、recraftv4_styles_pro、recraftv4_1_vector、recraftv4_1_utility_vector、recraftv4_1_pro_vector、recraftv4_1_utility_pro_vector、recraftv4_styles_vector 和 recraftv4_styles_pro_vector。这里将它们逐一写出,而不是通过引用命名,是因为声明它们的 RecraftGenerationModel 组件没有被任何地方 $ref 引用,因此会从 GET /openapi 所提供的规范中被裁剪掉,所以指向它的指针在所提供的文档中会是悬空的。四种 recraftv4_styles* 拼写还额外要求 style_id,请参阅该字段。
integer
要生成的图像数量范围:16
string
必填
描述要生成图像的文本提示词
string
已生成图像的尺寸(例如 “1024x1024”)
string
要应用于已生成图像的风格(例如 “digital_illustration”)
string
要应用于已生成图像的风格 ID(例如 “123e4567-e89b-12d3-a456-426614174000”)。如果提供了 style_id,则不应提供 style。四种 recraftv4_styles* 模型将其标记为必填:Recraft 会拒绝那些不带 style_id 或风格引用的请求。可使用 POST /proxy/recraft/styles 生成一个,该端点由同一个代理在相同凭据下提供。此路由上没有任何机制强制这一配对:请求体会原样转发给 Recraft,因此不带该字段的 recraftv4_styles* 调用会到达合作伙伴并返回 4xx。
内容根据 Router 在 GET /v2/models/recraft/recraftv4_1_utility/openapi.json 所提供的架构生成,这也是请求到达提供商之前它所依据的同一份校验调用文档。

输出

integer
必填
生成创建时的 Unix 时间戳
integer
必填
本次生成所消耗的积分数
object[]
必填
已生成图像信息的数组
string
已生成图像的唯一标识符
string
访问已生成图像的 URL

示例

输入

输出

发布前须知

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

请求头

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

使用 Router API

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

限制

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