FLUX 3 Image 允许你在图像提示中使用矩形，描述各个元素应放置的位置。同一套系统也支持编辑参考图：每个元素都可以有源位置、目标位置，以及需要更改内容的描述。Black Forest Labs 将图像端点加入其2026 年 10 月 1 日发布说明。
对设计师和创作者而言，关键区别在于：是规划完整构图，还是更改现有图像中的某个元素。本指南说明如何在两者间选择、如何将矩形转换为所需坐标，以及如何获取 API 结果。这是一份仅依据文档编写的指南，核查日期为 2026 年 10 月 3 日。BIG CHANGE 未使用该产品生成或编辑图像。
重大变化
- 发生了什么变化：BFL 在 10 月 1 日发布的说明记录了通过
v1/flux-3-image来进行构图和编辑。场景描述与 JSON 元素表格共用一个提示词，方框用于指定位置或编辑范围。BFL 发布说明 - 为何重要：创作者可以将计划中的矩形转换成坐标，再指定参考图中的哪些元素要保留、移动或替换。实际使用时要决定描述到什么程度：完整构图、简单指令，还是明确的编辑表格。BFL 方框教程
- 接下来关注什么：提交前先选择分辨率并核算预算：列出的
1k和4k价格分别为每张图像 0.048 美元和 0.607 美元。方框允许元素溢出，编辑也可能影响周围的光照、阴影或反射，因此应检查完整结果。BFL 定价，编辑限制
选择浏览器或 API 方式
BFL 的产品页面介绍了两种入口：在浏览器 Playground 中绘制方框，或通过 API 发送版式提示词。文档提供 Playground 链接，可无需编写代码直接使用。如果你想直接绘制区域，可走浏览器方式；如果需要在请求中提供坐标并以程序方式获取结果，则使用 API。我们未查看当前 Playground 控件，因此下文说明的是文档记载的请求格式，而非浏览器按钮的逐步操作。
使用 API 时，先创建 BFL 账户、添加额度，并从控制面板获取密钥。提交包含POST请求的 JSON 至https://api.bfl.ai/v1/flux-3-image，使用Content-Type: application/json以及在x-key请求头中传入密钥。仅prompt为必填项。BFL 生成指南、定价与设置
FLUX 3 Image 和 FLUX 3 Dev 必须区分开来：本说明针对 BFL 托管的 Image 端点。Image 产品页面提供通过销售团队申请的商业权重许可。本指南所查阅的资料不能证明 FLUX 3 Image 提供开放权重下载。FLUX 3 Image 访问方式
决定要明确描述图像的哪些部分
任务 | 文档记载的输入 | 使用的控制方式 |
|---|---|---|
生成新构图 | 场景提示词，可选附加元素表格 | |
更改可识别的细节 | 一条指令和一张参考图 | 精确的描述可能已经足够；检查展开后的提示词 |
精确选择要编辑的元素 | 一条指令、一张参考图和编辑表格 | 为每个要保留的元素提供源方框和保留行 |
组合多张参考图 | 说明各图用途的提示词，以及 2 至 10 张图像 | 标明每张图分别提供哪个主体、物体或场景 |
BFL 表示，简单编辑时系统可以在提示词扩展过程中自动获取方框。如需明确控制，请自行提供表格。在普通指令中，“image 1”指第一张参考图；在编辑表格中，同一张参考图则是ref_image_0。BFL 编辑指南
参考图放入images字段中，以 URL 或 base64 数据形式提供，可使用字符串或列表。提供参考图时，数量可为 1 至 10 张；每张尺寸需在 256 × 256 像素至 16 兆像素之间。默认aspect_ratio为auto：若提供参考图，则跟随第一张图的比例；若未提供，则生成正方形图像。版式有特定形状要求时，请明确设置。BFL 端点概览
将矩形换算为方框坐标
每个方框均采用[top, left, bottom, right]格式，坐标为 0 至 1000 的整数。先写垂直坐标。两个坐标轴都独立覆盖整张图像，因此网格会按横向或纵向画布拉伸以适应图像。BFL 方框格式
要将像素位置换算为坐标，上边和下边分别除以图像高度，左边和右边分别除以图像宽度。将结果乘以 1000 并四舍五入。BFL 文档使用 1920 × 1080 画布进行换算：
边 | 像素位置 | 计算 | 网格值 |
|---|---|---|---|
上边 | 108 | 108 ÷ 1080 × 1000 | 100 |
左边 | 384 | 384 ÷ 1920 × 1000 | 200 |
下边 | 972 | 972 ÷ 1080 × 1000 | 900 |
右边 | 1536 | 1536 ÷ 1920 × 1000 | 800 |
因此，方框为[100, 200, 900, 800]。其垂直范围占画面高度的 10% 至 90%，水平范围占画面宽度的 20% 至 80%。这组计算说明，交换宽度和高度，或先输入左边再输入上边，都会改变预期区域。应保持设计版式时使用的宽高比。BFL 坐标换算
创作新图像
撰写完整构图的描述，并使用<id>标记给元素命名。附加一个 JSON 数组，针对每个元素列出id、bbox和desc。数组应作为prompt中的文本，而不是另一个顶层 API 字段。
BFL 文档中的奔跑剪影示例将背景铺满画布，并将人物放在中央方框内。下面这个精简请求沿用了该示例的版式；BIG CHANGE 未运行此请求：
{
"prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
"aspect_ratio": "1:1",
"resolution": "1k"
}对于包含文字的版式，每一行单独设置一行，并在desc中写入要求的确切文字。方框用于引导位置和缩放；BFL 提醒，元素可能超出其矩形范围。方框并非硬性裁切蒙版。BFL 构图教程与限制
编辑现有图像
在images中提供源图。编辑行仍保留id和desc，但将bbox替换为以下字段：
操作 | | | |
|---|---|---|---|
保留元素 | | 该元素的源方框 | 相同的方框 |
移动或调整大小 | | 该元素的源方框 | 不同的目标方框 |
添加、替换或重新着色 | | | 所需的输出方框 |
移除元素 | | 该元素的源方框 | |
将指令与编辑数组合并到prompt中，方式与构图请求相同。添加和移除操作应在两处都进行描述。对于必须保留原位的元素，添加 keep 行。BFL 指南称方框以外的像素通常会保持不变，但附近的光线、反射和阴影仍可能改变。接受编辑结果前，要将整个输出与源图比较。BFL 还报告称，在其自身测试中，约 40 × 25 像素方框内的新元素往往无法出现；这是供应商的观察，并非通用的最小尺寸，也不是 BIG CHANGE 的测试结果。BFL 编辑指南，编辑行结构
选择分辨率并核算预算
概览列出了768sq、1k、1.5k、2k以及4k，其中1k为默认值。定价页面公布了以下费率；但未列出1.5k的价格。使用该选项前，请先核实费用。BFL 概览
分辨率 | 文档列出的输出尺寸 | 每张图像的价格 | 10 次请求的计算费用 |
|---|---|---|---|
| 768 × 768 | 0.041 美元 | 0.41 美元 |
| 约 1 兆像素 | 0.048 美元 | 0.48 美元 |
| 约 4 兆像素 | 0.100 美元 | 1.00 美元 |
| 约 16 兆像素 | 0.607 美元 | 6.07 美元 |
以上为 BFL 列出的美元价格，核查日期为 10 月 3 日。10 次请求一栏为计算结果，并非实测支出。BFL 对 API 和 Playground 列出了相同价格，每个额度点数等于 0.01 美元。提交请求的响应包含cost。一项4k请求的标价约为1k的 12.6 倍；应按任务需求选择输出尺寸，并预留额外尝试的费用。更改分辨率就需要发送新请求；本指南并不能证明两次请求会生成相同构图。BFL 定价
可选的grounding设置默认值为true，会在生成前启用网页和图像搜索。BFL 称，关闭该设置后仅根据提示词生成，结果会更快。我们未测量这一速度差异，也未验证基于检索信息生成内容的准确性。BFL 检索增强说明
提交、轮询并保存结果
提交后，保留返回的polling_url，并使用 API 密钥轮询该确切 URL。它会指向存放任务的区域。Pending、Reasoning和Generating表示任务仍在运行。当任务处于Ready状态时，下载result.sample；其签名链接一小时后过期。切勿将你的x-key请求头发送到下载 URL。结果还包含result.prompt，其中显示展开后的指令；以及result.duration，表示生成耗时。BFL 获取结果说明
对被阻止或失败的任务，应采取不同于仍在运行任务的处理方式。Request Moderated表示输入被阻止；Content Moderated表示输出被阻止。再次尝试前应先调整输入。对于Error，检查响应内容；未知或过期的任务会返回Task not found。BFL 警告，任务失败时可能返回 HTTP503，但响应正文仍为正常 JSON，因此重试前应先读取其status。参考图尺寸过大会返回400；字段未知、值无效、提示词为空或图像尺寸过小则可能返回422。其他端点使用的字段，例如seed、width和input_image，在此端点中不被接受。BFL 生成与错误指南
只有在保存输出并检查其位置、所要求的文字以及编辑区域周边后，这次尝试才算完成。Ready响应只能证明已有结果可供查看；是否满足任务要求，应由你进行视觉审查。
来源与延伸阅读
- FLUX 3 Image 产品页面：说明浏览器和 API 使用方式，并提供商业权重访问。页面上的演示属于供应商材料，并非我们的测试结果。
- 10 月 1 日发布说明：标明图像功能的发布时间并介绍共用端点。我们将其中关于控制能力的宽泛说法与教程中的具体限制一并解读。
- 端点概览：列出参数、参考图限制、分辨率选项和检索增强行为。
- 边界框教程：解释两种行结构以及上文改编的奔跑剪影示例。
- 编辑指南：介绍坐标换算、参考图顺序，以及小区域和周围像素方面的注意事项。
- 生成指南：说明身份验证、异步获取结果、会过期的链接和错误处理。
- 定价：提供本文用于计算的费率。付费尝试前，应重新核实价格和请求参数；这些文档会持续更新。
