Firefly 3.0 生成结果和预期不匹配，不要急着反复改提示词。先确认实际提交给服务的请求是什么，再看提示词是否被截断、选区是否把模型带偏，最后用参数对比缩小范围。整个过程只依赖日志面板、请求记录和输出图片，不推断模型内部逻辑。

生成结果不匹配时，通常从生成日志读取实际提交的 prompt 和 size，再检查提示词长度与英文逗号规范，确认选区遮罩没有误限范围，最后通过单变量对比输出定位问题。适用场景：Firefly 3.0 网页端或 API 调用；验证方式：对比每次修改前后的请求与输出；风险边界：若参数完全一致且多次复现仍错位，更可能是模型当前版本的行为，而非参数问题。

从生成日志中读取请求参数

网页端生成后的第一件事，是打开浏览器开发者工具（F12），切到 Network（网络）面板，刷新页面或重新生成一次。筛选条件里输入 firefly、generate 或直接搜 json，找到发给图片生成接口的请求。

打开这条请求的 Payload（负载）或 Request（请求）标签，重点看两个字段：prompt 和 size。把提交的 prompt 原样复制出来，与你在输入框里看到的内容逐字对比。有时前端会自动追加风格词、负面词，或把换行变成空格，这些差异会直接影响结果。

// 请求体内部字段的通用结构，字段名以当前版本实际返回为准
{
  "prompt": "a cat sitting on a wooden chair, natural light",
  "size": {
    "width": 2048,
    "height": 2048
  }
}

如果是通过 API 调用，直接在代码里打印本次请求的完整 JSON，不要只打印返回结果。确认实际发送的 size 与预期画幅一致，比如方形 1:1 和横版 16:9 的构图差异极大，但用户往往只关注提示词而忽略尺寸。

检查提示词长度与格式限制

提示词输入框通常有最大字符数限制，具体数值以界面输入框右侧的计数提示为准。当你粘贴较长描述时，超出部分的字符可能被静默截断，后端只收到截断后的内容，结果自然缺失要素。

自检表：

• 输入框内是否出现字数计数器，粘贴后数字是否暂停增加？
• 把提示词复制到本地文本编辑器，看看总字符数和换行位置。
• 提示词中间是否夹着中文逗号、中文括号或全角空格？这类符号容易被模型当作同一个 token，导致相邻概念被合并。

建议用英文逗号分隔主要元素，保持“主体 + 环境 + 光线 + 风格”的顺序。例如：a woman in red dress, standing by the window, soft morning light, editorial photography。不要用一串长句表达多个并列概念，这样模型可能只抓住前几个词。

验证生成填充区域与参考图

Firefly 3.0 支持生成填充和选区重绘。生成前先看选区遮罩的边界：遮罩外部的区域不会被重新生成，而遮罩只覆盖了元素的一部分时，模型会根据有限区域补全，结果常常与预期不符。

在选区工具开启时，截取一张当前画布的遮罩状态图，保存为 PNG。然后把这一层命名为“选区对比_日期”，再开始生成。这样等输出结果出来后，可以同时看到遮罩边界与生成范围是否一致。

如果参考图干扰了结果，尝试去掉参考图单独生成一次。参考图的边缘、分辨率、画面重点会影响模型对主体和外形的理解，尤其是参考图本身包含多个对象时，模型无法判断哪些是“参考”，哪些是“要生成的”。

调整参数后对比输出

每次只改一个参数，记录修改前后的差异。不要同时调整提示词和尺寸，否则很难判断是谁导致了变化。下面是一个可复用的对比表格模板，记录时可以只填关键项。

如果条件允许，也可以先记录一张“完全符合预期”的历史生成图，用同样的提示词和尺寸重新生成，看看结果是否稳定复现。稳定的重复结果说明问题出在参数组合，而不是偶发行为。

记录可复现的案例

排查到最后，把可复现的“不匹配”案例按失败模式分类存档。文件名建议包含日期、现象和关键参数，例如 2026-01-15_主体缺失_提示词过长 或 2026-01-16_风格偏移_参考图边角白色。

每个案例保存三样内容：

1. 本次实际提交的提示词全文（从生成日志里复制，不要从输入框复制）。
2. 请求日志摘要：prompt、size、是否带参考图、是否带选区遮罩。
3. 生成图片原图，以及对应的选区遮罩截图。

存档时可以按“缺失元素”“风格偏移”“构图错误”“多余元素”四个文件夹归类。这样后续向支持渠道反馈时，能直接给出原始日志和复现步骤，而不只是描述“生成错了”。