black-forest-labs-flux

使用 Black Forest Labs FLUX 生成图像

在整个操作过程中使用以下证据标注：

• [Documented] 表示 BFL 文档、BFL 模型卡／代码仓库、BFL 法律条款或 BFL 撰写的论文明确陈述了该事实。
• [Inference] 表示结论可由已记录的事实推导得出，但 BFL 并未直接陈述。
• [Heuristic] 表示应通过实际输出验证的生产建议。

将所有端点名称、限制、价格、许可证和条款都视为易变信息。以下事实已于 2026-07-09 核实。进行重大操作前，请重新查阅当前的 BFL API 参考文档、发行说明、模型卡和适用许可证。

区分不同执行方式

在选择参数或说明权利之前，先确定执行方式。

1. BFL 直连接口 — 请求发送到官方 api.bfl.ai 端点，并使用 x-key。BFL 定义请求架构、审核、计费、异步结果约定和服务条款。[Documented：D1、D2、D9]
2. 第三方托管网关 — 模型标识、接受的参数、数据保留、审核、定价和版本固定由网关定义，而非 BFL 直连接口。切勿假定 BFL 的字段或限制可以原样使用。请核实该提供方当前的文档和合同。[Inference]
3. 本地／开放权重部署 — 权重和推理运行在受检查点自身许可证约束的基础设施上。此方式不会自动具备 BFL API 审核、数据保留政策或签名结果 URL。你需要自行实现过滤、来源追踪、存储控制和容量规划。[Documented：D10、D11]

不要把所有可下载的 FLUX 检查点都称为“开源”。FLUX.2 [klein] 4B 采用 Apache-2.0 许可证；FLUX.2 [klein] 9B 和 FLUX.2 [dev] 可下载／开放权重，但受 FLUX Non-Commercial License 约束，除非适用商业权重许可证。[Documented：D10]

有针对性地选择系列

当前的 FLUX.2 方案

需求	选择	执行方式及重要事实
大多数生产环境中的生成／编辑任务	FLUX.2 [pro]	BFL 推荐的首选方案。直连端点包括可变的 flux-2-pro-preview 和固定的 flux-2-pro。API 最多支持 8 张参考图，BFL Playground 最多支持 10 张。[Documented：D1、D2]
最复杂的编辑、最强的遵循能力、最高的最终质量	FLUX.2 [max]	直连 API／Playground，API 最多支持 8 张参考图。它是具备 grounding search 的 FLUX.2 方案。只有在该质量水平或当前上下文功能值得其成本时才使用。[Documented：D1、D2]
排版、小细节保留、可调节采样	FLUX.2 [flex]	直连 API。提供 guidance 1.5–10 和 steps 1–50；支持提示词扩写，API 最多支持 8 张参考图。较高的 guidance 可能会牺牲真实感来换取遵循能力。[Documented：D1、D2]
对延迟敏感的预览、交互式工具、高吞吐量	FLUX.2 [klein] 4B or 9B	直连 API 和可下载权重；最多支持 4 张参考图。不支持提示词扩写，因此请编写完整提示词。4B 采用 Apache-2.0 许可证；9B 受 FLUX NCL 约束，除非另行获得许可。[Documented：D1、D10]
需要完全控制采样的本地定制或研究	FLUX.2 [dev] 或 [klein] Base 检查点	本地／开放权重，不属于 BFL 公共 API。BFL 建议 [dev] 最多使用 6 张参考图。蒸馏版 klein 是短步数生产方案；Base 版本保留完整训练信号，适用于微调和多样性生成。请核实具体检查点的许可证。[Documented：D1、D10]

只有在可以接受底层快照变化的情况下，才使用预览端点获取当前的质量／速度。对于回归基准、审批或对合规敏感的可复现任务，请使用固定端点。即使请求约定相同，预览端点的输出也可能变化。[Documented：D1、D12]

专用和旧版路径

