用途
本技能面向需要将 BFL FLUX API 集成到应用中的开发者,覆盖图像生成、编辑与处理场景。资料建议在搭建 BFL API 客户端、实现异步轮询、处理速率限制与错误、配置 Webhook、选择区域端点以及构建生产级集成时使用本指南。
前置检查与认证
使用前需确认环境变量 BFL_API_KEY 已设置,可用 echo $BFL_API_KEY 检查;若为空或出现 "Not authenticated" 错误,需创建 Key。获取方式为访问 https://dashboard.bfl.ai/get-started,点击 "Create Key" 并选择组织。建议将密钥写入 .env 并加入 .gitignore,避免提交密钥。请求通过 x-key: YOUR_API_KEY 头进行认证。
区域端点
- 全球:https://api.bfl.ai(默认,自动故障转移)
- 欧盟:https://api.eu.bfl.ai(GDPR 合规)
- 美国:https://api.us.bfl.ai(美国数据驻留)
主要能力与模型
FLUX.2 系列支持文生图与图生图编辑,所有 FLUX.2 模型均可通过 input_image 参数进行图像编辑,无需单独编辑端点。资料列出的模型包括 FLUX.2 [klein] 4B(实时、高吞吐)、FLUX.2 [klein] 9B(质量与速度平衡)、FLUX.2 [pro](生产环境、快速交付)、FLUX.2 [max](最高质量)、FLUX.2 [flex](排版、可调控制),以及本地开发用、非商业免费的 FLUX.2 [dev]。FLUX.1 系列包括 Kontext [pro]/[max](图像编辑)、FLUX1.1 [pro]、Ultra、Raw 及 Fill [pro](局部重绘)。
计费方面,1 积分等于 0.01 美元;FLUX.2 按百万像素计价,公式为 (firstMP + (outputMP-1) * mpPrice) + (inputMP * mpPrice),单位为美分。资料给出一组 1MP 文生图参考价:klein 4B 为 0.014 美元、klein 9B 为 0.015 美元、pro 为 0.03 美元、max 为 0.07 美元、flex 为 0.05 美元;图生图价格更高,具体以资料表格为准。FLUX.1 按张计价,如 Kontext [pro] 0.04 美元、Kontext [max] 0.08 美元等。
多参考图编辑
FLUX.2 支持多张输入图,用于元素组合、风格迁移与角色一致性。klein 最多 4 张,pro/max/flex 最多 8 张,参数为 input_image、input_image_2 至 input_image_8。提示词中可按编号引用图片,例如 "The subject from image 1 in the environment from image 2"。输入优先使用 URL,API 会自动抓取,也支持 base64。
使用方式
基本流程为三步:先向模型端点 POST 请求,响应返回 polling_url;再 GET 轮询该地址,直到 status 为 Ready 或 Error;状态为 Ready 后下载结果 URL 中的图片。资料给出完整 cURL 快速开始示例,并说明参考文档中提供 Python 与 TypeScript 客户端示例。并发限制方面,标准层(大多数端点)为 24 个并发请求。轮询适合脚本、CLI 工具、本地开发与简单集成;Webhook 适合生产应用、高流量与服务端到服务端场景。
限制与注意事项
结果 URL 仅十分钟有效,生成完成后应立即下载,不要存储或缓存 URL 本身。资料建议先采用轮询,需要扩展或事件驱动架构时再切换到 Webhook。提示词最佳实践与多参考图详细模式可参考 flux-best-practices 技能及相关规则文件。