兔子API
provider
Black Forest Labs
直接答案专注于高质量图像生成与编辑，覆盖实时预览、生产工作流和精细控制。
更新 · 审核信息
先区分 BFL 原生任务与本站图像接口
Black Forest Labs 是 FLUX 图像模型原厂。直连 BFL 是异步任务协议，认证头为 x-key；本站 /v1/images/generations 是已适配的网关入口，使用本站 Bearer 令牌，不应把 BFL 的 /v1/flux-* 或 get_result 冒充本站路径。精确模型、编辑能力、尺寸与参考图数量按单模型页确认。
必须保存服务端返回的 polling_url
提交成功会返回任务 id 和 polling_url。使用全球 api.bfl.ai 或多集群区域端点时，必须直接轮询响应里的 polling_url，不能按旧区域或固定主机自行拼接。Pending 表示继续等待；Ready 后读取 result.sample；Request Moderated、Content Moderated、Task not found 和 Error 需要分别处理。轮询要有退避、总超时和取消。
结果 URL 只有 10 分钟且无 CORS
官方交付地址 delivery.*.bfl.ai 的签名 URL 约 10 分钟后失效，也不启用浏览器跨域访问。服务端应在 Ready 后立即以流式下载转存到受控对象存储或 CDN，再返回自己的持久 URL；不要把临时地址写进数据库当永久资产，也不要让浏览器直接依赖它。
402 与 429 不能用同一种重试
402 Payment Required 表示 credits 不足或付款方式问题，自动重试不会恢复；429 Too Many Requests 表示速率或活跃任务上限，应等待已有任务结束并降低并发。400/422 修正参数，403 检查 key 权限，临时 500/503 才使用带抖动的有限指数退避。重复提交可能重复计费，应保存业务幂等记录。
许可取决于精确产品
BFL 托管 API 受 API 服务条款和使用政策约束；可下载权重还使用各自许可证。部分开放权重采用 Apache 2.0，另一些是非商业许可或需要单独商业授权，例如 Kontext [dev] 的商业使用需另行许可。上线前记录具体模型、权重来源、许可证版本、输入素材权利与内容审核要求。
已核验厂商目录
按能力类型查看最新模型
这里展示厂商官方目录中的具体型号，不代表本站一定已开放；可调用 ID、端点和价格请以模型广场为准。
图像生成与编辑
-
flux-2-pro-preview预览FLUX.2 的专业预览型号，面向最高质量图像生成和编辑。
-
flux-2-max稳定FLUX.2 系列的高质量生成型号。
-
flux-2-flex稳定可调节质量、速度和成本的 FLUX.2 灵活型号。
适用场景
- 图像生成与编辑
- 高质量生产输出
- 排版和细节控制
API 协议
/v1/images/generations
FAQ
BFL API Key 应放在 Bearer 头吗？
不是。直连 FLUX API 使用 x-key: <BFL_API_KEY>；通过本站 /v1/images/generations 则使用本站 Bearer 令牌，两类密钥不能混用。
创建 FLUX 任务后应该拼接哪个查询 URL？
不要自行拼接。保存响应中的 id 和 polling_url，并直接请求返回的 polling_url；全球与多集群区域端点明确要求这样做。
为什么浏览器不能长期显示 BFL 结果图？
result.sample 是仅约 10 分钟有效的签名地址，并且交付地址不启用 CORS。服务端应立即下载到自己的对象存储或 CDN，再向用户提供。
BFL 的 402 和 429 分别表示什么？
402 表示余额或付款方式问题，补充 credits 后再提交；429 表示活跃任务或速率限制，应降低并发并等待已有任务完成。
FLUX 开放权重都能直接商用吗？
不能一概而论。API 服务条款与开放权重许可证是不同层面；不同 FLUX 版本可能使用 Apache 2.0、非商业许可或需另购商业许可，必须核对精确型号。
关联指南
官方来源
- BFL Image Generation Quickstart Official
- FLUX API Integration Guide Official
- FLUX API Errors Official
- BFL API Pricing Official
- FLUX Kontext Licensing Overview Official