---
title: 在 WorkBuddy 中通过 RunAPI 使用 Flux Kontext — MCP 指南 | RunAPI
description: 通过 MCP 在 WorkBuddy 中使用 RunAPI 调用 Flux Kontext 生成和编辑图像。一个 API key，文字引导编辑，角色一致性，全程不离开工作台。
url: https://runapi.ai/zh-CN/workbuddy-flux-kontext.md
canonical: https://runapi.ai/zh-CN/workbuddy-flux-kontext
locale: zh-CN
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/workbuddy-flux-kontext
  zh-CN: https://runapi.ai/zh-CN/workbuddy-flux-kontext
  es: https://runapi.ai/es/workbuddy-flux-kontext
  ja: https://runapi.ai/ja/workbuddy-flux-kontext
  de: https://runapi.ai/de/workbuddy-flux-kontext
  fr: https://runapi.ai/fr/workbuddy-flux-kontext
  pt-BR: https://runapi.ai/pt-BR/workbuddy-flux-kontext
  ko: https://runapi.ai/ko/workbuddy-flux-kontext
  it: https://runapi.ai/it/workbuddy-flux-kontext
  nl: https://runapi.ai/nl/workbuddy-flux-kontext
  pl: https://runapi.ai/pl/workbuddy-flux-kontext
  tr: https://runapi.ai/tr/workbuddy-flux-kontext
  zh-TW: https://runapi.ai/zh-TW/workbuddy-flux-kontext
  zh-HK: https://runapi.ai/zh-HK/workbuddy-flux-kontext
  ar: https://runapi.ai/ar/workbuddy-flux-kontext
  x-default: https://runapi.ai/workbuddy-flux-kontext
model: flux-kontext
---

> HTML version: https://runapi.ai/zh-CN/workbuddy-flux-kontext
> Site index for agents: https://runapi.ai/llms.txt


# 在 WorkBuddy 中使用 Flux Kontext

Flux Kontext 由 Black Forest Labs 出品，支持文字引导的图像编辑和生成，并保持角色一致性。WorkBuddy 通过 RunAPI MCP 服务器调用它——用一句 prompt 描述想要的图像或修改，工作台 agent 直接返回成品图像 URL。

