AI-translated from English; not yet reviewed by a fluent editor.

# FLUX 3 Image：版式方框与定向编辑指南

> 使用 FLUX 3 Image 的版式方框和参考图控制构图或定向编辑。本指南依据产品文档，介绍坐标、检索、价格和限制。

By BIG CHANGE Editorial

Published: 2026-10-03T04:10:59.237Z
Updated: 2026-10-03T04:10:59.237Z
Canonical: https://bigchange.ai/blog/flux-3-image-layout-editing-guide

![Conceptual charcoal illustration of one right hand placing a flat runner cutout on an orange square art backing.](https://bigchange.ai/api/media/file/flux-layout-collage-hero-v1.png)
AI-generated conceptual editorial illustration by BIG CHANGE.

FLUX 3 Image 允许你在图像提示中使用矩形，描述各个元素应放置的位置。同一套系统也支持编辑参考图：每个元素都可以有源位置、目标位置，以及需要更改内容的描述。Black Forest Labs 将图像端点加入其[2026 年 10 月 1 日发布说明](https://docs.bfl.ai/release-notes)。

对设计师和创作者而言，关键区别在于：是规划完整构图，还是更改现有图像中的某个元素。本指南说明如何在两者间选择、如何将矩形转换为所需坐标，以及如何获取 API 结果。这是一份仅依据文档编写的指南，核查日期为 2026 年 10 月 3 日。BIG CHANGE 未使用该产品生成或编辑图像。

## 重大变化

- **发生了什么变化：**BFL 在 10 月 1 日发布的说明记录了通过`v1/flux-3-image`来进行构图和编辑。场景描述与 JSON 元素表格共用一个提示词，方框用于指定位置或编辑范围。[BFL 发布说明](https://docs.bfl.ai/release-notes)
- **为何重要：**创作者可以将计划中的矩形转换成坐标，再指定参考图中的哪些元素要保留、移动或替换。实际使用时要决定描述到什么程度：完整构图、简单指令，还是明确的编辑表格。[BFL 方框教程](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **接下来关注什么：**提交前先选择分辨率并核算预算：列出的`1k`和`4k`价格分别为每张图像 0.048 美元和 0.607 美元。方框允许元素溢出，编辑也可能影响周围的光照、阴影或反射，因此应检查完整结果。[BFL 定价](https://docs.bfl.ai/quick_start/pricing)，[编辑限制](https://docs.bfl.ai/flux_3/flux3_image_layout)

## 选择浏览器或 API 方式

BFL 的[产品页面](https://bfl.ai/models/flux-3-image)介绍了两种入口：在浏览器 Playground 中绘制方框，或通过 API 发送版式提示词。[文档提供 Playground 链接](https://playground.bfl.ai)，可无需编写代码直接使用。如果你想直接绘制区域，可走浏览器方式；如果需要在请求中提供坐标并以程序方式获取结果，则使用 API。我们未查看当前 Playground 控件，因此下文说明的是文档记载的请求格式，而非浏览器按钮的逐步操作。

使用 API 时，先创建 BFL 账户、添加额度，并从[控制面板](https://dashboard.bfl.ai)获取密钥。提交包含`POST`请求的 JSON 至`https://api.bfl.ai/v1/flux-3-image`，使用`Content-Type: application/json`以及在`x-key`请求头中传入密钥。仅`prompt`为必填项。[BFL 生成指南](https://docs.bfl.ai/flux_3/flux3_image_generate)、[定价与设置](https://docs.bfl.ai/quick_start/pricing)

FLUX 3 Image 和 FLUX 3 Dev 必须区分开来：本说明针对 BFL 托管的 Image 端点。Image 产品页面提供通过销售团队申请的商业权重许可。本指南所查阅的资料不能证明 FLUX 3 Image 提供开放权重下载。[FLUX 3 Image 访问方式](https://bfl.ai/models/flux-3-image)

## 决定要明确描述图像的哪些部分

| 任务 | 文档记载的输入 | 使用的控制方式 |
| --- | --- | --- |
| 生成新构图 | 场景提示词，可选附加元素表格 | `bbox`对每个需要确定位置的元素逐一说明 |
| 更改可识别的细节 | 一条指令和一张参考图 | 精确的描述可能已经足够；检查展开后的提示词 |
| 精确选择要编辑的元素 | 一条指令、一张参考图和编辑表格 | 为每个要保留的元素提供源方框和保留行 |
| 组合多张参考图 | 说明各图用途的提示词，以及 2 至 10 张图像 | 标明每张图分别提供哪个主体、物体或场景 |

BFL 表示，简单编辑时系统可以在提示词扩展过程中自动获取方框。如需明确控制，请自行提供表格。在普通指令中，“image 1”指第一张参考图；在编辑表格中，同一张参考图则是`ref_image_0`。[BFL 编辑指南](https://docs.bfl.ai/flux_3/flux3_image_layout)

参考图放入`images`字段中，以 URL 或 base64 数据形式提供，可使用字符串或列表。提供参考图时，数量可为 1 至 10 张；每张尺寸需在 256 × 256 像素至 16 兆像素之间。默认`aspect_ratio`为`auto`：若提供参考图，则跟随第一张图的比例；若未提供，则生成正方形图像。版式有特定形状要求时，请明确设置。[BFL 端点概览](https://docs.bfl.ai/flux_3/flux3_image_overview)

## 将矩形换算为方框坐标

每个方框均采用`[top, left, bottom, right]`格式，坐标为 0 至 1000 的整数。先写垂直坐标。两个坐标轴都独立覆盖整张图像，因此网格会按横向或纵向画布拉伸以适应图像。[BFL 方框格式](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)

要将像素位置换算为坐标，上边和下边分别除以图像高度，左边和右边分别除以图像宽度。将结果乘以 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 坐标换算](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)

## 创作新图像

撰写完整构图的描述，并使用`<id>`标记给元素命名。附加一个 JSON 数组，针对每个元素列出`id`、`bbox`和`desc`。数组应作为`prompt`中的文本，而不是另一个顶层 API 字段。

BFL 文档中的奔跑剪影示例将背景铺满画布，并将人物放在中央方框内。下面这个精简请求沿用了该示例的版式；BIG CHANGE 未运行此请求：

```json
{
  "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 构图教程与限制](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)

## 编辑现有图像

在`images`中提供源图。编辑行仍保留`id`和`desc`，但将`bbox`替换为以下字段：

| 操作 | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| 保留元素 | `"ref_image_0"` | 该元素的源方框 | 相同的方框 |
| 移动或调整大小 | `"ref_image_0"` | 该元素的源方框 | 不同的目标方框 |
| 添加、替换或重新着色 | `null` | `null` | 所需的输出方框 |
| 移除元素 | `"ref_image_0"` | 该元素的源方框 | `null` |

将指令与编辑数组合并到`prompt`中，方式与构图请求相同。添加和移除操作应在两处都进行描述。对于必须保留原位的元素，添加 keep 行。BFL 指南称方框以外的像素通常会保持不变，但附近的光线、反射和阴影仍可能改变。接受编辑结果前，要将整个输出与源图比较。BFL 还报告称，在其自身测试中，约 40 × 25 像素方框内的新元素往往无法出现；这是供应商的观察，并非通用的最小尺寸，也不是 BIG CHANGE 的测试结果。[BFL 编辑指南](https://docs.bfl.ai/flux_3/flux3_image_layout)，[编辑行结构](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)

## 选择分辨率并核算预算

概览列出了`768sq`、`1k`、`1.5k`、`2k`以及`4k`，其中`1k`为默认值。定价页面公布了以下费率；但未列出`1.5k`的价格。使用该选项前，请先核实费用。[BFL 概览](https://docs.bfl.ai/flux_3/flux3_image_overview)

| 分辨率 | 文档列出的输出尺寸 | 每张图像的价格 | 10 次请求的计算费用 |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | 0.041 美元 | 0.41 美元 |
| `1k` | 约 1 兆像素 | 0.048 美元 | 0.48 美元 |
| `2k` | 约 4 兆像素 | 0.100 美元 | 1.00 美元 |
| `4k` | 约 16 兆像素 | 0.607 美元 | 6.07 美元 |

以上为 BFL 列出的美元价格，核查日期为 10 月 3 日。10 次请求一栏为计算结果，并非实测支出。BFL 对 API 和 Playground 列出了相同价格，每个额度点数等于 0.01 美元。提交请求的响应包含`cost`。一项`4k`请求的标价约为`1k`的 12.6 倍；应按任务需求选择输出尺寸，并预留额外尝试的费用。更改分辨率就需要发送新请求；本指南并不能证明两次请求会生成相同构图。[BFL 定价](https://docs.bfl.ai/quick_start/pricing)

可选的`grounding`设置默认值为`true`，会在生成前启用网页和图像搜索。BFL 称，关闭该设置后仅根据提示词生成，结果会更快。我们未测量这一速度差异，也未验证基于检索信息生成内容的准确性。[BFL 检索增强说明](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)

## 提交、轮询并保存结果

提交后，保留返回的`polling_url`，并使用 API 密钥轮询该确切 URL。它会指向存放任务的区域。`Pending`、`Reasoning`和`Generating`表示任务仍在运行。当任务处于`Ready`状态时，下载`result.sample`；其签名链接一小时后过期。切勿将你的`x-key`请求头发送到下载 URL。结果还包含`result.prompt`，其中显示展开后的指令；以及`result.duration`，表示生成耗时。[BFL 获取结果说明](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)

对被阻止或失败的任务，应采取不同于仍在运行任务的处理方式。`Request Moderated`表示输入被阻止；`Content Moderated`表示输出被阻止。再次尝试前应先调整输入。对于`Error`，检查响应内容；未知或过期的任务会返回`Task not found`。BFL 警告，任务失败时可能返回 HTTP`503`，但响应正文仍为正常 JSON，因此重试前应先读取其`status`。参考图尺寸过大会返回`400`；字段未知、值无效、提示词为空或图像尺寸过小则可能返回`422`。其他端点使用的字段，例如`seed`、`width`和`input_image`，在此端点中不被接受。[BFL 生成与错误指南](https://docs.bfl.ai/flux_3/flux3_image_generate)

只有在保存输出并检查其位置、所要求的文字以及编辑区域周边后，这次尝试才算完成。`Ready`响应只能证明已有结果可供查看；是否满足任务要求，应由你进行视觉审查。

## 来源与延伸阅读

- [FLUX 3 Image 产品页面](https://bfl.ai/models/flux-3-image)：说明浏览器和 API 使用方式，并提供商业权重访问。页面上的演示属于供应商材料，并非我们的测试结果。
- [10 月 1 日发布说明](https://docs.bfl.ai/release-notes)：标明图像功能的发布时间并介绍共用端点。我们将其中关于控制能力的宽泛说法与教程中的具体限制一并解读。
- [端点概览](https://docs.bfl.ai/flux_3/flux3_image_overview)：列出参数、参考图限制、分辨率选项和检索增强行为。
- [边界框教程](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)：解释两种行结构以及上文改编的奔跑剪影示例。
- [编辑指南](https://docs.bfl.ai/flux_3/flux3_image_layout)：介绍坐标换算、参考图顺序，以及小区域和周围像素方面的注意事项。
- [生成指南](https://docs.bfl.ai/flux_3/flux3_image_generate)：说明身份验证、异步获取结果、会过期的链接和错误处理。
- [定价](https://docs.bfl.ai/quick_start/pricing)：提供本文用于计算的费率。付费尝试前，应重新核实价格和请求参数；这些文档会持续更新。

## Sources

- [FLUX 3 Image](https://bfl.ai/models/flux-3-image) — 说明浏览器和 API 使用方式，并提供商业权重访问。本次查阅的资料无法证明此 Image 端点提供开放权重下载。页面演示来自供应商，并非我们的测试结果。
- [FLUX 3 Image 概览](https://docs.bfl.ai/flux_3/flux3_image_overview) — 列出参数、参考图限制、分辨率选项和检索增强行为。
- [FLUX 3 Image 版式与编辑](https://docs.bfl.ai/flux_3/flux3_image_layout) — 介绍坐标换算、参考图顺序，以及小区域和周边像素方面的注意事项。
- [FLUX 3 Image 生成](https://docs.bfl.ai/flux_3/flux3_image_generate) — 说明身份验证、异步获取结果、会过期的链接和错误处理。
- [发布说明](https://docs.bfl.ai/release-notes) — 标明图像功能的发布时间并介绍共用端点。宽泛的控制能力说法应结合教程中较具体的限制一并理解。
- [定价](https://docs.bfl.ai/quick_start/pricing) — 提供本文用于计算的费率。付费尝试前，应重新核实价格和请求参数；这些是持续更新的文档。
- [FLUX 3 Image 边界框](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — 解释两种行结构以及本文改编的奔跑剪影示例。