Flux Kontext Pro Edit API

blackforestlabs/flux-kontext-pro
image_urls · size · output_format

Flux Kontext Pro Edit 通过自然语言指令智能编辑源图片,支持免遮罩局部修改、文字替换与背景迁移。它在呈现目标改动的同时,严格保留主体人脸面容与原始采光朝向。

获取 API 密钥
Input
必填0/2000
必填
可选
可选
Output待生成

生成的图片将在此处显示

预估费用: 8 credits · $0.040

每次生成 8 credits($0.040)。

继续使用

示例

pro-edit-02-output.jpg

Replace the painted name on the bow "MARISOL" with "ALBATROS". Paint the new letters in the same hand-painted white capital lettering style, same size, same brush texture, with the same chipping and weathering as the rest of the hull. Keep everything else unchanged: the boat, its sky blue hull and white stripe, the rope and buoy, the pebble beach, the palafito stilt houses, the hills, the overcast light and the camera framing.

pro-edit-01-output.png

Change the time of day from bright midday to late night. The only light source is now a single old tin oil lantern with a warm flickering flame, placed on the ground to the left of the woman, casting warm orange light across her face, hands and the textile and long soft shadows on the wall. The sky above the courtyard becomes deep navy with a few stars, the turquoise door and bougainvillea fall mostly into shadow. Keep everything else exactly the same: the woman's face, expression, pose, braid with red ribbons, embroidered huipil, the exact position of her hands on the batten, the diamond pattern of the textile, the loom, the post, the clay jar and the camera framing.

pro-edit-03-output.jpg

Remove the stacked white plastic chairs, the yellow bucket, the grey mop and the green garden hose. Fill in the areas behind them with the matching zellige mosaic fountain tiles and patterned floor tiles, continuing the existing geometric pattern and the diagonal late-afternoon light and shadows. Keep the fountain, the water, the arches, the carved balconies, the orange trees in terracotta pots and the camera framing exactly the same.

Flux Kontext Pro Edit

Flux Kontext Pro Edit 是 Black Forest Labs 研发的上下文感知图像编辑大模型。基于统一流匹配 Transformer 架构,用户无需手绘遮罩,仅凭日常语言即可实现元素增删、服装更换、背景迁移与图内文字替换。模型在 5–6 秒内完成渲染并精准保持主体面容与环境采光一致性,大幅提升商业修图效率。

为什么选择 Flux Kontext Pro Edit API?

  • 免手绘遮罩的自然语言修图彻底告别繁琐的区域蒙版涂抹,仅凭简明文本指令即可自动定位修改范围,局部调整时背景与无关物件纹理保持原生冻结。

  • 出众的人物面容与身份一致性依托强大的上下文注意力机制,在更换发型、服饰、姿势或背景时高度保真原始人物五官与生物特征,支持多轮连贯创作。

  • 精准的图内文字定位与替换原生支持替换原图中的招牌、海报、包装盒与车牌文字,精准契合原文字体风格、倾斜角度、光影遮挡与透视关系。

  • 5–6 秒快速多轮迭代精修流匹配高效推理底座带来约 5–6 秒的单次生成速度,支持用户基于上一轮生成结果连续追加微调,步步逼近理想商业效果。

参数说明

参数要求说明
prompt必填

描述要编辑的内容,长度为 1–2,000 个字符,包含至少一个非空白字符。

image_urls必填

提供 1 个公开可访问的 HTTP(S) 图片 URL 作为源图片,可填写 URL 或上传图片。

size可选

输出图片的宽高比,默认 1:1。

默认值1:14:33:416:99:1621:99:21
output_format可选

输出图片的文件格式,可选 png 或 jpg。

pngjpg

使用方法

  1. 上传源图片并编写编辑指令提供 1 张主体清晰的 HTTP(S) 参考图片,并在提示词中清晰阐述要改变的目标与需要保留的特征(如“将背景更换为海滩,保持人物位置和面容不变”)。

  2. 设定画幅比例与输出格式选择与输出要求匹配的画幅比例(默认 1:1,也可选用 16:9、9:16 等),并指定图片文件格式为 png 或 jpg。

  3. 提交编辑任务并获取结果通过 API 提交请求取得 task_id,通过轮询或 webhook 回调获取编辑后的高保真图片;如需进一步调整,可将结果图片作为新源图继续迭代。