• 使用 FLUX Erase 执行由蒙版驱动的移除和背景重建。它使用固定的擦除指令；调用方无需提供语义提示词。[已记录：D7]
• 使用 FLUX Outpainting 扩展画布。其当前的直接端点提供 high 和 fast 模式。[已记录：D7]
• 当需要用特定提示词指定的内容填充黑白蒙版或 Alpha 蒙版时，使用 FLUX.1 Fill [pro] 或获许可的 Fill [dev]。它在当前 API 参考中仍属于旧版路径。[已记录：D7、D10]
• 对于已获批准或受兼容性约束的迭代编辑工作流，保留使用 FLUX.1 Kontext [pro]/[max]。BFL 建议新项目使用 FLUX.2。BFL 论文支持 Kontext 的统一生成与编辑能力，并评估了多轮一致性，但这并不意味着它是当前默认选项。[已记录：D13]
• 仅当需要其特定旧版行为、适配器或已部署资产时，才继续使用 FLUX1.1 [pro]/Ultra/Raw、FLUX.1 [dev]/[schnell]、Depth、Canny 和 Redux。不要擅自迁移已锁定的工作流；应执行并排验收测试。[已记录：D9、D10]

将需求转化为生成契约

开始编写提示词前，记录以下内容：

• 最终用途、受众、适用地区，以及用途是否为商业用途；
• 确切的执行界面、端点／检查点、版本策略和许可证；
• 输出数量、尺寸／宽高比、格式、期限和成本上限；
• 主体、动作／状态、环境、构图、风格／媒介、光线、调色板和所需文本；
• 不可妥协的身份／产品／Logo 几何特征，以及允许变化的部分；
• 每张输入图像的所有者、同意状态、用途、敏感性和允许的变换；
• 针对文本、颜色、身份、产品几何特征、事实准确性和瑕疵的验收测试。

如果模型许可证、输入内容权利、同意状态或请求呈现方式尚未明确，请停止操作。不要将服务提供商接受请求视为已获发布许可。

根据可见目标状态编写提示词

使用清晰的视觉描述编写自然语言提示词。将优先级最高的内容放在前面。可参考以下顺序：

图像类型 + 主体 + 动作/状态 + 构图 + 环境 + 风格/媒介 + 光线 + 调色板 + 材质/细节 + 所需文本

这只是辅助方法，并非强制公式。只添加会改变可见输出的细节。FLUX.2 支持非常长的提示词，但 BFL 建议从简短提示词开始，再逐步补充有用的具体信息。[已记录：D3]

由于大多数 FLUX 路径不支持有用的负向提示词，因此请使用正向替代描述。将“没有人”改为“空荡的步行广场”；将“没有模糊”改为“整体保持清晰对焦”。[已记录：D4]

对于复杂的自动化需求，将 JSON 形式的字符串作为 prompt 值传入；不要臆造未记录的顶层 JSON 控制架构。可在提示词内部使用 scene、subjects、composition、camera、lighting、color_palette、style 和 text 等键。FLUX 会将其结构视为语言来理解。[已记录：D1、D5]

提示词扩写

• 在 [pro]/[max] 上，提示词扩写默认开启；当必须严格按照原文使用措辞时，设置 disable_pup: true。[已记录：D2]
• 在 [flex] 上，使用 prompt_upsampling 控制该功能。[已记录：D2]
• [klein] 不支持提示词扩写。请自行提供完整的视觉描述。[已记录：D4]
• [经验法则] 对于精确的品牌文案、严格指定的布局、受控的 A/B 测试和修复提示词，请关闭扩写；对于宽泛的构思，则保持开启。

直接 API 操作模式

对于当前 FLUX.2 直接端点：

1. 发送包含 prompt、可选的 input_image 至 input_image_8（klein 仅支持至 _4）、尺寸、可选的 seed、审核设置、格式和可选 webhook 字段的 JSON POST 请求。仅使用该端点文档中列出的字段。[文档说明：D2]
2. 记录 id、polling_url、报告的成本、输入百万像素数和输出百万像素数。
3. 轮询返回的 URL，直至状态为 Ready；明确处理审核、错误和任务未找到状态。不要无限轮询。
4. 立即下载资源。BFL 的签名结果 URL 有效期为 10 分钟。保存原始响应、端点、提示词、参数、输入哈希、输出哈希和时间戳。[文档说明：D5、D9]
5. 切勿记录 API 密钥、敏感输入的原始 URL 或 webhook 密钥。使用配置的密钥验证 webhook 回调。

