--- title: 通过 RunAPI 在 WorkBuddy 中使用 GPT Image — MCP 指南 | RunAPI description: 通过 MCP 在 WorkBuddy 中用 GPT Image 2 生成和编辑图像——文生图、指令式编辑、可设置宽高比和分辨率，一个 RunAPI 密钥即可在工作台内完成。 url: https://runapi.ai/zh-CN/workbuddy-gpt-image.md canonical: https://runapi.ai/zh-CN/workbuddy-gpt-image locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-gpt-image zh-CN: https://runapi.ai/zh-CN/workbuddy-gpt-image es: https://runapi.ai/es/workbuddy-gpt-image ja: https://runapi.ai/ja/workbuddy-gpt-image de: https://runapi.ai/de/workbuddy-gpt-image fr: https://runapi.ai/fr/workbuddy-gpt-image pt-BR: https://runapi.ai/pt-BR/workbuddy-gpt-image ko: https://runapi.ai/ko/workbuddy-gpt-image it: https://runapi.ai/it/workbuddy-gpt-image nl: https://runapi.ai/nl/workbuddy-gpt-image pl: https://runapi.ai/pl/workbuddy-gpt-image tr: https://runapi.ai/tr/workbuddy-gpt-image zh-TW: https://runapi.ai/zh-TW/workbuddy-gpt-image zh-HK: https://runapi.ai/zh-HK/workbuddy-gpt-image ar: https://runapi.ai/ar/workbuddy-gpt-image x-default: https://runapi.ai/workbuddy-gpt-image model: gpt-image --- > HTML version: https://runapi.ai/zh-CN/workbuddy-gpt-image > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 GPT Image GPT Image 2 是 OpenAI 专用的图像生成模型——支持文生图和基于指令的图像编辑，可选择宽高比，输出分辨率最高可达 4K。WorkBuddy 通过与聊天相同的 RunAPI MCP 服务器和 RUNAPI_API_KEY 以工具形式调用它，无需安装任何额外组件。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 文生图 + 图像编辑 · 最高 4K 输出 ### Prompt ```text 使用 runapi MCP 服务器通过 OpenAI GPT Image 2 生成图像。 要求： - 调用 runapi 的 create_task 工具，action 设为 text_to_image。 - 将 model 设为 "gpt-image-2"。 - 编写描述性的提示词。GPT Image 2 会严格遵循自然语言指令——描述布局、风格和文字叠加。 - 可选：将 output_resolution 设为 1k、2k 或 4k。默认为 1k。 - 任务是异步的，用 get_task 轮询直到任务完成，然后报告输出图像 URL。 ``` ### MCP 配置 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### Response ```json { "task_id": "tsk_abc123", "status": "completed", "model": "gpt-image-2", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png", "output_resolution": "2k" } } ``` ## 三步在 WorkBuddy 中使用 GPT Image 1. **添加 RunAPI MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，密钥从 RUNAPI_API_KEY 读取。如果 RunAPI 已接入用于聊天，同一个服务器就会暴露 GPT Image 工具——不需要额外设置。 `url: https://runapi.ai/mcp auth: Bearer $RUNAPI_API_KEY ` 2. **让 WorkBuddy 发起 GPT Image 任务** - 提示工作台智能体调用 runapi 的 create_task 工具，action 设为 text_to_image，model 设为 gpt-image-2，并附上带布局和风格指令的描述性提示词。把 output_resolution 设为 2k 或 4k 可获得更高细节。如需编辑现有图像，让它改用 edit_image 动作，配合 gpt-image-2 并提供 source_image_urls。 `create_task(service="gpt-image-2", action="text_to_image", model="gpt-image-2", prompt="...", output_resolution="2k") ` 3. **获取结果** - 工具调用会立即返回一个 task_id。WorkBuddy 用 get_task 工具轮询，直到状态变为 completed，然后在对话中报告输出图像 URL。 `get_task(task_id="tsk_abc123") ` ## GPT Image 任务参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | gpt-image-2。text_to_image 和 edit_image 动作使用同一个模型 ID。 | | `prompt` | `string` | 必填。所需图像的自然语言描述。支持关于布局、文字叠加和风格的详细指令。 | | `output_resolution` | `string` | 可选。输出分辨率——1k（默认）、2k 或 4k。text_to_image 分辨率越高每张图费用越高；edit_image 在所有分辨率下按同一费率计费。 | | `aspect_ratio` | `string` | 可选。默认为 auto。支持 1:1、3:2、2:3、4:3、3:4、16:9、9:16 等。 | | `source_image_urls` | `array` | edit_image 动作必填。一个或多个待编辑源图像的 URL。 | ## WorkBuddy 上的 GPT Image 是什么？ GPT Image 2 是 OpenAI 专用的图像模型，其工作方式更像一个结构化的设计助手，而不是关键词驱动的生成器。你给它一份制作简报——布局、文字位置、风格约束——它会严格遵循指令。用户反馈其角色一致性强、文本渲染干净、版面可读性好，但经过多轮迭代修改后质量可能下降。WorkBuddy 智能体通过与聊天相同的 RunAPI MCP 服务器以工具形式调用它。 ## GPT Image 使用场景 - **UI 模型与应用线框图** - 根据文字描述生成细节完整的 UI 模型，包括按钮布局、导航栏和文字正确可读的占位内容。 - **文字密集的海报与演示** - 制作精确文字的海报、信息图和演示幻灯片，文字内容在提示词中指定，渲染出的版面干净、可读。 - **角色设定图** - 由一段描述生成带多角度转身视图的角色设定图，在不同角度间保持特征一致。 ## GPT Image + WorkBuddy 常见问题 ### 我能在 WorkBuddy 中使用 GPT Image 2 吗？ 能。WorkBuddy 原生支持 MCP，把 RunAPI 注册为 MCP 服务器后，GPT Image 2 就是一个可用的工具。向工作台智能体发起 model 为 gpt-image-2 的 text_to_image 任务即可——聊天用的同一个 RUNAPI_API_KEY 就够了，无需额外技能或插件。 ### GPT Image 2 和 GPT-4o Image 有什么区别？ GPT Image 2 是 OpenAI 专用的图像生成模型，质量更高，输出最高可达 4K。GPT-4o Image 在聊天上下文中生成图像，但仅限 1:1、3:2 或 2:3 宽高比。两者都可通过 RunAPI 使用——独立生成用 gpt-image-2，聊天集成的图像输出用 gpt-4o-image。 ### GPT Image 2 支持哪些宽高比和分辨率？ aspect_ratio 可设为 auto，或 1:1 到 21:9、9:21 之间的比例；output_resolution 可设为 1k、2k 或 4k，默认 1k。 ### GPT Image 2 在 RunAPI 上如何计费？ GPT Image 2 按图像计费。text_to_image 的费率取决于输出分辨率：1k 最低，2k 居中，4k 最高。edit_image 在所有分辨率下按同一费率计费。当前每张图费率请查看 RunAPI 定价页面。失败的生成不计费。 ### 我能在 WorkBuddy 中用 GPT Image 2 编辑现有图像吗？ 能。让 WorkBuddy 用 model gpt-image-2 发起 edit_image 任务，在 source_image_urls 中传入源图像 URL，并在提示词中描述编辑内容——例如 "change the background to a beach sunset" 或 "add a red hat to the person"。GPT Image 2 会遵循自然语言编辑指令。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未配置？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [GPT Image 模型 →](https://runapi.ai/zh-CN/models/gpt-image.md) - 查看所有 GPT Image 版本、定价和 API 文档。 ## 立即在 WorkBuddy 中试用 GPT Image。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，开始用 OpenAI GPT Image 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 GPT Image", "applicationCategory": "DeveloperApplication", "description": "通过 MCP 在 WorkBuddy 中用 GPT Image 2 生成和编辑图像——文生图、指令式编辑、可设置宽高比和分辨率，一个 RunAPI 密钥即可在工作台内完成。", "url": "https://runapi.ai/zh-CN/workbuddy-gpt-image" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我能在 WorkBuddy 中使用 GPT Image 2 吗？", "acceptedAnswer": { "@type": "Answer", "text": "能。WorkBuddy 原生支持 MCP，把 RunAPI 注册为 MCP 服务器后，GPT Image 2 就是一个可用的工具。向工作台智能体发起 model 为 gpt-image-2 的 text_to_image 任务即可——聊天用的同一个 RUNAPI_API_KEY 就够了，无需额外技能或插件。" } }, { "@type": "Question", "name": "GPT Image 2 和 GPT-4o Image 有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "GPT Image 2 是 OpenAI 专用的图像生成模型，质量更高，输出最高可达 4K。GPT-4o Image 在聊天上下文中生成图像，但仅限 1:1、3:2 或 2:3 宽高比。两者都可通过 RunAPI 使用——独立生成用 gpt-image-2，聊天集成的图像输出用 gpt-4o-image。" } }, { "@type": "Question", "name": "GPT Image 2 支持哪些宽高比和分辨率？", "acceptedAnswer": { "@type": "Answer", "text": "aspect_ratio 可设为 auto，或 1:1 到 21:9、9:21 之间的比例；output_resolution 可设为 1k、2k 或 4k，默认 1k。" } }, { "@type": "Question", "name": "GPT Image 2 在 RunAPI 上如何计费？", "acceptedAnswer": { "@type": "Answer", "text": "GPT Image 2 按图像计费。text_to_image 的费率取决于输出分辨率：1k 最低，2k 居中，4k 最高。edit_image 在所有分辨率下按同一费率计费。当前每张图费率请查看 RunAPI 定价页面。失败的生成不计费。" } }, { "@type": "Question", "name": "我能在 WorkBuddy 中用 GPT Image 2 编辑现有图像吗？", "acceptedAnswer": { "@type": "Answer", "text": "能。让 WorkBuddy 用 model gpt-image-2 发起 edit_image 任务，在 source_image_urls 中传入源图像 URL，并在提示词中描述编辑内容——例如 \"change the background to a beach sunset\" 或 \"add a red hat to the person\"。GPT Image 2 会遵循自然语言编辑指令。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 GPT Image", "description": "在 WorkBuddy 中将 RunAPI 注册为 MCP 服务器，让工作台智能体发起 GPT Image 2 文生图或编辑任务，并轮询任务直到图像就绪。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，密钥从 RUNAPI_API_KEY 读取。如果 RunAPI 已接入用于聊天，同一个服务器就会暴露 GPT Image 工具——不需要额外设置。", "url": "https://runapi.ai/zh-CN/workbuddy-gpt-image#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "让 WorkBuddy 发起 GPT Image 任务", "text": "提示工作台智能体调用 runapi 的 create_task 工具，action 设为 text_to_image，model 设为 gpt-image-2，并附上带布局和风格指令的描述性提示词。把 output_resolution 设为 2k 或 4k 可获得更高细节。如需编辑现有图像，让它改用 edit_image 动作，配合 gpt-image-2 并提供 source_image_urls。", "url": "https://runapi.ai/zh-CN/workbuddy-gpt-image#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "获取结果", "text": "工具调用会立即返回一个 task_id。WorkBuddy 用 get_task 工具轮询，直到状态变为 completed，然后在对话中报告输出图像 URL。", "url": "https://runapi.ai/zh-CN/workbuddy-gpt-image#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 GPT Image", "item": "https://runapi.ai/zh-CN/workbuddy-gpt-image" } ] } ] ```