Skip to main content
bfl/flux-2-pro 的 API 参考,由 Comfy Router 从 Black Forest Labs 提供。

快速开始

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

Schema

输入

integer
默认值:"1024"
图像的高度。范围:2562048
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
用于图生图的 Base64 编码图像。
string
默认值:"\"jpeg\""
已生成图像的输出格式。可选值:jpegpng
string
必填
要生成的图像的文本描述。
boolean
默认值:"true"
自动修改用于生成的提示词。
integer
默认值:"2"
审核阈值级别(仅 Flux 2 Max)。范围:05
integer
用于结果可复现的种子。
integer
默认值:"1024"
图像的宽度。范围:2562048
由 Router 在 GET /v2/models/bfl/flux-2-pro/openapi.json 提供的 schema 生成,也就是它在请求到达提供商之前用于校验调用的同一份文档。

输出

number
提供商报告的以积分计的成本,在任务就绪后填充。格式:float
string
必填
BFL 任务标识符。
number
BFL 报告的可选生成进度。范围:01格式:float
object
必填
已完成的生成结果。此处不可为空:该组件的 required 条目是对 200 会携带结果的承诺,而可空的 result 会把它降格为仅检查键是否存在。
number
提供商报告的本次生成成本。这是 BFL 的数字,不是 Comfy 的收费。格式:double
number
提供商报告的生成时长,单位为秒。格式:double
number
提供商报告的生成完成时间,为自 Unix 纪元起的秒数。使用 double 的原因与 start_time 相同。格式:double
string
生成实际运行的提示词,即经过任何提示词上采样之后的结果。
string (uri)
已生成资产的签名 URL。Router 会把该资产重新托管到 Comfy 存储上并改写此字段,因此它通常是 Comfy 托管的 URL,有效期最长 24 小时:签发时签 24 小时,并从一份 23 小时的备忘中重放,所以较晚的轮询可能返回一个只剩一小时的链接;如果某个叶子节点无法执行重新托管,则保留 BFL 自己的短时效分发 URL:视频大约两小时,图像大约十分钟。无论哪种情况链接都会过期,因此请下载资产,而不要保存 URL。格式:uri
integer
本次生成使用的种子,无论是由用户提供还是由提供商选定。声明为 int64 是因为 BFL 会返回超过 2^31 的种子(例如 2784347701),而未加格式修饰的 integer 在许多 SDK 生成器中会生成 32 位字段。格式:int64
number
提供商报告的生成开始时间,为自 Unix 纪元起的秒数。是 double 而不是 float:在当前日期的纪元值附近,float32 的间距约为 128 秒,这会把整个生成的跨度压缩成单个解码值。格式:double
string
必填
任务状态:待定、推理中、生成中、就绪、请求被审核、内容被审核、错误或未找到任务。

示例

输入

输出

发布前须知

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

请求头

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

使用 Router API

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

限制

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