边界框布局 · 逐框编辑 · 原生 4K ● 可用

FLUX 3 Image API

Black Forest Labs 的 FLUX 3 Image 把生成控制推进到像素级：用边界框为每个元素定位、按框局部编辑且未触碰区域保持原样，原生输出 768sq 到 4K。Roko API 以异步任务提供，768sq 每张 $0.041 起。

获取 API Key 查看完整 API 文档

公开模型 ID: flux-3-image
输出档位: 768sq / 1K / 1.5K / 2K / 4K（默认 1K）
计费方式: 按请求与所选分辨率
生成接口: POST /v1/images/tasks
目录快照: 2026/10/19 00:48:12

FLUX 3 Image 是什么？

FLUX 3 Image 是 Black Forest Labs 于 2026 年 10 月 1 日发布的图像生成与编辑模型，官方口号是“控制每一个像素”。它的差异化能力是边界框布局：把画布抽象成 0 到 1000 的归一化坐标网格，在提示词末尾为每个元素圈定范围并配描述，生成结果会满足这些位置约束。

编辑能力同样按框进行：对成品图的修改可以按框多轮完成，改过区域之外保持像素级不变，把局部重绘的误差限制在框内。它还支持最多 10 张参考图（在提示词中按位置命名），以及 grounding 联网检索增强。

Roko API 当前公开 768sq、1K、1.5K、2K、4K 五档分辨率和 16 种宽高比，按每次请求的所选分辨率计费（768sq $0.041 至 4K $0.607）。核验时数值与 BFL 标价相同，但 Roko 结算始终以当前项目目录为准；调用走异步任务，返回 task_id 后轮询结果。

核心能力

边界框布局控制

用归一化坐标网格为每个元素定位再逐框描述，把生成从“描述得准不准”变成“布局定得对不对”。

逐框局部编辑

对成品图按框多轮修改，未触碰区域保持像素级不变，避免整体漂移。

10 张参考图融合

组合最多 10 张参考图，在提示词中按位置命名，模型自行决定排布后整体渲染。

原生 4K 与 16 种宽高比

768sq 到 4K（约 16.8 兆像素）五档原生分辨率，16 种宽高比，4K 放大后仍保留细节。

FLUX 3 Image API 价格

价格由当前 Roko 模型目录生成，按每次请求的所选分辨率计费。核验时数值恰与 BFL 标价一致，但上游价格与促销不决定 Roko 结算；请以任务提交时的 Roko 估价和最终账单为准。

分辨率	价格	计费单位
768sq	$0.041	每张输出
1k	$0.048	每张输出
1.5k	$0.07	每张输出
2k	$0.1	每张输出
4k	$0.607	每张输出

费用怎么算？

生成 1 张 1K 图1 × $0.048 = $0.048

默认档位，网页与社媒素材的标准成本。

4K 印刷级成稿1 × $0.607 = $0.607

原生最高档，适合印刷与大幅输出；每张按请求计费，失败请求不计费。

参数与支持范围

以下字段来自当前公开 generation_config。边界框语法写在提示词末尾（0–1000 归一化坐标）；表单之外的能力以实际请求校验为准。

参数	可用值	说明
`prompt`	textarea	描述要生成的画面，或说明要对参考图做哪些修改。 · 必填
`images`	url / base64 · 1–10	参考图可使用 URL 或 Base64；数量上限以当前模型参数范围为准。 · 可选
`aspect_ratio`	auto / 21:9 / 2:1 / 16:9 / 3:2 / 7:5 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 5:7 / 2:3 / 9:16 / 1:2 / 9:21	选择输出宽高比；auto 交由模型按内容决定。 · 默认: auto · 可选
`resolution`	768sq / 1k / 1.5k / 2k / 4k	选择当前模型配置的输出分辨率档位；该值可能直接影响价格。 · 默认: 1k · 可选
`safety_tolerance`	0–4	Roko 当前开放 0–4：0 最严格，4 最宽松；默认 2。 · 默认: 2 · 可选
`grounding`	boolean	开启后模型可联网检索补充提示词信息；默认开启。 · 默认: true · 可选

用 Roko API 调用 FLUX 3 Image

