需要低延迟实时迭代/多参考品牌风格图像生成时，用…

在 RunComfy 托管环境下，用 Flux 2 Klein 做快速概念迭代、实时艺术指导、多参考品牌风格和最终润色图像生成。

适用场景

解决思路

1. 安装与认证：`npm i -g @runcomfy/cli`；`runcomfy login` 打开浏览器设备码流程；CI/容器中设置 `RUNCOMFY_TOKEN=<token>` 代替 `runcomfy login`。
2. 按目标选端点：实时/现场艺术指导用 `blackforestlabs/flux-2-klein/4b/text-to-image`；快速迭代且最终细节强用 `blackforestlabs/flux-2-klein/9b/text-to-image`；多参考品牌风格用 Flux 2 Klein；2K–4K hero 图用 Seedream 5；最大提示遵循+极端细节用 Flux 2 Pro；嵌入文字/logo/多语言标牌用 GPT Image 2；超写实肖像用 Nano Banana Pro。
3. 路由规则：用户明确说 "flux 2 klein"、"flux-2-klein"、"flux klein"、"BFL flux 2" 或明确要求用该模型生成时，直接路由到 Flux 2 Klein；如果只说 "Flux 2"，先问要 Klein（快）还是 Pro（最高质量），不要默认。
4. 9B schema：`prompt` 必填，最多约 512 tokens，更长会退化；`steps` 默认 25，范围 4–50，步数蒸馏架构下 4–8 足够概念，~25 用于润色，>25 收益很小；`width` 默认 1024，常用 512–1536，宽高比上限 16:9，总分辨率约 2K；`height` 默认 1024，与 `width` 的宽高意图匹配。
5. 4B schema：字段集与 9B 相同；默认 `steps` 实际为 4；该变体为亚秒级 4 步推理设计，用于实时迭代/概念。
6. 参考图：两个变体均支持最多 4 张同时参考图，用于风格迁移/引导构图；JSON body 中的确切字段名见模型 API tab 文档，通过 CLI 原样传入；参考图使用可启用编辑式工作流而不需要单独的 `/edit` 端点。
7. 快速概念调用：`runcomfy run blackforestlabs/flux-2-klein/4b/text-to-image --input '{"prompt": "<user prompt>"}' --output-dir <absolute/path>`
8. 润色/最终调用：`runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image --input '{"prompt": "<user prompt>", "steps": 25, "width": 1024, "height": 1024}' --output-dir <absolute/path>`
9. 宽幅海报调用：`runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image --input '{"prompt": "<user prompt>", "width": 1536, "height": 864}' --output-dir <absolute/path>`
10. 管道友好调用：`runcomfy --output json run blackforestlabs/flux-2-klein/4b/text-to-image --input '{"prompt":"..."}' --no-wait | jq -r .request_id`
11. CLI 行为：CLI 提交后每 2 秒轮询直到终态，然后下载结果中任何 `*.runcomfy.net` / `*.runcomfy.com` URL 到 `--output-dir`；其他 URL 只列出不抓取；stdout 是结果 JSON，stderr 是进度。
12. 取消：轮询时按 `Ctrl-C` 会发送 `POST .../requests/<id>/cancel`，避免为已停止的 GPU 付费。
13. 提示词语法：采用 "Subject + action + scene + style + lighting + camera + quality"；主语前置，指令后置。示例：`"A vibrant hummingbird mid-flight sipping nectar from a bright pink hibiscus, iridescent feathers in morning sun, soft bokeh tropical garden, macro photography, razor-sharp detail, cinematic lighting"`。
14. 具体性优先：用可预测描述，如 `"4k product photo, softbox lighting, reflective table, 35mm, f/2.8"`；不要用 `"A really pretty product image"` 这类空泛表达。
15. 按阶段调 steps：概念 4–8 steps 用 4B 获得亚秒反馈；细化 8–15 steps 仍用 4B 锁定主体+构图；润色 ~25 steps 用 9B 处理纹理、微细节、精细排版。
16. 多参考对齐：传参考图时保持美学一致；不要把水彩+照片写实+3D 渲染混在同一次调用；所有参考图选择同一视觉语域。
17. 条件编辑：先说明什么保持不变，再说明改什么。示例：`"Same composition and lighting as reference, but change the background from beach to mountain studio."` 以保持构图稳定。
18. 文字渲染：Klein 有 8B Qwen3 embedder，但不及 GPT Image 2；可加 `"crisp typography, high-contrast label"`，若文字发软把 steps 提到 ~25；大量图像内文字/多语言渲染改走 GPT Image 2。
19. 反模式：不要冲突形容词（如 "minimalist + ornate" 会抵消）；不要超过约 512 tokens（模型退化，不会优雅截断）；不要要求 4K（上限约 2K）；不要要求超宽 >16:9（会被裁剪）。
20. 已验证提示词—BFL 示例：`"A vibrant hummingbird mid-flight sipping nectar from a bright pink hibiscus flower, iridescent emerald and sapphire feathers catching the morning sun, soft bokeh tropical garden background, macro photography, razor-sharp detail, cinematic lighting"`。
21. 已验证提示词—产品照片模式：`"A matte ceramic mug on a reclaimed-wood table, soft northern window light from the left, shallow depth of field, 50mm prime, f/2.0, neutral background, e-commerce ready, 4K product photography"`。
22. 已验证提示词—品牌一致性多参考对：`"Same composition and lighting as the reference image, but the bottle label is now blue with white sans-serif typography reading "AURA"; keep the bottle silhouette, table, and shadow exactly as in the reference"`。
23. 退出码处理：0 成功；64 CLI 参数错误；65 输入 JSON/schema 不匹配（如 `width: 4096` 会 422）；69 上游 5xx；75 可重试 timeout/429；77 未登录或 token 被拒。完整参考：`docs.runcomfy.com/cli/troubleshooting`。
24. 工作原理：CLI 用 JSON body 调用 `runcomfy run blackforestlabs/flux-2-klein/<variant>/text-to-image`；CLI POST 到 `https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2-klein/<variant>/text-to-image` 并带用户 bearer token；返回 `request_id`；每 2 秒 GET `.../requests/<id>/status`；终态后 GET `.../requests/<id>/result` 并下载 host 以 `.runcomfy.net` 或 `.runcomfy.com` 结尾的 URL 到 `--output-dir`，其他 URL 只列出。
25. 安全与隐私：`runcomfy login` 将 API token 写到 `~/.config/runcomfy/token.json`，权限 0600；CI/容器用 `RUNCOMFY_TOKEN` 绕过文件；用户 prompt 通过 `--input` 作为 JSON 字符串传给 CLI，CLI 不做 shell 展开，直接经 HTTPS 发到 Model API，无 prompt 内容 shell 注入面；传入的 image/mask/video URL 由 RunComfy model server 抓取，不是本机 CLI，外部 URL 视为不可信，图像提示注入是已知风险；出站端点仅 `model-api.runcomfy.net` 和 `*.runcomfy.net`/`*.runcomfy.com` 下载白名单，无遥测/回调；CLI 中止任何单文件 >2 GiB 的下载。
26. 能力边界：不是自托管 Flux runner；不是能力授予，依赖可用 RunComfy 账号；不是多租户。

适用边界 · 注意事项

• 需要超过约 2K 分辨率、2K–4K hero 图、极端宽高比（>16:9）或 4K 输出时，不要用 Flux 2 Klein；改用 Seedream 5。
• 需要精确嵌入文字、logo、多语言标牌时改用 GPT Image 2；需要最大提示遵循+极端细节改用 Flux 2 Pro；超写实肖像改用 Nano Banana Pro。
• 提示词超过约 512 tokens、参考图超过 4 张，或没有 RunComfy 账号/令牌/CLI、要求自托管时，不适用。