flux-2-klein

Flux 2 Klein — RunComfy 专业版

runcomfy.com · 9B 模型 · 4B 模型 · GitHub

Black Forest Labs 的 Flux 2 Klein（Flux 2 的蒸馏低延迟版本）托管于 RunComfy Model API — 无需 API 密钥，使用异步 REST。

npx skills add agentspace-so/runcomfy-skills --skill flux-2-klein -g

何时选择此模型（与同系列模型相比）

Flux 2 Klein 的独特优势是以低延迟优先的创意迭代：亚秒级反馈可支持实时艺术指导和快速产品可视化，而批处理风格的模型无法持续实现这一点。当迭代速度比最高分辨率更重要时，选择它。

你的需求	使用
实时／现场艺术指导	Flux 2 Klein 4B
快速迭代，并在最后获得丰富细节	Flux 2 Klein 9B
多参考图像品牌风格，保持外观一致	Flux 2 Klein
2K–4K 主视觉图，追求最高分辨率	Seedream 5
最大程度遵循提示词 + 极致细节	Flux 2 Pro
图像中的文字、徽标、多语言标识	GPT Image 2
超写实肖像	Nano Banana Pro

如果用户明确说了“Flux 2 Klein”／“BFL Klein”／“flux klein”，无论如何都应路由到此处。如果用户泛泛地说“Flux 2”，默认选择之前先询问他们想要 Klein（速度快）还是 Pro（质量最高）。

前提条件

1. RunComfy CLI — npm i -g @runcomfy/cli
2. RunComfy 账户 — runcomfy login 会打开浏览器设备代码授权流程。
3. CI／容器 — 设置 RUNCOMFY_TOKEN=<token>，而不是运行 runcomfy login。

端点和输入架构

两个版本具有相同的端点结构和提示词语法。

blackforestlabs/flux-2-klein/9b/text-to-image

优先追求保真度的版本。用于润色／最终输出。

字段	类型	必填	默认值	说明
prompt	string	是	—	最多约 512 个 token。内容更长会降低效果。
steps	int	否	25	4–50。步数蒸馏架构 — 概念设计用 4–8 步即可；润色约用 25 步；超过 25 步收益甚微。
width	int	否	1024	通常为 512–1536。宽高比上限为 16:9，总像素约不超过 2K。
height	int	否	1024	与 width 的宽高比意图一致。

blackforestlabs/flux-2-klein/4b/text-to-image

优先追求低延迟的版本。4 步推理可在亚秒内完成。用于实时迭代／概念设计。

字段与 9B 相同。steps 默认实际上为 4 — 此版本专为该步数构建。

参考图像（两个版本均支持）

同一端点支持最多 4 张参考图像，可用于风格迁移／构图引导。JSON 请求体中的准确字段名称请参阅模型的 API 选项卡 — 使用 CLI 时按原样传入。使用参考图像后，无需单独的 /edit 端点即可实现编辑类工作流。

调用方式

快速概念设计（4B，亚秒级）：

runcomfy run blackforestlabs/flux-2-klein/4b/text-to-image \
  --input '{"prompt": "<user prompt>"}' \
  --output-dir <absolute/path>

润色／最终输出（9B，约 25 步）：

runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image \
  --input '{
    "prompt": "<user prompt>",
    "steps": 25,
    "width": 1024,
    "height": 1024
  }' \
  --output-dir <absolute/path>

宽幅海报：

runcomfy run blackforestlabs/flux-2-klein/9b/text-to-image \
  --input '{"prompt": "<user prompt>", "width": 1536, "height": 864}' \
  --output-dir <absolute/path>

CLI 会提交请求，每 2 秒轮询一次，直到任务进入终止状态；随后将结果中任何 *.runcomfy.net／*.runcomfy.com URL 下载到 --output-dir。标准输出为结果 JSON。标准错误输出为进度信息。

便于管道处理的用法：

runcomfy --output json run blackforestlabs/flux-2-klein/4b/text-to-image \
  --input '{"prompt":"..."}' --no-wait | jq -r .request_id

提示词——哪些做法真正有效

这些是针对特定模型、经实测可提升输出质量的模式。

主题优先的陈述式语法。 Flux 2 Klein 的训练结构是 “主题 + 动作 + 场景 + 风格 + 光线 + 相机 + 质量”。先写主题，再补充指示。例如："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"。

具体胜过华丽辞藻。 "4k product photo, softbox lighting, reflective table, 35mm, f/2.8" 能提供可预测的引导。"A really pretty product image" 则不行。

按阶段调整步数。

• 构思：在 4B 变体上使用 4–8 步——亚秒级反馈，适合实时探索。
• 精修：仍在 4B 上使用 8–15 步，锁定主题和构图。
• 润色：在 9B 变体上使用约 25 步——优化纹理、微细节和精细排版。