可选的 seed 有助于复现结果，但当预览端点发生变化、网关不同、本地运行时不同或权重发生变化时，不要承诺像素完全一致。[文档说明 + 推断：D1、D2]

将参考图编辑构建为明确的约定

单张参考图

同时说明编辑内容和需要保留的约束：

将纸质标签替换为哑光海军蓝标签，颜色为 #102A43。保持瓶身轮廓、瓶盖、玻璃反光、相机角度、手部位置、阴影和背景不变。

用引号标明确切的旧文本和新文本。例如：将 "NORTH" 替换为 "EMBER"；保留字母高度、基线、字距、压印效果和透视。BFL 明确建议使用引号，并准确说明变更和保留内容。[文档说明：D5]

多张参考图

编写提示词前，先为每张图指定一个角色：

输入	角色示例	必须保留
image 1	基础构图	相机、背景、比例
image 2	产品特征	轮廓、标签几何形状、材质
image 3	人物特征	面部结构、头发、皮肤细节
image 4	服装	剪裁、图案、装饰边
image 5	风格参考	仅限色调、对比度、纹理

然后在提示词中说明这些角色：将 image 1 用作基础场景；把 image 2 中的瓶子放在桌上；使用 image 3 中的人物，并让其穿上 image 4 中的夹克；仅应用 image 5 的色彩分级和颗粒效果。BFL 建议明确指出“image 1”“image 2”以及每张图的角色。[文档说明：D6]

仅使用承载独立信息所必需的最少参考图。生成前先解决相互矛盾的姿势、光线、镜头、人物特征或风格线索。BFL 直接 API 当前的数量上限为：[max]/[pro]/[flex] 为 8 张，[klein] 为 4 张，本地 [dev] 建议使用 6 张。[pro] 指南还说明，输入与输出总计预算为 9MP，因此提高输出分辨率可能会减少可用参考图的数量。[文档说明：D1、D6]

[启发式] 创建联系表，记录输入索引、角色、裁剪、来源和哈希。先分别测试人物/产品参考图和风格参考图；只有各自的约定都有效后再组合。

控制排版、颜色和布局

排版

1. 当嵌入文本和细小设计细节占主导时，优先使用 [flex]；需要最大程度保持一致性时，最终编辑优先使用 [max]。[文档说明：D1、D2]
2. 将确切文案放在引号中，并尽量靠近提示词开头。
3. 指定位置、层级、字号类别、对齐方式、字体特征、颜色和承印材质：上方三分之一区域印有居中的大号标题 "MOVE LIGHT"，采用粗体窄体无衬线字体，颜色为 #F7F3E8。[文档说明：D5]
4. 保持生成的文本简短。必要时分别生成标题、副标题和 CTA。[文档说明 + 启发式：D5]
5. 以 100–200% 缩放比例校对。检查每个字形、数字、标点、基线、换行和品牌拼写。
6. [启发式] 对于法律文案、价格、长篇正文或无障碍访问关键文本，生成视觉底图，再使用设计/合成工具以确定性方式排版最终文案。

颜色

将每个十六进制代码与命名对象或组件关联；不要只提供一组无关联的调色板，并期待系统能确定性地分配颜色。BFL 记录了对象绑定的十六进制颜色引导。[已记录：D1、D5]

提示词片段示例：Bottle body: color #0B3D2E. Cap: color #F2C94C. Wordmark "MOSS": color #FFFFFF. Background: uniform color #E9E3D5.

[启发式] 将“精确颜色”视为引导要求，而非色彩管理成品的证明。对最终导出文件中的多个像素进行采样，检查色彩空间／配置文件和压缩情况；如果品牌容差是合同要求，则在后期修正。

构图与采样

• 生成前，将宽高比调整为符合预期的取景效果；不要依赖后期裁剪来修正构图。文档记载，FLUX.2 直连接口接受灵活尺寸，输出最高可达 4MP。[已记录：D1、D4]
• 仅在需要时使用 [flex] 引导。指令未得到满足时，小幅提高其值；面部、材质或光线显得不真实时，则降低其值。[已记录 + 启发式：D2]
• 只有在提示词和参考素材都已完善后，才增加 [flex] 步数。更多步数无法解决相互矛盾的需求。[已记录 + 启发式：D2]
• 测试单个提示词改动时，固定 seed、尺寸、接口、上采样选项和输入内容。每次诊断运行只更改一个变量。[启发式]

