--- title: 在 WorkBuddy 中通过 RunAPI 使用 Flux 2 — MCP 图像指南 | RunAPI description: 通过 MCP 在 WorkBuddy 中使用 RunAPI 调用 Black Forest Labs 的 Flux 2 生成图像。文生图与多源 remix 工具，全程不离开工作台。 url: https://runapi.ai/zh-CN/workbuddy-flux-2.md canonical: https://runapi.ai/zh-CN/workbuddy-flux-2 locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-flux-2 zh-CN: https://runapi.ai/zh-CN/workbuddy-flux-2 es: https://runapi.ai/es/workbuddy-flux-2 ja: https://runapi.ai/ja/workbuddy-flux-2 de: https://runapi.ai/de/workbuddy-flux-2 fr: https://runapi.ai/fr/workbuddy-flux-2 pt-BR: https://runapi.ai/pt-BR/workbuddy-flux-2 ko: https://runapi.ai/ko/workbuddy-flux-2 it: https://runapi.ai/it/workbuddy-flux-2 nl: https://runapi.ai/nl/workbuddy-flux-2 pl: https://runapi.ai/pl/workbuddy-flux-2 tr: https://runapi.ai/tr/workbuddy-flux-2 zh-TW: https://runapi.ai/zh-TW/workbuddy-flux-2 zh-HK: https://runapi.ai/zh-HK/workbuddy-flux-2 ar: https://runapi.ai/ar/workbuddy-flux-2 x-default: https://runapi.ai/workbuddy-flux-2 model: flux-2 --- > HTML version: https://runapi.ai/zh-CN/workbuddy-flux-2 > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Flux 2 Black Forest Labs 的 Flux 2 提供多个质量版本，覆盖从更快的生成到更高保真度的输出。每个版本都支持文生图和多源 remix，Flux 2 模型目录列出了每个版本支持的分辨率和当前定价。WorkBuddy 把它们作为 RunAPI MCP 服务器上的工具直接在工作台内调用。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 API key · 文生图 + remix 工具 · 1k / 2k 分辨率（Max 仅 1k） ### Prompt ```text Use the runapi MCP server to generate an image with Flux 2 Pro. Requirements: - Call the RunAPI text_to_image tool with model "flux-2-pro-text-to-image" - Prompt: a ceramic vase with dried flowers on a linen tablecloth, natural window light, 35mm film grain - Set aspect_ratio to "3:4" and output_resolution to "2k" - 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-2-pro-text-to-image", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png" } } ``` ## 三步在 WorkBuddy 中使用 Flux 2 1. **添加 RunAPI MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，地址指向 https://runapi.ai/mcp，使用 streamable HTTP 传输，Authorization 头从 RUNAPI_API_KEY 环境变量读取密钥。如果你已经为聊天接入了 RunAPI，Flux 2 就在同一个服务器上，无需额外配置。 `url: https://runapi.ai/mcp auth: Bearer ${RUNAPI_API_KEY} ` 2. **向工作台 agent 下达 prompt** - 让 WorkBuddy 调用 RunAPI 的 text_to_image 工具，将 model 设为 flux-2-pro-text-to-image。附上提示词，并可选设置 aspect_ratio（1:1、4:3、16:9 等）和 output_resolution（1k 或 2k；Flux 2 Max 仅支持 1k）。如需多源 remix，让 agent 改用 remix_image 工具并传入 source_image_urls。 `tool: text_to_image · model: flux-2-pro-text-to-image` 3. **获取结果** - MCP 服务器创建任务并跟踪到完成，把成品图像 URL 交回给 WorkBuddy。agent 会直接在对话里展示 URL——你不需要手动轮询。 `task_id: tsk_abc123 → completed` ## Flux 2 工具参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。对应工具的 Flux 2 模型 ID，例如 flux-2-pro-text-to-image 或 flux-2-pro-remix-image。Flux 2 模型目录列出了所有可用版本。 | | `prompt` | `string` | 待生成图像的文本描述。 | | `aspect_ratio` | `string` | 可选。输出宽高比：1:1、4:3、3:4、16:9、9:16、3:2 或 2:3。remix 工具还接受 auto。 | | `output_resolution` | `string` | 可选。默认 1k。可选值因版本而异，请查看 Flux 2 模型目录。Flex 和 Pro 的 2k 每张图像费用高于 1k。 | | `source_image_urls` | `array` | remix_image 必填。用于混合或转换的源图像 URL 数组。 | | `callback_url` | `string` | 可选。用于异步完成通知的 Webhook URL。 | ## WorkBuddy 上的 Flux 2 是什么？ Flux 2 由 Black Forest Labs 出品，是生产级图像模型，其材质保真度真的可以以假乱真。它支持多参考条件和 400 万像素输出，无需微调即可获得品牌一致的效果。WorkBuddy 把它作为 RunAPI MCP 服务器上的一个工具来调用——在工作台里输入一段文字需求，返回的就是成品图像 URL。 ## Flux 2 使用场景 - **电商产品摄影** - 生成媲美真实棚拍的产品照片和背景替换图，用于目录页和商品列表，省去实体拍摄——所有需求都在 WorkBuddy 里用一句 prompt 发起。 - **多市场广告本地化** - 用同一套提示词结构为 30 多个市场生成本地化广告视觉，替换文字和文化元素的同时保持品牌一致性。 - **杂志封面与编辑类图像** - 制作杂志级封面，文字排版直接渲染在生成图像中，无需事后合成。 ## Flux 2 + WorkBuddy 常见问题 ### Flux 2 的各个版本有什么区别？ 各版本在生成速度、输出保真度和价格上有所不同。每个版本都在同一个 RunAPI MCP 服务器上提供 text_to_image 和 remix_image 工具。Flux 2 模型目录中的版本表列出了每个版本支持的参数和当前价格。 ### Flux 2 图像生成需要单独的 MCP 服务器吗？ 不需要。你为聊天添加的 runapi MCP 服务器已经把 Flux 2 和所有其他 RunAPI 模型作为可调用工具暴露出来。同一个 RUNAPI_API_KEY 覆盖 LLM、图像、视频和音乐请求。 ### Flux 2 的输出分辨率会影响定价吗？ 取决于版本。Flux 2 Flex 和 Flux 2 Pro 按张计费，2k 比 1k 贵。Flux 2 Max 只输出 1k，按单一价格按张计费。请查看 Flux 2 模型目录或 RunAPI 定价页面了解当前费率。 ### Flux 2 与 Flux Kontext 相比如何？ Flux Kontext 专注于文字引导编辑和单张输入图像的角色一致性。Flux 2 专注于文生图生成和多源 remix，提供多个质量版本和可选输出分辨率。两者均出自 Black Forest Labs，都是同一个 RunAPI MCP 服务器上的工具。 ### 在 WorkBuddy 中异步任务的轮询由谁处理？ 由 RunAPI MCP 服务器处理。Flux 2 任务是异步的，但服务器会跟踪每个任务直到完成，并把成品图像 URL 返回给 WorkBuddy，你在工作台里完全不需要手动轮询。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 还没接入？从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Flux 2 模型 →](https://runapi.ai/zh-CN/models/flux-2.md) - 查看所有 Flux 2 版本、定价和 API 文档。 ## 立即在 WorkBuddy 中试用 Flux 2。 免费获取 RunAPI key，在 WorkBuddy 中添加 MCP 服务器，开始使用 Flux 2 生成图像。 [浏览模型 →](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 2", "applicationCategory": "DeveloperApplication", "description": "通过 MCP 在 WorkBuddy 中使用 RunAPI 调用 Black Forest Labs 的 Flux 2 生成图像。文生图与多源 remix 工具，全程不离开工作台。", "url": "https://runapi.ai/zh-CN/workbuddy-flux-2" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Flux 2 的各个版本有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "各版本在生成速度、输出保真度和价格上有所不同。每个版本都在同一个 RunAPI MCP 服务器上提供 text_to_image 和 remix_image 工具。Flux 2 模型目录中的版本表列出了每个版本支持的参数和当前价格。" } }, { "@type": "Question", "name": "Flux 2 图像生成需要单独的 MCP 服务器吗？", "acceptedAnswer": { "@type": "Answer", "text": "不需要。你为聊天添加的 runapi MCP 服务器已经把 Flux 2 和所有其他 RunAPI 模型作为可调用工具暴露出来。同一个 RUNAPI_API_KEY 覆盖 LLM、图像、视频和音乐请求。" } }, { "@type": "Question", "name": "Flux 2 的输出分辨率会影响定价吗？", "acceptedAnswer": { "@type": "Answer", "text": "取决于版本。Flux 2 Flex 和 Flux 2 Pro 按张计费，2k 比 1k 贵。Flux 2 Max 只输出 1k，按单一价格按张计费。请查看 Flux 2 模型目录或 RunAPI 定价页面了解当前费率。" } }, { "@type": "Question", "name": "Flux 2 与 Flux Kontext 相比如何？", "acceptedAnswer": { "@type": "Answer", "text": "Flux Kontext 专注于文字引导编辑和单张输入图像的角色一致性。Flux 2 专注于文生图生成和多源 remix，提供多个质量版本和可选输出分辨率。两者均出自 Black Forest Labs，都是同一个 RunAPI MCP 服务器上的工具。" } }, { "@type": "Question", "name": "在 WorkBuddy 中异步任务的轮询由谁处理？", "acceptedAnswer": { "@type": "Answer", "text": "由 RunAPI MCP 服务器处理。Flux 2 任务是异步的，但服务器会跟踪每个任务直到完成，并把成品图像 URL 返回给 WorkBuddy，你在工作台里完全不需要手动轮询。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何在 WorkBuddy 中通过 RunAPI 使用 Flux 2", "description": "在 WorkBuddy 中添加 RunAPI MCP 服务器，让工作台 agent 调用 Flux 2 的 text_to_image 或 remix_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 2 就在同一个服务器上，无需额外配置。", "url": "https://runapi.ai/zh-CN/workbuddy-flux-2#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台 agent 下达 prompt", "text": "让 WorkBuddy 调用 RunAPI 的 text_to_image 工具，将 model 设为 flux-2-pro-text-to-image。附上提示词，并可选设置 aspect_ratio（1:1、4:3、16:9 等）和 output_resolution（1k 或 2k；Flux 2 Max 仅支持 1k）。如需多源 remix，让 agent 改用 remix_image 工具并传入 source_image_urls。", "url": "https://runapi.ai/zh-CN/workbuddy-flux-2#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "获取结果", "text": "MCP 服务器创建任务并跟踪到完成，把成品图像 URL 交回给 WorkBuddy。agent 会直接在对话里展示 URL——你不需要手动轮询。", "url": "https://runapi.ai/zh-CN/workbuddy-flux-2#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 2", "item": "https://runapi.ai/zh-CN/workbuddy-flux-2" } ] } ] ```