计费说明

每次生成 8 credits($0.040),输出 1 张编辑后的高保真图片。

用量价格说明
标准编辑8 credits/次 · $0.040/次适用于所有 size 比例与 output_format 格式选项

适用场景

  • 电商产品场景重塑与背景替换上传静物白底图或单色棚拍图,一键置换为奢华大理石、自然森林或温馨家居背景,光影自然融入。

  • 商业包装标语与跨语言本地化直接替换海报、户外广告牌或商品外包装上的英文文字,保留原始材质反光与印刷质感,大幅节省重拍成本。

  • 角色 IP 多场景叙事与换装在严格锁定动漫或写实人物面部识别特征的前提下,为同一主角换穿不同季节服饰并置身于多元故事情境中。

实用技巧

  • 双重明确法(改什么 + 保留什么):优秀的编辑提示词应同时包含修改目标与保留声明,例如:Change the jacket color to black while keeping the exact face, pose, and background.
  • 引号精准替换文字:替换图内文字时使用直观替换句式,例如:Replace 'OPEN' with 'CLOSED' while maintaining the original sign font style.
  • 复杂编辑分步执行:若需要同时更换人物服装、发型与背景,建议分为 2–3 次连续编辑,每次专注一个维度以获得最高的一致性与细节质感。

注意事项

  • 单图输入规范:本端点严格接收恰好 1 张公开可访问的 HTTP(S) 图片 URL;若无需源图仅需文本创作,请调用 Flux Kontext Pro Text to Image 端点。
  • 提示词范围:除去前后空白字符后,指令文本长度需在 1 至 2,000 字符之间。
  • 计费保障机制:单次编辑固定消耗 8 credits($0.040),若任务在处理过程中出现异常未产出结果,预扣积分将自动原路返还。

相关模型

Flux Kontext Pro Edit API 常见问题

Flux Kontext Pro Edit API 是什么?

Flux Kontext Pro Edit 是 Black Forest Labs 用于高质量指令式图像编辑的流匹配大模型。它根据 1 张参考图片与自然语言指令生成高保真修改图像,具备无需手绘遮罩的精准局部编辑、强大的图内文字替换与 5–6 秒快速响应优势。基于先进的上下文流匹配架构,它在严格保留源图人物身份、构图透视与自然采光的同时,精准呈现预期的材质、元素与场景变化。你可以通过 API 进行程序化调用,也可以在上方体验区直接在线试用。

Flux Kontext Pro Edit 编辑图像时需要绘制遮罩吗?

不需要。Flux Kontext Pro Edit 具备端到端的上下文视觉理解能力,能够直接从自然语言提示词中推断修改意图与目标区域,无需用户手动涂抹选区或上传黑白遮罩图即可完成精细修改。

Flux Kontext Pro Edit 如何在修改时保持人物面容一致性?

模型内置强大的面部与主体特征锚定机制。在提示词中建议加入显式的保持指令(例如 while preserving exact facial features and identity),并在更换发型、服饰或背景时保持主体姿态说明,即可确保面容细节自然连贯。

Flux Kontext Pro Edit 支持直接替换图片里的文字吗?

支持。该模型是图内文字替换的行业标杆,原生支持在招牌、书本、包装盒与车牌上更新文本。编写指令时建议使用半角单引号或双引号标明原文字与新文字(例如 Replace 'Summer' with 'Winter'),并说明保留原字体风格。

Flux Kontext Pro Edit 支持哪些源图片输入格式?

支持通过公开的 HTTP 或 HTTPS 链接输入常见的 JPG、JPEG、PNG 与 WEBP 等主流静态图像格式。单次编辑请求须包含恰好 1 张源图片 URL,且建议选择主体清晰、光照均匀的图片以达到最佳编辑效果。

Flux Kontext Pro Edit 能进行多轮连续微调吗?

可以。模型专为多轮交互式编辑设计,你可以将上一轮生成的图片 URL 作为新请求的输入源图片,继续输入新的调整指令逐步细化构图与细节,在连续创作中保持极高的稳定性。

已有静态图做简单背景替换该选哪个端点?

推荐直接使用 Flux Kontext Pro Edit。该端点专为单图参考与局部/全局编辑优化,单次仅需 8 credits 且耗时仅 5–6 秒,只需在指令中指明置换背景并保留主体即可快速获得光影自然融合的成品图。