SuperAPI AI 工具集

flux-2-klein

设计与创作

查看项目

更新于 10-15 08:33

技能介绍

Flux 2 Klein — Pro Pack 基于 RunComfy,调用 Black Forest Labs 的 Flux 2 Klein 模型,这是 Flux 2 的蒸馏低延迟变体,托管在 RunComfy Model API 上,无需 API key,采用异步 REST 接口。

【模型选择】 Flux 2 Klein 的核心优势是延迟优先的创意迭代:亚秒级反馈支持实时艺术指导与快速产品可视化。选择建议:实时/现场艺术指导用 Flux 2 Klein 4B;需要快速迭代且最终有强细节用 Flux 2 Klein 9B;多参考品牌风格统可用 Flux 2 Klein;2K–4K 主图与最大分辨率用 Seedream 5;最大提示词遵循与极致细节用 Flux 2 Pro;嵌入文字、logo、多语言标牌用 GPT Image 2;超写实人像用 Nano Banana Pro。若用户明确说“Flux 2 Klein”/“BFL Klein”/“flux klein”,直接路由到此。若只说“Flux 2”,先询问是要 Klein(快)还是 Pro(最高质量)。

【前置条件】 RunComfy CLI:npm i -g @runcomfy/cli。RunComfy 账号:runcomfy login 会打开浏览器设备码流程。CI/容器:设置 RUNCOMFY_TOKEN=<token> 替代 runcomfy login。

【端点与输入结构】 两种变体共用同一端点结构与提示词语法。 9B 端点: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)。 4B 端点:blackforestlabs/flux-2-klein/4b/text-to-image,延迟优先,亚秒级 4 步推理,用于实时迭代/概念探索。字段集与 9B 相同,默认步数实际为 4。 参考图:两种变体均支持最多 4 张同时参考图,用于风格迁移/引导构图。JSON body 中的确切字段名请查阅模型 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。stdout 为结果 JSON,stderr 为进度。 管道友好用法: runcomfy --output json run blackforestlabs/flux-2-klein/4b/text-to-image
--input '{"prompt":"..."}' --no-wait | jq -r .request_id

【提示词技巧】 主题优先的陈述式语法:模型训练结构为“主题 + 动作 + 场景 + 风格 + 光照 + 相机 + 质量”。主题前置,指令后置。示例:"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" 则不行。按阶段控制步数:概念 4–8 步用 4B;细化 8–15 步仍用 4B,锁定主题与构图;打磨约 25 步用 9B。多参考对齐:参考图美学需一致,混用水彩+照片写实+3D 渲染会令编辑器困惑。条件式编辑:先说明保留什么,再说明改变什么。文本渲染:Klein 有 8B Qwen3 嵌入器,效果尚可但不及 GPT Image 2;若文字发软,加 "crisp typography, high-contrast label" 并将步数提高到约 25;重度图像内文字或多语言渲染请改用 GPT Image 2。反模式:不要冲突形容词;不要超过约 512 token;不要要求 4K;不要要求超过 16:9 的超宽比例。

【适用场景】 实时艺术指导(4B 亚秒级反馈);交互式产品可视化(快速 UI 预览与产品 comps);多参考品牌风格(跨参考图强风格一致性);快速概念→打磨工作流(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 张,更多会增加延迟并稀释引导;文本渲染虽受益于 8B Qwen3 嵌入器,但精确嵌入文字仍以 GPT Image 2 更优。

【退出码】 runcomfy CLI 使用 sysexits 风格代码:0 成功;64 CLI 参数错误;65 输入 JSON/schema 不匹配(如 width: 4096 会返回 422);69 上游 5xx;75 可重试:超时/429;77 未登录或 token 被拒。完整参考:docs.runcomfy.com/cli/troubleshooting。

【工作原理】 技能调用 runcomfy run blackforestlabs/flux-2-klein/<variant>/text-to-image,JSON body 匹配 schema。CLI 用用户 bearer token POST 到 https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-2-klein/<variant>/text-to-image。Model API 返回 request_id;CLI 每 2 秒轮询 GET .../requests/<id>/status。终态时 CLI 获取 GET .../requests/<id>/result 并下载主机以 .runcomfy.net 或 .runcomfy.com 结尾的 URL 到 --output-dir。轮询时 Ctrl-C 会发送 POST .../requests/<id>/cancel,避免为已停止的 GPU 付费。

【安全与隐私】 Token 存储:runcomfy login 将 API token 写入 ~/.config/runcomfy/token.json,权限 0600(仅所有者读写)。CI/容器中可设 RUNCOMFY_TOKEN 环境变量完全绕过文件。输入边界:用户提示词通过 --input 作为 JSON 字符串传给 CLI,CLI 不做 shell 展开,直接通过 HTTPS 传输 JSON body 到 Model API,无 shell 注入面。第三方内容:传入的 image / mask / video URL 由 RunComfy 模型服务器获取,而非本地 CLI;外部 URL 应视为不可信,图像提示词注入是任何图像/视频编辑模型的已知风险。出站端点:仅 model-api.runcomfy.net(请求提交)和 *.runcomfy.net / *.runcomfy.com(生成输出下载白名单),无遥测、无回调。生成文件大小上限:CLI 会中止任何超过 2 GiB 的单个下载,防止恶意或失控模型输出占满磁盘。

【此技能不是】 不是自托管 Flux 运行器;不是能力授予,依赖可用的 RunComfy 账号;不支持多租户。