Black Forest Labs · 图像

OpenClaw x Flux Kontext

Flux Kontext 是 Black Forest Labs 的上下文感知编辑模型,基于 120 亿参数 Flux 架构。通过 RunAPI,Kontext Pro 和 Max 变体共享一把 key。

2 variants 起价 $0.11 / 次调用 可商用

Prerequisite: npx runapi mcp install

Prompt

Prompt 模型

任务匹配时使用 flux-kontext-max:4K 输出,更强文字渲染,高级上下文编辑。

You have access to RunAPI task tools for Flux Kontext.

Available Flux Kontext models:
- flux-kontext-max: 4K 输出,更强文字渲染,高级上下文编辑
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt
- flux-kontext-pro: 上下文编辑的速度与质量均衡
  endpoints: /api/v1/flux_kontext/text_to_image
  request fields: model, prompt

Use the model ID and endpoint that match the user's request.
Example prompt: 编辑这张产品照片:将背景换成热带海滩,保持产品完全不变。
/api/v1/flux_kontext/text_to_image: Submit the task, poll for its status, then verify the completed output. POST /api/v1/flux_kontext/text_to_image,并保存返回的 Task ID。
GET /api/v1/flux_kontext/text_to_image/<task-id>,直到状态为 completed 或 failed。
确认 completed 响应包含 API 参考中记录的端点专属输出。

公开版本与端点

模型 ID 端点 起步价格 模型目录
flux-kontext-max
/api/v1/flux_kontext/text_to_image
$0.17 / 次调用 模型详情
flux-kontext-pro
/api/v1/flux_kontext/text_to_image
$0.11 / 次调用 模型详情

验证

轮询,直到 Task 进入终态

选择 <model-id> 后生成验证命令。

配置

指南端点: <endpoint>

选择 <model-id> 后,按端点的公开输入契约生成请求。
使用流程

三步开始使用

  1. 选择模型 ID

    选择公开模型 ID,并查看其端点与当前起步价格。

  2. 配置 RunAPI

    调用端点前设置 RUNAPI_API_KEY。

  3. 验证结果

    对于异步端点,轮询同一端点,直到 Task 进入终态。

使用 OpenClaw + Flux Kontext 可以构建什么

  • 换背景但保留主体

    替换商品图或人像的背景,主体位置保持不变,只需一句文字指令,无需蒙版或局部重绘。

  • 更换服装与外观

    在保留面部特征的前提下更换角色的服装、发色或配饰,适合时装样图和角色设计迭代。

  • 替换招牌和标签上的文字

    在提示词中写下新文字,即可替换现有图片中招牌、商品标签或店面上的文字。

为什么通过 RunAPI + OpenClaw 使用 Flux Kontext

  • 2 个变体,一个 API 密钥

    通过一个 RunAPI 连接选择可用的模型变体,无需更改现有集成。

  • 清晰的用量价格

    发送请求前查看目录中的当前价格,无需订阅或最低消费。

  • 自动化任务流程

    通过一致的任务流程提交任务、查询状态并收集异步结果,无需编写手动轮询代码。

OpenClaw + Flux Kontext 常见问题

可以在 OpenClaw 中使用 Flux Kontext 吗?

可以。在 OpenClaw 中把 RunAPI 配置为提供方,然后调用本页列出的 Flux Kontext 端点。聊天用的同一个 RunAPI API 密钥也能用于图片生成和编辑。

Flux Kontext 是异步的吗?

是的。API 会立即返回任务 ID。轮询任务状态或使用回调即可拿到生成完成的图片 URL。

Flux Kontext 能编辑图片里的文字吗?

可以。传入原图并在提示词中描述文字修改,模型会按原位置和原样式渲染新文字。

应该使用哪个模型 ID?

从版本表选择公开模型 ID。每个 ID 可使用的端点均显示在对应行。

本指南会配置聊天模型吗?

不会。该 Model Line 使用页面所示的端点流程,不会被描述为 Agent 聊天模型。

开始在 OpenClaw 中使用 Flux Kontext

需要团队接入支持?

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们