返回模型列表

FLUX.1 Kontext Pro

black-forest-labsblack-forest-labs/flux-kontext-pro

Black Forest Labs' image-edit model. 12B parameters, flow-matching diffusion transformer. Edits an input image based on a text instruction while preserving composition.

FLUX.1 Kontext [pro] 是 Black Forest Labs 于 2025 年 5 月 29 日发布的生产级上下文感知图像编辑模型,是 Kontext 系列的旗舰版本。它将高质量文生图、本地编辑、角色一致的多轮编辑和风格参考统一在单一托管流匹配模型中。该模型为闭源,仅通过 BFL 托管 API 及合作伙伴(包括 SiliconFlow)提供。

对 TheRouter 路由用户而言,[pro] 是迭代编辑工作负载的推荐默认选项:品牌素材迭代、产品可视化、叙事插画,以及任何对速度和角色一致性要求高于极致文字渲染的场景。单图价格为 0.04 美元([max] 的一半),并共享相同的异步 API 契约与区域端点。

适合使用
  • • 需要跨场景保持角色/身份一致性的多轮迭代编辑流程。
  • • 品牌素材流程、产品可视化和需要快速周转的叙事插画。
  • • 局部编辑与定向修改,而不影响图像其余部分。
不适合使用
  • • 需要极致文字渲染或最高 prompt 遵循度——请改用 [max]。
  • • 对成本敏感的大批量生成——若可接受开源权重,请使用 [dev]。
上下文长度
--
最大输出
--
图片价格按次
$0.0432每张图片
输入价格按次
$0.0432每百万 Tokens

模态能力

文本图像→图像

能力

视觉理解图像生成图像编辑

媒体生成能力

image_edit
sizes
  • 1024x1024
  • 1024x1536
  • 1536x1024
  • 1280x720
  • 720x1280
aspect_ratios
  • 1:1
  • 16:9
  • 9:16
  • 4:3
  • 3:4
max_reference_images
1
defaults
size
1024x1024

价格明细

类型费率
图片$0.0432 每张图片
输入$0.0432 每百万 Tokens
Per image$0.0432 每张图片

Per-image flat fee. Black Forest Labs' published price: FLUX.1 Kontext [pro] $0.04/image (bfl.ai/pricing, FLUX.1 tab, read 2026-07-29).

支持参数

promptsizeimageseedaspect_ratioprompt_upsamplingsafety_tolerance

模型规格

发布日期2025-05-29bfl.ai ↗已核实
可用性仅托管 API(BFL 全球与区域端点;通过 TheRouter 走 SiliconFlow)docs.bfl.ai ↗已核实
推理速度比领先模型(GPT-Image 级别)快达 8 倍;Kontext 系列在 1 MP 下报告 3–5 秒bfl.ai ↗已核实
许可 / 访问仅通过 BFL API 及授权合作伙伴商业使用;无开源权重bfl.ai ↗已核实
训练数据截止未公开披露未知

API 使用示例

所有新集成都应使用下方示例中的全球端点 api.therouter.ai;旧中国加速端点已下线。

建议使用异步 API

图像生成通常需要 30–180 秒,超过同步请求的边缘超时。下方示例已使用 ?async=true + 轮询模式。 查看异步图像生成 / 编辑完整指南 →

cURL
# 1) Submit job (returns 202 immediately with a polling URL).
# Image generation takes 30-180s — always use the async path in production.
JOB=$(curl -s -X POST "https://api.therouter.ai/v1/images/generations?async=true"   -H "Content-Type: application/json"   -H "Authorization: Bearer $THE_ROUTER_API_KEY"   -d '{
    "model": "black-forest-labs/flux-kontext-pro",
    "prompt": "A cinematic product render with soft studio lighting"
  }' | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
echo "submitted: $JOB"

# 2) Poll until terminal (succeeded / failed / cancelled / expired).
while :; do
  R=$(curl -s "https://api.therouter.ai/v1/jobs/$JOB"     -H "Authorization: Bearer $THE_ROUTER_API_KEY")
  S=$(echo "$R" | python3 -c "import sys,json;print(json.load(sys.stdin)['status'])")
  echo "status: $S"
  case "$S" in
    succeeded) echo "$R" | python3 -c "import sys,json;print(json.load(sys.stdin)['unsigned_urls'][0])"; break ;;
    failed|cancelled|expired) echo "$R"; exit 1 ;;
  esac
  sleep 5
done

图像编辑示例

上传一张图片并用文本 prompt 描述编辑要求;模型会返回编辑后的图片(base64)。

cURL
# Same async submit + poll pattern as /v1/images/generations.
JOB=$(curl -s -X POST "https://api.therouter.ai/v1/images/edits?async=true"   -H "Authorization: Bearer $THE_ROUTER_API_KEY"   -F "model=black-forest-labs/flux-kontext-pro"   -F "prompt=Turn this scene into a watercolor painting"   -F "size=1024x1024"   -F "image=@input.png" | python3 -c "import sys,json;print(json.load(sys.stdin)['id'])")
echo "submitted: $JOB"

while :; do
  R=$(curl -s "https://api.therouter.ai/v1/jobs/$JOB"     -H "Authorization: Bearer $THE_ROUTER_API_KEY")
  S=$(echo "$R" | python3 -c "import sys,json;print(json.load(sys.stdin)['status'])")
  echo "status: $S"
  case "$S" in
    succeeded) echo "$R" | python3 -c "import sys,json;print(json.load(sys.stdin)['unsigned_urls'][0])"; break ;;
    failed|cancelled|expired) echo "$R"; exit 1 ;;
  esac
  sleep 5
done

black-forest-labs 其他模型

同类模型

跨供应商的相似能力档位

动态与变更

2025-05-29

Black Forest Labs 发布 FLUX.1 Kontext [pro] 与 [max]

BFL 于 2025 年 5 月底发布 Kontext 系列,推出两款闭源托管模型([pro] 作为生产主力与顶级 [max]),同时开放 [dev] 开源版本的 private beta。[pro] 在 KontextBench 的文字编辑和角色保留任务中排名最高,被定位为快速迭代编辑先锋。

TheRouter 编辑重写bfl.ai ↗

常见问题

我应该在何时选择 [pro] 而非 [max]?

[pro] 是大多数生产编辑工作负载的推荐默认选项:在速度、角色一致性和成本(0.04 美元/图)之间提供最佳平衡。仅当文字质量或绝对 prompt 遵循度是首要考量且预算允许更高单图价格(0.08 美元)时,才选择 [max]。

TheRouter 编辑重写bfl.ai ↗
我可以自托管 FLUX.1 Kontext [pro] 吗?

不可以。[pro] 是闭源且仅托管的模型。唯一开源的 Kontext 版本是 [dev](12B),已在 Hugging Face 上提供,并与现有的 FLUX.1 [dev] 推理栈兼容。

TheRouter 编辑重写bfl.ai ↗
事实档案 — 本页每条断言可在此回溯来源
来源URL采集于
发布日期bfl.ai ↗2026-05-25已核实
可用性docs.bfl.ai ↗2026-05-25已核实
推理速度bfl.ai ↗2026-05-25已核实
许可 / 访问bfl.ai ↗2026-05-25已核实
训练数据截止——未知
Black Forest Labs 发布 FLUX.1 Kontext [pro] 与 [max]bfl.ai ↗2026-05-25已核实
我应该在何时选择 [pro] 而非 [max]?bfl.ai ↗2026-05-25待核实
我可以自托管 FLUX.1 Kontext [pro] 吗?bfl.ai ↗2026-05-25待核实
帮助与联系