正确使用由蒙版驱动的操作

选择语义操作，而不仅仅是模型名称：

• 移除对象并重建背景： 使用 FLUX Erase。提供尺寸相同的黑白 PNG 蒙版；白色区域移除，黑色区域保留。先使用文档记载的 dilate_pixels: 10，再根据光晕或柔和边缘情况增大数值。当前范围为 0–25。[已记录：D7]
• 用指定内容填充区域： 使用 FLUX.1 Fill [pro] 直连 API，或获得适当授权的 Fill [dev] 检查点。提供尺寸相同的黑白蒙版（白色 = 修补，黑色 = 保留）或 Alpha 蒙版，以及描述目标状态的提示词。[已记录：D7]
• 扩展至边界之外： 使用当前的 FLUX Outpainting。设置目标画布，并通过 reference_offset_x／reference_offset_y 设置参考图位置；确定 auto_crop 是否可以裁剪超出边界的位置，还是应通过 422 错误来停止任务。在适合的场景中，选择 high 以获得细节和一致性，或选择 fast 以提高速度。当前的 fast 模式要求输入 base64 图像而非图像 URL；放置的参考图每侧至少为 64 px，宽高比不超过 8:1；画布加内部填充必须小于 4 MP。执行前，请核实当前的确切要求。[已记录：D7]
• 进行不使用蒙版的上下文更改： 使用 FLUX.2 编辑功能，提供输入图像并明确列出要保留的内容。[已记录：D5]

以全分辨率检查蒙版边缘。移除对象包含的阴影、反射、接触区域和被遮挡部分，都应纳入蒙版。出现可见接缝或光晕时，通常应先检查蒙版或过渡处理，而不是提示词。[启发式]

按失败类型迭代

失败	优先诊断	修复措施
主体或裁剪错误	优先级／顺序或宽高比	优先描述主体和构图；简化背景；设置最终尺寸。
参考图中的身份特征混淆	角色定义模糊或参考图过多	标明每张图的作用；移除冗余参考图；分别处理身份特征和姿势。
未要求修改的区域发生偏移	编辑指令未明确不可变内容	添加简洁的保留项列表；每轮只进行一项局部编辑；通过 QA 后再复用已批准的输出。
文本拼写错误	文案过多、层级不清或模型不合适	切换到 [flex] 或 [max]；引用较短的文案并优先描述；长文本在后期排版。
品牌颜色不准确	十六进制值未绑定到具体对象，或导出时发生变化	将代码绑定到组件；禁用升采样；对输出进行取样；在色彩管理的后期步骤中校正。
[flex] 效果过度	引导强度过高或提示词过载	降低引导强度；删除泛泛的质量形容词；测试时保留步骤设置。
移除蒙版后留下光晕	蒙版未覆盖边缘／阴影	扩大蒙版或调整 dilate_pixels；包含阴影／反射；重新运行 Erase。
局部重绘接缝或纹理不连续	蒙版过窄或上下文不足	在本地工作流中柔化／扩大蒙版；在提示词中包含周围材质／光线；了解 Fill 的局限性。
多轮生成后质量下降	反复重新编码并累积偏移	回到最近一次批准的母版；分支进行编辑；比较不可变区域；切实可行时在本地合成。
API 结果消失	签名 URL 已过期	在 10 分钟内轮询并下载；立即持久化保存输出。
相同种子生成结果不同	预览版／模型／运行时发生变化	固定端点／检查点和环境；保存哈希；将先前的种子视为溯源信息的一部分。

不要遇到每种缺陷都靠增加形容词来应对。应减少歧义、隔离变量，或在失败类型要求时更换工具／模型。

执行生产 QA

若输出未通过任何适用的检查项，请拒绝或修复：

