FLUX 3 Image：方框构图、局部编辑与 API 价格

FLUX 3 Image 适合做什么？

BFL 官网重点介绍方框构图、多图参考和连续局部编辑：先安排物体的位置，再修改某个细节。小红书标题里的“最强”“超越 GPT Image 2.5”不等于独立评测结论，本文按官方文档说明实际用法。

模型概览列出最多十张参考图、最高 4K 输出。产品摄影、海报排版、保留已确认构图的连续修改，都是值得尝试的场景。

先在官方 Playground 试用

1. 打开 BFL Playground，登录并选择 FLUX 3 Image，生成前查看费用。
2. 写清主体、镜头和光线，先做小尺寸草稿。
3. 修改时上传原图，明确只改哪个元素；需要精确安排位置时再加方框。
4. 对照原图检查文字、标签、阴影和边缘。保存满意的版本，再继续下一轮。

官方 API：提交、轮询、保存

在 BFL 控制台创建自己的密钥并充值，将 BFL_API_KEY设置到服务器环境变量。以下文生图请求提交一张草稿；本文未执行付费生图测试。

curl --fail-with-body https://api.bfl.ai/v1/flux-3-image \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
    "prompt": "A ceramic teal mug on a pale oak desk, soft morning light, editorial product photograph, no text.",
    "aspect_ratio": "4:3",
    "resolution": "1k",
    "grounding": false
  }'

读取返回的 polling_url，使用同一个 x-key请求这个地址。Pending、Reasoning、Generating表示继续等待；到 Ready或终止错误就停止，并设置总超时。成功后，在一小时内下载 result.sample。下载图片时不要附带 API 密钥。

示例的 grounding: false关闭搜索步骤，适合这个虚构场景。接口参数使用 images、aspect_ratio和 resolution；不要沿用旧接口的 seed、width、input_image，这些字段会被拒绝。422 错误会指出无效字段。

用方框安排构图

把下面的原创布局放进 prompt，画幅设为 aspect_ratio: "1:1"。bbox顺序是 [上, 左, 下, 右]，坐标范围 0–1000。方框 JSON 接在提示词后面，不是单独的请求参数。完整规则见官方方框教程。

A square stationery advertisement: a teal notebook <notebook_1>
on a cream background <background_1>, with the title <title_1> above it.
[
  {"id":"background_1","bbox":[0,0,1000,1000],"desc":"Plain cream background"},
  {"id":"title_1","bbox":[70,100,230,900],"desc":"Dark teal text reading \"MAKE SPACE\""},
  {"id":"notebook_1","bbox":[300,250,900,750],"desc":"Closed teal notebook, photographed from above"}
]

画幅比例要与布局保持一致，文字也要留足空间。方框决定位置和大小，不是硬裁切蒙版，物体可能略微超出边界。

局部编辑与多图参考

简单编辑时，在 images中放原图 URL 或 base64，提示词写：“只把笔记本封面改成珊瑚色，保留标题、桌面和拍摄角度。”组合参考图时明确分工，例如“图 1 提供房间，图 2 提供椅子”。图号对应数组顺序；auto画幅跟随第一张图，详见编辑文档。

结构化编辑用 from、src_bbox、tgt_bbox代替生成布局的 bbox。第一张源图是 ref_image_0；源框和目标框相同用于固定元素，目标框变化用于移动。不要把生成布局直接当编辑布局。BFL 说框外像素通常不变，但阴影、反射和附近光照仍可能改变。

BFL 直连 API 价格

以上是 10 月 4 日核对的官方 API 费率。以提交响应中的 cost和当前账单规则为准，其他提供方可能另行定价。按该费率，20 次 1K 请求是 $0.96；每轮编辑都会产生新请求。

Hermes 和 OpenClaw 当前怎么接？

自部署 Hermes：当前内置 fal 模型目录和图片工具没有 FLUX 3 条目。先用独立的服务器端 BFL 客户端完成提交、轮询、保存，再通过自定义工具或 skill 让智能体调用。先设费用上限并单独验证客户端，避免智能体连续提交。

较新的自部署 Hermes 支持实时发现 OpenRouter 图片模型。OpenRouter 图片目录已列出 black-forest-labs/flux-3-image。配置自己的、有余额的 OpenRouter 密钥后，在 hermes tools → Image Generation → OpenRouter 中选择这个 ID。文档对应的 ~/.hermes/config.yaml配置是：

image_gen:
  provider: openrouter
  model: black-forest-labs/flux-3-image
  openrouter:
    resolution: 1K

这是已核对的提供方配置加已上架的模型 ID，我们未通过 Hermes 执行 FLUX 3 生图。先确认安装版本有该提供方，再检查一次有限请求；不要直接假定编辑和框外保留都已正常工作。上面的 BFL 价格表不代表 OpenRouter 费用。

自部署 OpenClaw：通用 fal 适配器使用的旧参数与 FLUX 3 的生成接口、编辑接口存在差异，不能仅填新 ID 就认定兼容。本文提供的可靠文档路径是独立 BFL 客户端，不是聊天模型配置。

较新的 OpenClaw 上游也有OpenRouter 图片提供方。使用自己的 OPENROUTER_API_KEY后，下列图片配置可作为有限文生图测试的候选，尚不是已验证的 FLUX 3 集成。只有安装版本支持这些文档字段时，才合并到 openclaw.json：

{
  "agents": {
    "defaults": {
      "mediaModels": {
        "image": { "primary": "openrouter/black-forest-labs/flux-3-image" }
      }
    }
  }
}

托管的两种框架：Image 菜单可能显示提供方实时目录，但显示名称不代表生图、参考图上传和方框编辑都已适配。我们尚未完整验证 FLUX 3 托管预设。现在可先用 Playground 或自己的 API 客户端；现有托管流程请看图片生成指南。

资料核对日期：2026 年 10 月 4 日。来源是上文链接的 BFL 官方模型页、生成、编辑、方框、参数、价格文档及框架上游代码。示例按文档核对，未执行付费生成或独立画质对比。

常见问题

相关指南

• 智能体图片生成与编辑
• Hermes Agent 的 fal 接入
• OpenClaw 的 fal 接入
• English: FLUX 3 Image guide