图像

FLUX.1 Kontext

flux-kontext-pro

FLUX.1 Kontext 是支持图片编辑和文生图的上下文感知模型系列，提供 Pro 与 Max 两个版本、可预测的按张计费和异步任务处理。

上下文感知编辑文生图固定按张计费

获取 API Key API 文档

服务亮点

99.9% SLA
官方折扣
按量计费
高速低延

Input

模型

参考图像

提示词

宽高比

输出格式

随机种子（可选）

提示词增强

安全容忍度2

输出

Image link valid for 72 hours

定价详情

透明定价，无隐藏费用。按量付费，用多少付多少。

* 实际费用以最终输出为准。

FLUX.1 Kontext API 功能

以图片编辑为核心，提供明确的输出控制和统一异步流程

上下文感知图片编辑

通过自然语言指令修改背景、物体、颜色或视觉风格，模型会结合所传图片的上下文进行处理。

最多 4 张参考图

可传入最多四个公网图片 URL，用于构图、主体或风格参考；多参考图输入目前属于实验性能力。

9 种宽高比

通过 size 选择 1:1、4:3、3:4、16:9、9:16、3:2、2:3、21:9 或 9:21。

格式与安全控制

支持选择 PNG、JPEG 或 WebP 输出格式，并可将 safety_tolerance 设置为 0–6。

统一异步 API

通过 POST /v1/images/generations 提交任务，再轮询 GET /v1/tasks/{task_id}，直至任务完成或失败。

固定按张计费

每次请求固定返回一张图片，价格不随宽高比或参考图数量变化；任务失败会自动退款。

Pro 与 Max 两种选择

日常任务可选择速度更快、成本更低的 flux-kontext-pro；更重视输出质量时可选择 flux-kontext-max。

提示词增强与固定 Seed

可开启 prompt_upsampling 扩展提示词，也可在输入相同的情况下复用固定 seed，帮助复现生成结果。

FLUX.1 Kontext 适用场景

需要视觉上下文时传参考图，也可不传参考图直接文生图

商品、背景与物体修改

通过简洁的编辑指令制作商品变体、替换场景，或修改指定物体。

角色与风格延续

将现有图片作为上下文，帮助新编辑延续角色特征或视觉风格；实际结果会因提示词和源图而异。

实验性多参考融合

融合最多四张图片中的线索，例如将某张图的主体放入另一场景，或组合多种视觉参考。

文生图

不传 image_urls，仅发送文本提示词，即可使用任一 Kontext 版本生成新图片。

广告与社交媒体素材

基于同一核心视觉制作广告或社交媒体变体，并为不同投放位置选择受支持的宽高比。

创意概念迭代

从现有图片出发，通过文本指令逐步调整局部元素，在多轮编辑中探索可控的视觉方向。

开始使用 FLUX.1 Kontext

创建账号、完成鉴权，然后提交并轮询统一图片任务

创建账号并充值

→

生成 API 密钥

在控制台创建密钥，并在 Authorization 请求头中以 Bearer Token 方式发送。

→

提交并轮询任务

向 /v1/images/generations 发送 POST 请求，读取 data[0].task_id，再轮询 /v1/tasks/{task_id}，直至 completed 或 failed。

获取 API 密钥

FLUX.1 Kontext 常见问题

模型选择、输入、控制参数、计费和任务行为说明

FLUX.1 Kontext 是什么？

FLUX.1 Kontext 是 Black Forest Labs 的上下文感知图片模型系列，主要用于根据文本指令编辑图片，也支持纯文生图。

Pro 和 Max 有什么区别？

flux-kontext-pro 更快、成本更低，标准价为 $0.04/张，单次请求实测约 6 秒；flux-kontext-max 定位更高输出质量，标准价为 $0.08/张，单次请求实测约 9 秒。

Kontext 如何计费？

两个版本均按每张生成图片固定标准价计费，不受宽高比和参考图数量影响：Pro 为 $0.04，Max 为 $0.08。账号倍率或折扣可能影响实扣金额，请以任务结果记录的费用为准。

最多可以传几张参考图？

image_urls 最多可传四个 URL，输出图与全部参考图的总像素不得超过 9MP。多参考图属于实验性能力，并且每个 URL 都必须能从公网直接访问。

可以指定精确图片尺寸吗？

Kontext 输出恒约 1MP，resolution 不生效，传入 width 或 height 会被拒绝。size 可填写九种支持比例之一，也可填写 WIDTHxHEIGHT 像素串；像素串会换算为最接近的支持比例。16:9 与 9:16 的实际输出比例可能偏差约 4%。

支持哪些格式和 seed 控制？

通过 output_format 选择 png、jpeg 或 webp。seed 为可选参数，默认随机；在输入相同的情况下复用固定 seed，有助于复现结果。

Max 会改写提示词吗？

可能会。实测中，即使没有显式开启 prompt_upsampling，flux-kontext-max 也扩写了提示词。若必须严格保持原始措辞，请将提示词改写视为可能行为并检查输出。

异步任务、失败退款和公网 URL 有哪些注意事项？

提交生成请求后，使用返回的 task_id 轮询，直到 completed 或 failed。失败任务会自动退款。参考图 URL 必须公网可达；会拦截数据中心流量的图床可能导致抓取失败，建议使用稳定的公网地址。