走异步任务流程：提交任务拿到 task_id，再轮询查询结果。不要在前端代码中暴露 API Key。

发起图片生成

curl https://api.rokoapi.com/v1/images/tasks \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "flux-3-image",
  "prompt": "Modern city park poster: bounding boxes — fountain center (400,500)-(600,800), skyscrapers background left (0,0)-(350,700), oak trees background right (650,100)-(1000,750)",
  "aspect_ratio": "16:9",
  "resolution": "1k"
}'

查询恢复任务

curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
  -H "Authorization: Bearer $API_KEY"

POST /v1/images/tasks 返回 202 与 task_id，生成完成后通过 GET /v1/tasks/{task_id} 查询结果或失败原因。Idempotency-Key 需唯一；相同 Key 的重放会返回原任务而不重复计费。

适合哪些场景？

精确构图的版面与海报

标题、主体和背景元素的位置都能按框约束，适合广告版面和海报排版。

Poster: product bottle center, headline text box top-left, lifestyle scene bottom — each element in its own bounding box.

多轮局部精修

按框逐次修改，改过的区域之外保持像素不变，适合反复确认的成稿流程。

Edit only the bounding box around the logo: replace with the new wordmark, keep everything else pixel-identical.

多参考图场景合成

把人物、产品、场景等多张参考图融合进一张按框布局的图。

Combine the model from image 1, the outfit from image 2, and the studio background from image 3 into one composition.

4K 印刷与大幅输出

原生 4K（约 16.8 兆像素）输出放大后仍保留细节，适合展板与印刷物料。

Trade-show backdrop at 4K: brand hero center, product lineup along the bottom edge, clean gradient background.

使用前要知道的限制

按每次请求计费，4K 档 $0.607 明显高于低档位；大量草图迭代建议用 768sq 或 1K。
边界框使用 0–1000 归一化坐标并写在提示词末尾；框的语法错误会按普通文本处理或被请求校验拒绝。
Roko 当前将 safety_tolerance 限定为 0–4（0 最严格、4 最宽松），默认 2；调高前请确认符合适用条款。
异步任务提交成功不等于生成成功，以任务查询结果为准；生成结果仍需人工复核后使用。

FLUX 3 Image 与其他图像模型怎么选？

需要精确布局与逐框编辑选 FLUX 3；Seedream 系列适合中文场景与组图；GPT Image 2.5 适合透明背景与日常内容。按控制粒度、分辨率与价格权衡。

全部模型 →

FLUX 3 Image 常见问题

FLUX 3 Image API 的模型 ID 是什么？

Roko API 当前公开模型 ID 是 flux-3-image。请原样传入 model 字段。

FLUX 3 Image API 多少钱？

按每次请求的所选分辨率计费：768sq $0.041、1K $0.048、1.5K $0.07、2K $0.10、4K $0.607。核验时数值与 BFL 标价相同，但 Roko 结算以任务提交时的项目估价和最终账单为准。

边界框布局怎么用？

官方方案是把画布按 0 到 1000 归一化，在提示词末尾为每个元素写一个边界框和描述，例如“fountain (400,500)-(600,800)”。生成结果会满足这些位置约束。

逐框编辑是什么意思？

对已生成的图按框修改：只有框内区域被重绘，框外保持像素级不变，可以多轮进行，避免整图漂移。

支持哪些分辨率和宽高比？

Roko 当前公开 768sq、1K、1.5K、2K、4K 五档和 16 种宽高比（默认 auto）。4K 约 16.8 兆像素，属原生输出而非放大。

FLUX 3 Image 通过哪个接口调用？

通过 POST /v1/images/tasks 提交异步任务并拿到 task_id，再用 GET /v1/tasks/{task_id} 轮询结果或失败原因。

grounding 参数是做什么的？

grounding 开启后模型可联网检索来补充提示词信息（如实时事实或品牌素材描述），默认开启；不需要时可显式关闭。

开源权重可以直接用吗？

截至最近核验（2026-10-06），BFL 官方表示开放权重版本将在未来几周推出，商业权重需另行联系获取；Roko 上使用的是 BFL 官方 API 通道。