• **需求：**主体、动作、数量、场景、宽高比、构图和情绪表达均正确。
• **身份／产品：**面部、轮廓、比例、包装结构、徽标、材质和识别标记保持稳定。
• **编辑：**已修改要求变更的像素；受保护内容、构图、光照和阴影保持可接受的稳定性。
• **排版：**文案、大小写、标点、字形完整性、换行、层级和安全边距均准确。
• **颜色：**指定组件呈现目标十六进制颜色效果；最终文件导出后满足任何经测量的容差要求。
• **解剖结构／物理效果：**手部、关节、反射、接触阴影、透视、遮挡和重复结构均合理。
• **技术：**像素尺寸、格式、Alpha、色彩配置文件和压缩均符合要求，且无接缝、光晕、色带或意外裁剪。
• **系列一致性：**角色／产品、服装、调色板、镜头、光线和风格在联系表中保持一致。
• **权利／安全：**已记录输入素材的权利和同意情况；不存在违规或误导性用途；在要求时披露合成内容；已批准隐私和机密数据处理方式。
• **溯源信息：**保留端点／检查点、界面／提供方、提示词、参数、种子、输入／输出哈希、模型／许可证版本、日期和人工审批记录。

对于当前或事实性图像，请独立核实每一项所描绘的事实。FLUX.2 [max] 的搜索落地功能不能替代编辑事实核查、来源溯源或描绘真实人物／事件的许可。[已记录 + 经验法则：D1、D11]

权利、隐私与安全

• 确认对每项参考素材、徽标、产品图片、人物肖像、风格素材和数据集拥有所有权或已获授权。BFL 要求用户尊重第三方的知识产权、隐私权和公开权。[有文档记录：D11]
• 对可识别人物的编辑，须取得明确授权。不得制作未经同意的私密影像、有害冒充、骚扰内容、侵犯隐私的内容，或具有欺骗性的“真实事件”影像。[有文档记录：D11]
• 遵守当前的 BFL 使用政策。该政策限制非法、滥用、监控／生物识别、政治竞选、有害个人数据、具有歧视性的高影响及误导性用途等。[有文档记录：D11]
• 将 API 输入／输出隐私视为合同问题。BFL 已公布的 API 条款授予 BFL 广泛权利，可使用输入和输出以运营和改进服务。除非适用协议和组织政策允许，否则不要上传机密、受监管或对客户敏感的材料。[有文档记录：D11]
• BFL 表示其不主张拥有输出的所有权，但用户仍须对输出的使用和第三方权利负责；输出相似性及其是否受版权保护取决于司法辖区和具体事实。不要承诺独占权利。[有文档记录＋推断：D11]
• 对于可自托管的模型，须严格遵守适用于模型使用的具体检查点许可证。已发布的 FLUX NCL 允许将符合规定的输出用于商业用途，但限制将模型／衍生版本用于商业或生产用途；未经必要的商业权重许可证，不得将 NCL 检查点用于付费产品或生产服务。此外，还须实施许可证要求的过滤或审核及披露措施。[有文档记录：D10]
• 保留 AI 披露信息和溯源信息。官方 FLUX.2 仓库建议使用隐形水印和 C2PA 风格的元数据；不得移除要求保留的溯源信息。[有文档记录：D10]

完整示例

示例 1 — 直接使用 API 制作产品主视觉

**意图：**制作 4:5 的营销主视觉，精确控制品牌色，并添加简短标题。

**选择：**通过 BFL 直接使用 flux-2-pro，以固定生产快照。若排版反复失败，则改用 [flex]；只有在提示词经过验证且确实需要提升最终质量时，才使用 [max]。

完整提示词：

Premium studio product photograph of one reusable aluminum water bottle, centered slightly below frame with generous clean space above. Bottle body strictly color #0B3D2E, cap strictly color #F2C94C, small white wordmark "MOSS" printed horizontally on the front. The large headline "MOVE LIGHT" appears above the bottle in bold condensed sans-serif, color #0B3D2E, exact spelling and two words on one line. Warm off-white seamless background color #E9E3D5. Soft diffused key light from upper left, subtle grounded shadow to lower right, crisp product edges, realistic brushed aluminum, 85mm studio product photography, straight-on camera, no perspective distortion.

