--- title: Use GPT Image in WorkBuddy via RunAPI — MCP Guide | RunAPI description: Generate and edit images with GPT Image 2 in WorkBuddy over MCP. Text-to-image, instruction-based editing, aspect ratio and resolution control, one RunAPI key. url: https://runapi.ai/workbuddy-gpt-image.md canonical: https://runapi.ai/workbuddy-gpt-image locale: en 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/workbuddy-gpt-image > Site index for agents: https://runapi.ai/llms.txt # Use GPT Image in WorkBuddy. GPT Image 2 is OpenAI's dedicated image generation model — text-to-image and instruction-based image editing with selectable aspect ratios and up to 4K output resolution. WorkBuddy calls it as an MCP tool on the same RunAPI server and RUNAPI_API_KEY used for chat, with nothing extra to install. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one MCP server · text to image + edit image · up to 4K output ### Prompt ```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 config ```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" } } ``` ## Use GPT Image in WorkBuddy in three steps 1. **Add the RunAPI MCP server** - Register an MCP server named runapi in WorkBuddy, pointing at https://runapi.ai/mcp over streamable HTTP with your key read from RUNAPI_API_KEY. If RunAPI is already connected for chat, GPT Image tools are exposed by the same server — no additional setup needed. `url: https://runapi.ai/mcp auth: Bearer $RUNAPI_API_KEY ` 2. **Ask WorkBuddy for a GPT Image task** - Prompt the workbench agent to call the runapi create_task tool with the text_to_image action and model gpt-image-2, including a descriptive prompt with layout and style instructions. Set output_resolution to 2k or 4k for higher detail. For editing existing images, have it use the edit_image action with model gpt-image-2 and source_image_urls. `create_task(service="gpt-image-2", action="text_to_image", model="gpt-image-2", prompt="...", output_resolution="2k") ` 3. **Get the result** - The tool call returns a task_id immediately. WorkBuddy polls with the get_task tool until the status changes to completed, then reports the output image URL in the conversation. `get_task(task_id="tsk_abc123") ` ## GPT Image task parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | gpt-image-2. The text_to_image and edit_image actions use the same model ID. | | `prompt` | `string` | Required. Natural language description of the desired image. Supports detailed instructions for layout, text overlays, and style. | | `output_resolution` | `string` | Optional. Output resolution — 1k (default), 2k, or 4k. For text_to_image, higher resolution costs more per image; edit_image bills one rate at every resolution. | | `aspect_ratio` | `string` | Optional. Defaults to auto. Supports 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16, and more. | | `source_image_urls` | `array` | Required for the edit_image action. One or more URLs of source images to edit. | ## What is GPT Image on WorkBuddy? GPT Image 2 is OpenAI's dedicated image model that works more like a structured design assistant than a keyword-driven generator. You give it a production brief — layout, text placement, style constraints — and it follows the instructions closely. Users report strong character consistency, clean text rendering, and readable layouts, though quality can degrade through multiple iterative refinement passes. WorkBuddy agents call it as a tool on the same RunAPI MCP server used for chat. ## GPT Image use cases - **UI mockups and app design wireframes** - Generate detailed UI mockups from written descriptions, including button layouts, navigation bars, and placeholder content that reads correctly. - **Text-heavy posters and presentations** - Create exact-text posters, infographics, and presentation slides where the text content is specified in the prompt and rendered with clean, readable layouts. - **Character design sheets** - Generate character design sheets with turnaround views from a single description, maintaining consistent features across multiple angles. ## GPT Image + WorkBuddy questions ### Can I use GPT Image 2 in WorkBuddy? Yes. WorkBuddy speaks MCP natively, so once RunAPI is registered as an MCP server, GPT Image 2 is available as a tool. Ask the workbench agent for a text_to_image task with model gpt-image-2 — the same RUNAPI_API_KEY used for chat covers it, with no extra skills or plugins. ### What is the difference between GPT Image 2 and GPT-4o Image? GPT Image 2 is OpenAI's dedicated image generation model with higher quality and up to 4K output. GPT-4o Image generates images within a chat context but is limited to 1:1, 3:2, or 2:3 aspect ratios. Both are available through RunAPI — use gpt-image-2 for standalone generation and gpt-4o-image for chat-integrated image output. ### Which aspect ratios and resolutions does GPT Image 2 support? Set aspect_ratio to auto or a ratio from 1:1 to 21:9 or 9:21, and output_resolution to 1k, 2k, or 4k. Resolution defaults to 1k. ### How does GPT Image 2 pricing work on RunAPI? GPT Image 2 is billed per image. For text_to_image, the rate depends on output resolution: 1k is the lowest cost, 2k is mid-range, and 4k is the most expensive. edit_image bills the same per-image rate at every resolution. Check the RunAPI pricing page for current per-image rates. Failed generations are not charged. ### Can I edit an existing image with GPT Image 2 in WorkBuddy? Yes. Ask WorkBuddy to run an edit_image task with model gpt-image-2. Pass the source image URLs in source_image_urls and describe the edit in the prompt — for example, "change the background to a beach sunset" or "add a red hat to the person." GPT Image 2 follows natural language editing instructions. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not configured yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [GPT Image models →](https://runapi.ai/models/gpt-image.md) - See all GPT Image variants, pricing, and API docs. ## Try GPT Image in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and start generating and editing images with OpenAI GPT Image 2 from your workbench. [Browse models →](https://runapi.ai/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/.md) ### Product - [Model Catalog](https://runapi.ai/models.md) - [Pricing](https://runapi.ai/pricing.md) - [Providers](https://runapi.ai/models#all-models) ### Developers - [Documentation](https://runapi.ai/docs/guides) - [SDKs](https://runapi.ai/sdk.md) - [CLI](https://runapi.ai/cli.md) - [MCP Server](https://runapi.ai/mcp.md) - [x402](https://runapi.ai/x402.md) ### Guides - [Claude Code vs Cursor](https://runapi.ai/claude-code-vs-cursor.md) - [Cursor API Setup](https://runapi.ai/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/openrouter-alternative.md) ### Company - [Enterprise](https://runapi.ai/contact.md) - [Contact](https://runapi.ai/contact.md) ### Legal - [Terms](https://runapi.ai/terms.md) - [Privacy](https://runapi.ai/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "en", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/icon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "SoftwareApplication", "name": "RunAPI GPT Image for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Generate and edit images with GPT Image 2 in WorkBuddy over MCP. Text-to-image, instruction-based editing, aspect ratio and resolution control, one RunAPI key.", "url": "https://runapi.ai/workbuddy-gpt-image" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Can I use GPT Image 2 in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. WorkBuddy speaks MCP natively, so once RunAPI is registered as an MCP server, GPT Image 2 is available as a tool. Ask the workbench agent for a text_to_image task with model gpt-image-2 — the same RUNAPI_API_KEY used for chat covers it, with no extra skills or plugins." } }, { "@type": "Question", "name": "What is the difference between GPT Image 2 and GPT-4o Image?", "acceptedAnswer": { "@type": "Answer", "text": "GPT Image 2 is OpenAI's dedicated image generation model with higher quality and up to 4K output. GPT-4o Image generates images within a chat context but is limited to 1:1, 3:2, or 2:3 aspect ratios. Both are available through RunAPI — use gpt-image-2 for standalone generation and gpt-4o-image for chat-integrated image output." } }, { "@type": "Question", "name": "Which aspect ratios and resolutions does GPT Image 2 support?", "acceptedAnswer": { "@type": "Answer", "text": "Set aspect_ratio to auto or a ratio from 1:1 to 21:9 or 9:21, and output_resolution to 1k, 2k, or 4k. Resolution defaults to 1k." } }, { "@type": "Question", "name": "How does GPT Image 2 pricing work on RunAPI?", "acceptedAnswer": { "@type": "Answer", "text": "GPT Image 2 is billed per image. For text_to_image, the rate depends on output resolution: 1k is the lowest cost, 2k is mid-range, and 4k is the most expensive. edit_image bills the same per-image rate at every resolution. Check the RunAPI pricing page for current per-image rates. Failed generations are not charged." } }, { "@type": "Question", "name": "Can I edit an existing image with GPT Image 2 in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Ask WorkBuddy to run an edit_image task with model gpt-image-2. Pass the source image URLs in source_image_urls and describe the edit in the prompt — for example, \"change the background to a beach sunset\" or \"add a red hat to the person.\" GPT Image 2 follows natural language editing instructions." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use GPT Image in WorkBuddy via RunAPI", "description": "Register RunAPI as an MCP server in WorkBuddy, ask the workbench agent for a GPT Image 2 text-to-image or edit task, and let it poll the task until the image is ready.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Add the RunAPI MCP server", "text": "Register an MCP server named runapi in WorkBuddy, pointing at https://runapi.ai/mcp over streamable HTTP with your key read from RUNAPI_API_KEY. If RunAPI is already connected for chat, GPT Image tools are exposed by the same server — no additional setup needed.", "url": "https://runapi.ai/workbuddy-gpt-image#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Ask WorkBuddy for a GPT Image task", "text": "Prompt the workbench agent to call the runapi create_task tool with the text_to_image action and model gpt-image-2, including a descriptive prompt with layout and style instructions. Set output_resolution to 2k or 4k for higher detail. For editing existing images, have it use the edit_image action with model gpt-image-2 and source_image_urls.", "url": "https://runapi.ai/workbuddy-gpt-image#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Get the result", "text": "The tool call returns a task_id immediately. WorkBuddy polls with the get_task tool until the status changes to completed, then reports the output image URL in the conversation.", "url": "https://runapi.ai/workbuddy-gpt-image#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://runapi.ai/" }, { "@type": "ListItem", "position": 2, "name": "RunAPI GPT Image for WorkBuddy", "item": "https://runapi.ai/workbuddy-gpt-image" } ] } ] ```