多参考图对齐。 传入参考图时，保持它们的美学风格一致。在同一次调用中混用水彩、写实照片和 3D 渲染会让编辑器困惑。所有参考图都应采用一致的视觉风格。

条件式编辑：先说明哪些内容保持不变，再说明要改动什么。“保持与参考图相同的构图和光线，但将背景从海滩改成山间摄影棚。” 这种模式能稳定保持构图。

渲染文字时（Klein 使用 8B Qwen3 嵌入器，效果不错，但还达不到 GPT Image 2 的水平）：添加 "crisp typography, high-contrast label"，如果文字显得模糊，将步数提高到约 25。对于图内大量文字或多语言渲染，改用 GPT Image 2。

反模式：

• 不要使用相互冲突的形容词。“极简 + 华丽”会相互抵消。
• 不要超过约 512 个 token。模型效果会下降，且不会平滑地截断内容。
• 不要要求 4K——模型的分辨率上限约为 2K。
• 不要要求超宽画幅（>16:9）——模型会裁切图像。

擅长的领域

用例	Flux 2 Klein 的优势
实时美术指导会话	亚秒级反馈（4B）支持实时迭代
交互式产品可视化	快速生成 UI 预览和产品效果图，无需等待批处理
多参考图品牌风格统一	在多张参考图之间保持风格一致，便于生成统一的素材包
从快速构思到润色的工作流	使用 4B 进行探索，使用 9B 完成最终处理——全程采用相同的提示词语法
适用于消费级 GPU 的推理	4B 变体可在中等配置的硬件上运行；适合与可自托管方案进行比较，但使用 RunComfy 托管服务也完全可行

示例提示词（已验证效果良好）

来自模型页面（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

产品照片模式：

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

品牌风格一致的配对（多参考图）：

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

限制

• 分辨率上限约为 2K——如需更高的原生分辨率，请改用 Seedream 5。
• 宽高比上限为 16:9——极端的宽幅或高幅比例会被裁切。
• 提示词上限约为 512 个 token——更长的提示词会降低质量，且不会平滑地截断内容。
• 参考图上限为 4 张——超过 4 张会增加延迟并削弱引导效果。
• 文字渲染——8B Qwen3 嵌入器虽有帮助，但在图内文字的精确度方面，GPT Image 2 仍更胜一筹。

退出代码

runcomfy CLI 使用 sysexits 风格的代码：

code	含义
0	成功
64	CLI 参数错误
65	输入 JSON 错误 / 架构不匹配（例如，width: 4096 会返回 422）
69	上游 5xx 错误
75	可重试：超时 / 429
77	未登录或令牌被拒绝

完整参考：docs.runcomfy.com/cli/troubleshooting。

工作原理

1. 此技能会调用 runcomfy run blackforestlabs/flux-2-klein/<variant>/text-to-image，并传入符合架构的 JSON 请求体。
2. CLI 会使用用户的 bearer token，向 https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2-klein/<variant>/text-to-image 发送 POST 请求。
3. Model API 会返回 request_id；CLI 每隔 2 秒轮询一次 GET .../requests/<id>/status。
4. 状态变为终止状态后，CLI 会获取 GET .../requests/<id>/result，并将主机名以 .runcomfy.net 或 .runcomfy.com 结尾的所有 URL 下载到 --output-dir。其他 URL 会列出，但不会下载。
5. 轮询期间按下 Ctrl-C 会发送 POST .../requests/<id>/cancel，避免为已停止的 GPU 任务付费。

此技能不是什么

不是可自托管的 Flux 运行器。不是能力授权——需要有可用的 RunComfy 账户。不是多租户服务。

安全与隐私

• 令牌存储：runcomfy login 会将 API 令牌写入 ~/.config/runcomfy/token.json，文件权限为 0600（仅所有者可读写）。在 CI / 容器中设置 RUNCOMFY_TOKEN 环境变量即可完全绕过此文件。
• 输入边界：用户提示词会作为 JSON 字符串通过 --input 传给 CLI。CLI 不会进行 shell 展开，而是通过 HTTPS 将 JSON 请求体直接发送到 Model API。提示词内容不会带来 shell 注入风险。
• 第三方内容：你提供的图像 / 遮罩 / 视频 URL 由 RunComfy 模型服务获取，而不是由你机器上的 CLI 获取。请将外部 URL 视为不可信；基于图像的提示词注入是任何图像编辑 / 视频编辑模型都已知的风险。
• 出站端点：仅限 model-api.runcomfy.net（提交请求）和 *.runcomfy.net / *.runcomfy.com（生成结果的下载白名单）。没有遥测，也没有回调。
• 生成文件大小上限：为防止恶意或失控的模型输出占满磁盘，CLI 会中止任何超过 2 GiB 的单个下载。