完整请求与结果获取流程：

import hashlib, json, os, time, requests
from datetime import datetime, timezone
from pathlib import Path

PROMPT = """Premium studio product photograph of one reusable aluminum water
bottle, centered slightly below frame with generous clean space above. Bottle
body strictly color #0B3D2E, cap strictly color #F2C94C, small white wordmark
"MOSS" printed horizontally on the front. The large headline "MOVE LIGHT"
appears above the bottle in bold condensed sans-serif, color #0B3D2E, exact
spelling and two words on one line. Warm off-white seamless background color
#E9E3D5. Soft diffused key light from upper left, subtle grounded shadow to
lower right, crisp product edges, realistic brushed aluminum, 85mm studio
product photography, straight-on camera, no perspective distortion."""

headers = {
    "x-key": os.environ["BFL_API_KEY"],
    "Content-Type": "application/json",
    "accept": "application/json",
}
payload = {
    "prompt": PROMPT,
    "disable_pup": True,
    "width": 1280,
    "height": 1600,
    "seed": 240709,
    "safety_tolerance": 2,
    "output_format": "png",
}
job = requests.post(
    "https://api.bfl.ai/v1/flux-2-pro", headers=headers, json=payload, timeout=60
)
job.raise_for_status()
meta = job.json()
manifest = {
    "submitted_at": datetime.now(timezone.utc).isoformat(),
    "endpoint": "https://api.bfl.ai/v1/flux-2-pro",
    "request": payload,
    "submission_response": meta,
}
Path("moss-key-visual.manifest.json").write_text(
    json.dumps(manifest, indent=2), encoding="utf-8"
)

deadline = time.monotonic() + 300
while time.monotonic() < deadline:
    result = requests.get(meta["polling_url"], headers=headers, timeout=30)
    result.raise_for_status()
    body = result.json()
    if body.get("status") == "Ready":
        download = requests.get(body["result"]["sample"], timeout=60)
        download.raise_for_status()
        output_path = Path("moss-key-visual.png")
        output_path.write_bytes(download.content)
        manifest.update({
            "completed_at": datetime.now(timezone.utc).isoformat(),
            "retrieval_response": body,
            "output_sha256": hashlib.sha256(download.content).hexdigest(),
            "output_path": str(output_path),
        })
        Path("moss-key-visual.manifest.json").write_text(
            json.dumps(manifest, indent=2), encoding="utf-8"
        )
        break
    if body.get("status") in {"Error", "Request Moderated", "Content Moderated", "Task not found"}:
        raise RuntimeError(body)
    time.sleep(0.75)
else:
    raise TimeoutError(meta["id"])

**原因：**固定的端点支持回归审查；禁用放大处理以保护文案／布局；每个十六进制颜色值都与一个组件绑定；尺寸符合交付比例。

**预期结果：**一个瓶子、组件颜色准确、留白干净、标题简短易读、产品光照真实自然。

**可能的失败及恢复方法：**如果标题字形效果不佳，则使用相同提示词切换到 [flex]，设置 guidance: 4.5 和 steps: 40；如果仍不理想，再进行后期排版。如果颜色不准确，请检查导出的 PNG，并在色彩管理步骤中进行修正。

**变体：**删除标题部分，生成干净底图，以便后续确定性地添加文字。

示例 2 — 多参考图合成广告素材

意图： 在新场景中放置已知产品和已知人物，同时仅借用色彩风格。

输入： 图像 1：基础房间；图像 2：已获批准的瓶装产品图；图像 3：已获同意的人物；图像 4：姿势参考；图像 5：色彩分级参考。记录来源和哈希值。

选择和参数： BFL 直连 flux-2-flex；1280×1600；prompt_upsampling: false；guidance: 4.5；steps: 40；固定种子；PNG。

完整提示词：

Use image 1 as the base room and preserve its camera position, architecture, furniture, and window light. Place the exact bottle from image 2 upright on the front-right table; preserve its silhouette, cap, label geometry, wordmark, and brushed-aluminum material. Use the exact adult person from image 3 in the body pose from image 4, standing behind the table; preserve facial structure, hair, skin details, and body proportions. Apply only the muted olive-and-amber color grade and fine film grain from image 5; do not import its objects or composition. The person looks toward the bottle with a relaxed expression. Maintain realistic scale, contact shadows, reflections, occlusion, and a coherent 50mm photographic perspective. Keep all existing room objects unchanged.