- [获取 API Key](https://runapi.ai/zh-CN/login)
- [阅读文档](https://runapi.ai/zh-CN/docs/guides)

一个 API key · MCP 一键接入 · 服务器代管异步任务

### Prompt

```text
Use the runapi MCP server to generate an image with Flux Kontext Pro.

Requirements:
- Call the RunAPI text_to_image tool with model "flux-kontext-pro"
- Prompt: a matte-black water bottle on a beige stone surface, soft side light, studio photography
- Wait for the task to complete and show me the image URL

```

### MCP 配置

```bash
{
  "mcpServers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": {
        "Authorization": "Bearer ${RUNAPI_API_KEY}"
      }
    }
  }
}

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "completed",
  "model": "flux-kontext-pro",
  "output": {
    "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png"
  }
}

```

## 三步在 WorkBuddy 中使用 Flux Kontext

1. **添加 RunAPI MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，地址指向 https://runapi.ai/mcp，使用 streamable HTTP 传输，Authorization 头从 RUNAPI_API_KEY 环境变量读取密钥。如果你已经为聊天接入了 RunAPI，Flux Kontext 就在同一个服务器上，无需额外配置。 `url: https://runapi.ai/mcp
auth: Bearer ${RUNAPI_API_KEY}
`
2. **向工作台 agent 下达 prompt** - 让 WorkBuddy 调用 RunAPI 的 text_to_image 工具，将 model 设为 flux-kontext-pro。描述你想要的图像；如需上下文内编辑，可同时传入 image_url 和一条文字修改指令。 `tool: text_to_image · model: flux-kontext-pro`
3. **获取结果** - MCP 服务器创建任务并跟踪到完成，把成品图像 URL 交回给 WorkBuddy。agent 会直接在对话里展示 URL——你不需要手动轮询。 `task_id: tsk_abc123 → completed`

## Flux Kontext 工具参数

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| `model` | `string` | 必填。flux-kontext-pro 或 flux-kontext-max。 |
| `prompt` | `string` | 用于生成或编辑的文字指令。 |
| `image_url` | `string` | 用于上下文内编辑的源图像 URL。 |
| `aspect_ratio` | `string` | 可选。输出宽高比。 |

## WorkBuddy 上的 Flux Kontext 是什么？

Flux Kontext 由 Black Forest Labs 出品，是一个连续图像编辑模型，用户称其在精准修改方面优于 ChatGPT 和 Gemini。用文字描述需要改动的部分，它只修改那部分，其余保持不变——换装时人脸不变，换背景时产品位置不变。WorkBuddy 把它作为 RunAPI MCP 服务器上的一个工具来调用，编辑全程在工作台内完成。

## Flux Kontext 使用场景

- **保留主体的背景替换** - 在保持被摄对象位置完全不变的前提下替换产品或肖像背景——无需遮罩，无需修复，在 WorkBuddy 里输入一条文字指令即可。
- **服装与外观修改** - 在保留角色面部特征的前提下更换服装、发色或配饰，适用于时尚效果图和角色设计迭代。
- **标牌与标签文字替换** - 替换现有图像中标牌、产品标签或店面上的文字——在提示词中输入新文字，Flux Kontext 即可原位渲染。

## Flux Kontext + WorkBuddy 常见问题

### 可以在 WorkBuddy 中使用 Flux Kontext 吗？

可以。在 WorkBuddy 中添加 RunAPI MCP 服务器，然后让 agent 调用 text_to_image 工具并将 model 设为 flux-kontext-pro。用于聊天的同一个 RUNAPI_API_KEY 也可以处理图像生成。

### Flux Kontext 需要单独的 API key 吗？

不需要。同一个 RUNAPI_API_KEY 适用于所有 RunAPI 模型——LLM、图像、视频和音乐。一个 MCP 服务器，一个 key，一个计费账户。

### 在 WorkBuddy 中异步任务的轮询由谁处理？

由 RunAPI MCP 服务器处理。Flux Kontext 任务是异步的，但服务器会跟踪每个任务直到完成，并把成品图像 URL 返回给 WorkBuddy，你完全不需要手动轮询。

### Flux Kontext 的价格是多少？

Flux Kontext Pro 起价每张 5 美分。Flux Kontext Max 精度更高，价格也更高。查看 RunAPI 定价页面获取最新价格——按量计费，无需订阅。

### Flux Kontext 能直接编辑图像中的文字吗？

可以。将原图作为 image_url 传入，并在提示词中写明修改内容，例如"把招牌文字改成 OPEN"。模型会在原来的位置以原来的风格渲染新文字，非常适合标签和店面效果图。


- [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 还没接入？从 WorkBuddy 的 RunAPI MCP 配置指南开始。
- [Flux Kontext 模型 →](https://runapi.ai/zh-CN/models/flux-kontext.md) - 查看所有 Flux Kontext 变体、价格和 API 文档。

## 立即在 WorkBuddy 中试用 Flux Kontext。

获取免费 RunAPI key，在 WorkBuddy 中添加 MCP 服务器，开始用 Flux Kontext 生成和编辑图像。

[浏览模型 →](https://runapi.ai/zh-CN/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/zh-CN/.md)
### 产品
- [模型目录](https://runapi.ai/zh-CN/models.md)
- [定价](https://runapi.ai/zh-CN/pricing.md)
- [提供方](https://runapi.ai/zh-CN/models#all-models)
### 开发者
- [文档](https://runapi.ai/zh-CN/docs/guides)
- [SDK](https://runapi.ai/zh-CN/sdk.md)
- [CLI](https://runapi.ai/zh-CN/cli.md)
- [MCP Server](https://runapi.ai/zh-CN/mcp.md)
- [x402](https://runapi.ai/zh-CN/x402.md)
### 指南
- [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md)
- [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md)
- [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md)
### 公司
- [企业版](https://runapi.ai/zh-CN/contact.md)
- [联系](https://runapi.ai/zh-CN/contact.md)
### 法律
- [服务条款](https://runapi.ai/zh-CN/terms.md)
- [隐私政策](https://runapi.ai/zh-CN/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/zh-CN",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/zh-CNicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "SoftwareApplication",
    "name": "适用于 WorkBuddy 的 RunAPI Flux Kontext",
    "applicationCategory": "DeveloperApplication",
    "description": "通过 MCP 在 WorkBuddy 中使用 RunAPI 调用 Flux Kontext 生成和编辑图像。一个 API key，文字引导编辑，角色一致性，全程不离开工作台。",
    "url": "https://runapi.ai/zh-CN/workbuddy-flux-kontext"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "可以在 WorkBuddy 中使用 Flux Kontext 吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。在 WorkBuddy 中添加 RunAPI MCP 服务器，然后让 agent 调用 text_to_image 工具并将 model 设为 flux-kontext-pro。用于聊天的同一个 RUNAPI_API_KEY 也可以处理图像生成。"
        }
      },
      {
        "@type": "Question",
        "name": "Flux Kontext 需要单独的 API key 吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "不需要。同一个 RUNAPI_API_KEY 适用于所有 RunAPI 模型——LLM、图像、视频和音乐。一个 MCP 服务器，一个 key，一个计费账户。"
        }
      },
      {
        "@type": "Question",
        "name": "在 WorkBuddy 中异步任务的轮询由谁处理？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "由 RunAPI MCP 服务器处理。Flux Kontext 任务是异步的，但服务器会跟踪每个任务直到完成，并把成品图像 URL 返回给 WorkBuddy，你完全不需要手动轮询。"
        }
      },
      {
        "@type": "Question",
        "name": "Flux Kontext 的价格是多少？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Flux Kontext Pro 起价每张 5 美分。Flux Kontext Max 精度更高，价格也更高。查看 RunAPI 定价页面获取最新价格——按量计费，无需订阅。"
        }
      },
      {
        "@type": "Question",
        "name": "Flux Kontext 能直接编辑图像中的文字吗？",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "可以。将原图作为 image_url 传入，并在提示词中写明修改内容，例如\"把招牌文字改成 OPEN\"。模型会在原来的位置以原来的风格渲染新文字，非常适合标签和店面效果图。"
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "HowTo",
    "name": "如何在 WorkBuddy 中通过 RunAPI 使用 Flux Kontext",
    "description": "在 WorkBuddy 中添加 RunAPI MCP 服务器，让工作台 agent 调用 Flux Kontext 的 text_to_image 工具，并接收生成的图像 URL。",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "添加 RunAPI MCP 服务器",
        "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，地址指向 https://runapi.ai/mcp，使用 streamable HTTP 传输，Authorization 头从 RUNAPI_API_KEY 环境变量读取密钥。如果你已经为聊天接入了 RunAPI，Flux Kontext 就在同一个服务器上，无需额外配置。",
        "url": "https://runapi.ai/zh-CN/workbuddy-flux-kontext#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "向工作台 agent 下达 prompt",
        "text": "让 WorkBuddy 调用 RunAPI 的 text_to_image 工具，将 model 设为 flux-kontext-pro。描述你想要的图像；如需上下文内编辑，可同时传入 image_url 和一条文字修改指令。",
        "url": "https://runapi.ai/zh-CN/workbuddy-flux-kontext#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "获取结果",
        "text": "MCP 服务器创建任务并跟踪到完成，把成品图像 URL 交回给 WorkBuddy。agent 会直接在对话里展示 URL——你不需要手动轮询。",
        "url": "https://runapi.ai/zh-CN/workbuddy-flux-kontext#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "zh-CN",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "首页",
        "item": "https://runapi.ai/zh-CN"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "适用于 WorkBuddy 的 RunAPI Flux Kontext",
        "item": "https://runapi.ai/zh-CN/workbuddy-flux-kontext"
      }
    ]
  }
]
```