--- title: 透過 RunAPI 在 WorkBuddy 使用 GPT Image——MCP 指南 | RunAPI description: 透過 MCP 在 WorkBuddy 使用 GPT Image 2 生成及編輯圖像。文字轉圖像、按指令編輯、可設定長寬比及解析度，一個 RunAPI key。 url: https://runapi.ai/zh-HK/workbuddy-gpt-image.md canonical: https://runapi.ai/zh-HK/workbuddy-gpt-image locale: zh-HK 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-HK/workbuddy-gpt-image > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 使用 GPT Image。 GPT Image 2 是 OpenAI 專用的圖像生成模型——提供文字轉圖像及按指令編輯圖像功能，可選擇長寬比，輸出解析度最高達 4K。WorkBuddy 會將它作為 MCP 工具，在同一個供 chat 使用的 RunAPI server 及 RUNAPI_API_KEY 上呼叫，無需額外安裝任何項目。 - [取得 API Key](https://runapi.ai/zh-HK/login) - [閱讀文件](https://runapi.ai/zh-HK/docs/guides) 一個 MCP server · 文字轉圖像 + 編輯圖像 · 輸出最高 4K ### 提示詞 ```text Use the runapi MCP server to generate an image with OpenAI GPT Image 2. Requirements: - Call the runapi create_task tool with the text_to_image action. - Set the model to "gpt-image-2". - Write a descriptive prompt. GPT Image 2 follows natural language instructions closely — describe layout, style, and text overlays. - Optionally set output_resolution to 1k, 2k, or 4k. Default is 1k. - The task is async. Poll it with get_task until it completes, then report the output image URL. ``` ### MCP 設定 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 回應 ```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 server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並從 RUNAPI_API_KEY 讀取你的金鑰。若 RunAPI 已連接供 chat 使用，同一個 server 已提供 GPT Image 工具——無需額外設定。 `url: https://runapi.ai/mcp auth: Bearer $RUNAPI_API_KEY ` 2. **要求 WorkBuddy 執行 GPT Image task** - 提示工作台 agent 使用 text_to_image action 及模型 gpt-image-2 呼叫 runapi create_task 工具，並加入包含版面及風格指示的描述性 prompt。將 output_resolution 設為 2k 或 4k 以取得更多細節。若要編輯現有圖像，請讓它使用 edit_image action、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 工具輪詢，直至 status 變為 completed，然後在對話中回報輸出圖像 URL。 `get_task(task_id="tsk_abc123") ` ## GPT Image task 參數 | 參數 | 類型 | 說明 | | --- | --- | --- | | `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 action 必填。要編輯的一個或多個來源圖像 URL。 | ## WorkBuddy 上的 GPT Image 是甚麼？ GPT Image 2 是 OpenAI 專用的圖像模型，運作方式更像結構化設計助理，而非由關鍵字驅動的生成器。你可向它提供製作簡報——版面、文字位置、風格限制——它會嚴格遵循指示。用戶反映其角色一致性、文字渲染及版面可讀性表現良好，但經過多次迭代細修後品質可能下降。WorkBuddy agents 會將它作為工具，在同一個供 chat 使用的 RunAPI MCP server 上呼叫。 ## GPT Image 使用場景 - **UI 樣機與應用程式設計線框圖** - 根據文字描述生成詳細的 UI 樣機，包括按鈕佈局、導航欄及正確顯示的佔位內容。 - **文字密集型海報與簡報** - 製作精確文字的海報、資訊圖表及簡報投影片，文字內容在提示詞中指定，並以清晰可讀的佈局渲染。 - **角色設計圖** - 從單一描述生成包含多角度視圖的角色設計圖，在多個角度間保持一致的外觀特徵。 ## GPT Image + WorkBuddy 常見問題 ### 我可以在 WorkBuddy 使用 GPT Image 2 嗎？ 可以。WorkBuddy 原生支援 MCP，因此一旦將 RunAPI 註冊為 MCP server，GPT Image 2 即可作為工具使用。要求工作台 agent 以模型 gpt-image-2 執行 text_to_image task——供 chat 使用的同一個 RUNAPI_API_KEY 已涵蓋此功能，無需額外 skills 或插件。 ### 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 使用模型 gpt-image-2 執行 edit_image 任務。將來源圖片 URL 傳入 source_image_urls，並在 prompt 描述編輯內容——例如「將背景改為海灘日落」或「為人物加上一頂紅帽」。GPT Image 2 能遵從自然語言編輯指示。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未設定？從 WorkBuddy 的 RunAPI MCP 設定指南開始。 - [GPT Image 模型 →](https://runapi.ai/zh-HK/models/gpt-image.md) - 查看所有 GPT Image 版本、定價及 API 文件。 ## 立即在 WorkBuddy 試用 GPT Image。 取得免費 RunAPI key，將 MCP server 加入 WorkBuddy，即可從你的工作台使用 OpenAI GPT Image 2 開始生成及編輯圖片。 [瀏覽模型 →](https://runapi.ai/zh-HK/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-HK/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [x402](https://runapi.ai/zh-HK/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) ### 法律 - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI GPT Image", "applicationCategory": "DeveloperApplication", "description": "透過 MCP 在 WorkBuddy 使用 GPT Image 2 生成及編輯圖像。文字轉圖像、按指令編輯、可設定長寬比及解析度，一個 RunAPI key。", "url": "https://runapi.ai/zh-HK/workbuddy-gpt-image" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以在 WorkBuddy 使用 GPT Image 2 嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。WorkBuddy 原生支援 MCP，因此一旦將 RunAPI 註冊為 MCP server，GPT Image 2 即可作為工具使用。要求工作台 agent 以模型 gpt-image-2 執行 text_to_image task——供 chat 使用的同一個 RUNAPI_API_KEY 已涵蓋此功能，無需額外 skills 或插件。" } }, { "@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 使用模型 gpt-image-2 執行 edit_image 任務。將來源圖片 URL 傳入 source_image_urls，並在 prompt 描述編輯內容——例如「將背景改為海灘日落」或「為人物加上一頂紅帽」。GPT Image 2 能遵從自然語言編輯指示。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 使用 GPT Image", "description": "在 WorkBuddy 註冊 RunAPI 為 MCP server，要求工作台 agent 執行 GPT Image 2 文字轉圖像或編輯 task，並讓它輪詢 task 至圖像準備完成。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP 伺服器", "text": "在 WorkBuddy 註冊一個名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並從 RUNAPI_API_KEY 讀取你的金鑰。若 RunAPI 已連接供 chat 使用，同一個 server 已提供 GPT Image 工具——無需額外設定。", "url": "https://runapi.ai/zh-HK/workbuddy-gpt-image#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "要求 WorkBuddy 執行 GPT Image task", "text": "提示工作台 agent 使用 text_to_image action 及模型 gpt-image-2 呼叫 runapi create_task 工具，並加入包含版面及風格指示的描述性 prompt。將 output_resolution 設為 2k 或 4k 以取得更多細節。若要編輯現有圖像，請讓它使用 edit_image action、gpt-image-2 及 source_image_urls。", "url": "https://runapi.ai/zh-HK/workbuddy-gpt-image#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "取得結果", "text": "工具呼叫會立即回傳 task_id。WorkBuddy 會以 get_task 工具輪詢，直至 status 變為 completed，然後在對話中回報輸出圖像 URL。", "url": "https://runapi.ai/zh-HK/workbuddy-gpt-image#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "主頁", "item": "https://runapi.ai/zh-HK" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI GPT Image", "item": "https://runapi.ai/zh-HK/workbuddy-gpt-image" } ] } ] ```