特定于负载的映射： input_image=图像 1，input_image_2=图像 2，以此类推，input_image_5=图像 5。如果这些图像的实际用途不同，请勿在元数据中统称为“风格图像”。

预期结果： 房间和人物身份保持稳定；产品外形和徽标仍清晰可辨；姿势和色彩分级得以迁移，且不引入无关物体。

可能的失败及恢复方法： 如果人物身份与姿势参考融合，请将图像 4 裁剪为无面部的剪影，或换成不会暴露身份的姿势指南。如果产品文字发生偏移，请先生成不含产品的场景，再合成已获批准的产品图；或者针对单个参考图执行定向修复。

变体： 若要快速预览，可测试 [klein]，最多使用四张参考图：移除色彩分级参考，并在文字中描述色彩分级；不要认为预览结果能预测最终 [flex] 的保真度。

示例 3 — 蒙版操作选择

意图： 移除麦克风并重建墙面，然后在另一个版本中放置一幅小型装框画。

移除分支： 使用 POST /v1/flux-tools/erase-v1。提供照片和尺寸相同的二进制 PNG 蒙版，并将二者编码为 base64；白色覆盖麦克风、线缆、接触阴影和墙面反光；黑色保留其他所有内容。从 dilate_pixels: 10、output_format: "png" 开始。不发送提示词。

带提示词的局部重绘分支： 仅在装框画版本中使用旧版 POST /v1/flux-pro-1.0-fill。沿用相同的蒙版约定，并使用以下提示词：

A small thin black metal picture frame centered on this wall region, containing a simple cream paper print with one dark green circle, matching the existing wall perspective and warm side lighting, realistic contact shadow, preserve all unmasked pixels.

设置 steps: 40、guidance: 35、prompt_upsampling: false、固定种子和 PNG。这些参数适用于 FLUX.1 Fill；请勿将其复制到 FLUX.2 [flex]。

预期结果： Erase 版本包含连贯的墙面纹理；Fill 版本包含一个透视正确的画框；未蒙版内容保持稳定。

可能的失败及恢复方法： 出现光晕，说明蒙版或膨胀范围未覆盖边缘。出现纹理接缝，说明需要更多过渡区域。画框不正确是 Fill 提示词或蒙版的问题，而不是向 Erase 发送语义文本的理由。

来源

以下所有时效性来源核查均于 2026-07-09 完成。

• D1 — BFL 模型范围与选择： FLUX.2 概览、BFL 模型目录、发行说明。
• D2 — 直接 API 架构： FLUX.2 max、pro、flex 和 klein 4B。
• D3 — 提示词构建： 提示词基础知识、构建优质提示词。
• D4 — 参数与正向提示词： 技术参数、提示词参考。
• D5 — 字体排印、色彩与单参考图编辑： 风格、美学与文本、单参考图编辑、FLUX.2 提示词指南。
• D6 — 多参考图限制与方法： 图像编辑概览、多参考图编辑。
• D7 — 蒙版与画布工具： FLUX Erase、FLUX Outpainting、FLUX.1 Fill API、FLUX.1 Fill dev 模型卡。
• D8 — 架构／研究背景： FLUX.2 官方推理代码库、FLUX.2 表征研究索引。
• D9 — API 生命周期： FLUX.2 文生图、FLUX.2 图像编辑、获取结果架构。
• D10 — 权重与许可证： FLUX.2 klein 4B 模型卡、klein 9B 模型卡、FLUX.2 dev 模型卡、FLUX 非商业条款、商业权重许可、FLUX.1 官方代码库／模型表。
• D11 — 权利与安全： BFL 使用政策、FLUX API 服务条款、网站与 FLUX 条款、知识产权政策。
• D12 — 端点时效性： BFL 发行说明。
• D13 — 上一代产品背景： FLUX.1 Kontext 概览、Kontext 编辑指南、FLUX.1 Kontext 论文。