Black Forest Labs · 图像

Hermes Agent 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 进入终态。

使用 Hermes Agent + Flux Kontext 可以构建什么

  • 多轮编辑工作流

    依次执行多项编辑,例如调整光线、更换背景、添加文字,每一步都基于上一步的结果。

  • 风格转换流水线

    在保留构图的前提下把照片转成油画、素描或动漫风格,为同一内容制作多种风格版本。

  • 天气与光线调整

    修改现有照片的时间段、天气或光线,无需重新生成整个场景。

为什么通过 RunAPI + Hermes Agent 使用 Flux Kontext

  • 2 个变体,一个 API 密钥

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

  • 清晰的用量价格

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

  • 自动化任务流程

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

Hermes Agent + Flux Kontext 常见问题

可以在 Hermes Agent 中使用 Flux Kontext 吗?

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

Hermes Agent 如何执行多步 Flux Kontext 编辑?

Hermes Agent 发送源图和编辑指令,再把每次的输出作为下一次编辑的输入,逐步完善图片。

编辑时如何保持角色身份不变?

传入角色图片,只描述需要改变的部分。Flux Kontext 默认保留面部特征和比例,不需要特殊标记或参考 ID。

应该使用哪个模型 ID?

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

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

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

开始在 Hermes Agent 中使用 Flux Kontext

需要团队接入支持?

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

联系我们