recraft/recraftv4_styles_pro 的 API 参考,由 Comfy Router 从 Recraft 提供。
快速开始
在你的 Comfy 工作区中创建一个密钥,并将其导出为COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdk、npm install @comfyorg/sdk);cURL 代码片段是通过原始 HTTP 进行的相同调用。
模型 ID: recraft/recraftv4_styles_pro
端点: POST https://api.comfy.org/v2/models/recraft/recraftv4_styles_pro
- Wait for the result
- Queue and collect later
Schema
输入
object
已生成图像的控制参数
integer
定义图像的艺术基调。在简单级别,人物以静态、干净的风格直视相机。动态与奇特级别则引入动感与创意。范围:
0 到 5object
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
要生成的图像数量。Recraft 接受 1-6。范围:
1 到 6string
必填
描述要生成图像的文本提示词
string
可选值:
url、b64_jsonstring
已生成图像的大小(例如 “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。GET /v2/models/recraft/recraftv4_styles_pro/openapi.json 提供的 schema 生成,该文档也是请求到达提供商之前用于校验调用的同一份文档。
输出
integer
必填
生成创建时的 Unix 时间戳
integer
必填
本次生成使用的积分数量
object[]
必填
已生成图像信息的数组
string
Base64 编码的图像数据(当请求设置了
response_format: b64_json 时出现,替代 url)string
已生成图像的唯一标识符
string
用于访问已生成图像的 URL(当
response_format 为 url(默认值)时出现)string
解析后的风格 id,当使用风格引用时由 Recraft 返回(尤其是要求必填的模型 recraftv4_styles*);可在后续请求中作为
style_id 复用。示例
输入
输出
发布前须知
SDK 会生成Idempotency-Key 并在自动重试中复用它。手动重试时,请复用原始 key。Router 最长可保持连接 10 分钟。
请求失败时,Router 会发送 X-Comfy-Error-Type 响应头说明原因。422 表示 Router 在调用提供商之前就拒绝了输入,413 表示请求体超出了 Router 可接受的大小。已生成的资源请及时下载,因为结果 URL 会过期。
上文任何字段描述中提到的尺寸限制,都是提供商对该字段自身的限定,引自提供商的规范。Router 会对整个请求体另行设置上限,base64 编码的媒体内容也计入其中:参见请求体大小。
请求头
身份验证、幂等性、请求 ID、错误分类、重试节奏、消费限额。
使用 Router API
模型发现、验证错误、重试与计费。
限制
Router 目前不支持的功能,以及替代方案。