Skip to main content
Flux 1.1 Pro Ultra Image 的 API 参考。FLUX 1.1 [pro] 是 Black Forest Labs 推出的文生图模型。Ultra 模式可生成最高 4MP 分辨率的图像。

快速开始

你的 Comfy 工作区中创建密钥,并将其导出为 COMFY_API_KEY。Python 和 TypeScript 代码片段使用 Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk);cURL 代码片段则是通过原始 HTTP 发起同样的调用。 选择你要调用的模型。以下所有内容,从代码片段到 schema 和示例,都会随你的选择而变化。
模型 ID: bfl/flux-pro-1.1-ultra端点: POST https://api.comfy.org/v2/models/bfl/flux-pro-1.1-ultra

Schema

输入

string
默认值:"\"16:9\""
图像的比例,介于 21:9 和 9:21 之间,例如 16:9。
string
可选的 base64 编码图像,用于混合生成。
number
默认值:"0.1"
提示词与图像提示词之间的混合程度,从 0(仅使用提示词)到 1(仅使用图像提示词)。范围:01
string
默认值:"\"jpeg\""
输出图像格式。可选值:jpegpngwebp
string
必填
用于图像生成的文本提示词。
boolean
默认值:"false"
是否对提示词进行上采样。启用后,提示词会被自动修改,以进行更具创造性的生成。
boolean
默认值:"false"
生成处理更少、看起来更自然的图像。
integer
默认值:"2"
输入和输出审核的阈值,介于 0(最严格)和 6(最宽松)之间。范围:06
integer
可选种子,用于保证可复现性。省略时使用随机种子。
string
可选密钥,用于 Webhook 签名验证。
string (uri)
接收 Webhook 通知的 URL。格式:uri
根据 Router 在 GET /v2/models/bfl/flux-pro-1.1-ultra/openapi.json 提供的 schema 生成,Router 在请求到达提供商之前会依据同一份文档校验调用。

输出

number
提供商上报的积分成本,在任务进入 Ready 状态后填充。格式:float
string
必填
BFL 任务标识符。
number
BFL 上报的可选生成进度。范围:01格式:float
object
必填
已完成的生成结果。此处不可为空:该组件的 required 条目意味着 200 响应一定携带结果,而可空的 result 会将其降级为仅检查键是否存在。
number
提供商上报的本次生成成本。这是 BFL 的数值,不是 Comfy 的收费。格式:double
number
提供商上报的生成时长,单位为秒。格式:double
number
提供商上报的生成完成时间,单位为自 Unix 纪元起的秒数。与 start_time 出于相同原因使用 double格式: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
必填
任务状态:Pending、Reasoning、Generating、Ready、Request Moderated、Content Moderated、Error 或 Task not found。

示例

输入

输出

该 URL 是临时的。如果你需要保留图像,请及时下载。

发布前须知

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

请求头

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

使用 Router API

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

限制

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