flux-kontext

原文：🇺🇸 英文

已翻译

在RunComfy上使用Flux 1 Kontext Pro（Black Forest Labs推出的精准局部图像编辑模型）编辑图片——该技能内置了模型文档中记录的提示词模式，相比直接使用基础提示词调用同一模型，能获得更优质的输出。本文档介绍了Flux Kontext的优势（单参考精准局部编辑、强大的提示词控制、持续高保真输出）、输入格式（单张图片+提示词），以及何时转而使用Nano Banana Edit / GPT Image 2 edit / Flux 2 Klein。通过本地RunComfy CLI调用`runcomfy run blackforestlabs/flux-1-kontext/pro/edit`命令。当触发词为“flux kontext”、“flux-kontext”、“flux 1 kontext”、“kontext”、“BFL kontext”，或用户明确要求使用该模型进行编辑时，启动此技能。

407.6k次下载

来源prime-skills/runcomfy-agent-skills

添加于2026-08-08

NPX安装

npx skill4agent add prime-skills/runcomfy-agent-skills flux-kontext

SKILL.md 内容（中文）

查看翻译对照 →

Flux Kontext Pro — Pro Pack on RunComfy

runcomfy.com · Model page · GitHub

Black Forest Labs推出的Flux 1 Kontext Pro——支持单参考精准局部图像编辑——托管在RunComfy Model API上。具备强大的提示词控制能力、输出稳定、高保真度。

bash

npx skills add agentspace-so/runcomfy-skills --skill flux-kontext -g

何时选择该模型（对比同类模型）

需求场景	推荐模型
单张图片精准局部编辑（如“让她拿着X”）	Flux Kontext
高保真保留源图主体特征	Flux Kontext
批量编辑1–20张图片	Nano Banana Edit
编辑图片中的多语言/嵌入文本	GPT Image 2 edit
从零生成图片，无需源图	Flux 2 Klein

如果用户明确提到“Flux Kontext” / “kontext” / “BFL Kontext”，无论场景如何都应使用此模型。

前置条件

RunComfy CLI — 执行
```
npm i -g @runcomfy/cli
```
安装
RunComfy账号 — 执行
```
runcomfy login
```
会打开浏览器设备码验证流程。
CI/容器环境 — 设置环境变量
```
RUNCOMFY_TOKEN=<token>
```
替代
```
runcomfy login
```
登录。

接口端点 + 输入格式

blackforestlabs/flux-1-kontext/pro/edit

字段	类型	是否必填	默认值	说明
`prompt`	string	是	—	单个陈述式编辑指令。
`image`	string	是	—	单个源图的可公开访问HTTPS URL。
`aspect_ratio`	enum	否	(输入图比例)	从模型页面支持的宽高比选项中选择。
`seed`	int	否	—	重复使用以对比不同变体结果。

该格式刻意简化——Kontext主要依赖提示词+单张参考图。如需多图或基于网络的编辑，请使用Nano Banana Edit。

调用方式

默认用法——局部编辑，保留其他所有内容：

bash

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the person'\''s face, pose, and clothing unchanged. Add an orange umbrella in her left hand and a slight smile.",
    "image": "https://.../portrait.jpg"
  }' \
  --output-dir <absolute/path>

使用seed生成可复现的系列变体：

bash

runcomfy run blackforestlabs/flux-1-kontext/pro/edit \
  --input '{
    "prompt": "Keep the bottle, label, and lighting unchanged. Replace the brand text on the label from \"ALPHA\" to \"AURA\".",
    "image": "https://.../bottle.jpg",
    "seed": 42
  }' \
  --output-dir <absolute/path>

提示词技巧——有效方法

单个陈述式指令。Kontext在如下格式的提示词上表现出色，例如文档示例：

"She is now holding an orange umbrella and smiling"

。使用祈使语气，单次只描述一个修改点。

优先声明保留内容。以

"保留[主体特征/姿势/构图/品牌元素]不变。"

开头，再描述修改内容。模型会优先遵循开头的声明。

仅使用单张参考图——选对参考图。不支持多图扩展。如果有多张参考图，确定主参考图并传入。如需多图流程，请使用Nano Banana Edit。

分多次进行小修改。如果Kontext输出偏离预期，将复合修改拆分为多次单指令操作（第一次：修改背景，第二次：修改服装）。

宽高比——选择支持的枚举值。不在列表中的值会被裁剪或返回错误码422。

反模式：

复合提示词（如“修改A、添加B、移除C”）→ 输出偏离预期。
尝试传入多张源图→ 模型选择错误（请使用Nano Banana Edit）。
被动语态的提示词→ 效果不稳定。
无参考图要求生成新构图→ 模型选择错误（请使用Flux 2 Klein文本生成图像功能）。

优势场景

使用场景	选择Flux Kontext的原因
单次精准局部编辑	专为该场景设计；高保真度
通过定向修改保留源图主体特征	在明确指令下具备强大的特征保留能力
品牌资产的文字或颜色替换	结合引用文本和保留声明的提示词效果极佳
单张图片快速迭代	简短提示词+单参考图=快速迭代流程

验证有效的示例提示词

页面示例：

She is now holding an orange umbrella and smiling

以保留为主的品牌编辑：

Keep the bottle silhouette, table, and lighting exactly as in the input.
Replace only the brand text on the label, from "ALPHA" to "AURA".
Same font weight, white on black, centered.

构图微调整：

Keep the person's face, pose, and clothing unchanged. Add a leather
shoulder bag, dark brown, hanging on the right shoulder.

局限性

仅支持单张源图。如需多图流程，请使用Nano Banana Edit（支持1–20张）。
RunComfy公开文档内容有限——除prompt、image、aspect_ratio、seed之外可能存在其他格式字段；请查看模型页面获取最新字段列表。
复合提示词易导致输出偏离——拆分为多次操作执行。
对于多语言/嵌入文本编辑，GPT Image 2 edit通常效果更好。

退出码

代码	含义
0	成功
64	CLI参数错误
65	输入JSON格式错误/不匹配
69	上游服务5xx错误
75	可重试：超时/429请求过多
77	未登录或令牌被拒绝

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

工作原理

该技能调用

runcomfy run blackforestlabs/flux-1-kontext/pro/edit

命令，并传入符合格式的JSON参数。CLI会向

https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-1-kontext/pro/edit

发送POST请求，轮询请求状态，获取结果，并将所有

.runcomfy.net

/

.runcomfy.com

域名的下载链接内容保存到

--output-dir

指定目录。按

Ctrl-C

会在退出前取消远程请求。

安全与隐私

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

flux-kontext

NPX安装

标签

SKILL.md 内容（中文）

Flux Kontext Pro — Pro Pack on RunComfy

何时选择该模型（对比同类模型）

前置条件

接口端点 + 输入格式

`blackforestlabs/flux-1-kontext/pro/edit`

调用方式

提示词技巧——有效方法

优势场景

验证有效的示例提示词

局限性

退出码

工作原理

安全与隐私