--- title: Use Flux Kontext in WorkBuddy via RunAPI — MCP Guide | RunAPI description: Generate and edit images with Flux Kontext in WorkBuddy over MCP with RunAPI. One API key, text-guided editing, and character consistency from the workbench. url: https://runapi.ai/workbuddy-flux-kontext.md canonical: https://runapi.ai/workbuddy-flux-kontext locale: en 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/workbuddy-flux-kontext > Site index for agents: https://runapi.ai/llms.txt # Use Flux Kontext in WorkBuddy. Flux Kontext by Black Forest Labs handles text-guided image editing and generation with character consistency. WorkBuddy calls it through the RunAPI MCP server — describe the image or the edit in a prompt, and the workbench agent returns the finished image URL. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one API key · MCP one-click connect · async handled by the server ### 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 config ```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" } } ``` ## Use Flux Kontext 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 the Authorization header reading your key from RUNAPI_API_KEY. If you already connected RunAPI for chat, Flux Kontext is exposed on the same server — no extra setup needed. `url: https://runapi.ai/mcp auth: Bearer ${RUNAPI_API_KEY} ` 2. **Prompt the workbench agent** - Ask WorkBuddy to call the RunAPI text_to_image tool with model set to flux-kontext-pro. Describe the image you want, or pass an image_url plus an editing instruction for in-context editing. `tool: text_to_image · model: flux-kontext-pro` 3. **Get the result** - The MCP server creates the task, tracks it until completion, and hands the finished image URL back to WorkBuddy. The agent shows the URL in the conversation — no manual polling on your side. `task_id: tsk_abc123 → completed` ## Flux Kontext tool parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | Required. flux-kontext-pro or flux-kontext-max. | | `prompt` | `string` | Text instruction for generation or editing. | | `image_url` | `string` | Source image URL for in-context editing. | | `aspect_ratio` | `string` | Optional. Output aspect ratio. | ## What is Flux Kontext on WorkBuddy? Flux Kontext by Black Forest Labs is a continuous image editing model that users say is "better than ChatGPT and Gemini" for precise modifications. You describe what to change in plain text, and it modifies that part while keeping everything else intact — the face stays the same when you swap an outfit, the product stays in position when you replace the background. WorkBuddy reaches it as a tool on the RunAPI MCP server, so edits happen right inside the workbench. ## Flux Kontext use cases - **Background replacement while keeping subjects** - Swap product or portrait backgrounds while the subject stays in the exact same position — no masking, no inpainting, just a text instruction typed into WorkBuddy. - **Clothing and appearance changes** - Change outfits, hair color, or accessories on a character while preserving facial identity, useful for fashion mockups and character design iteration. - **Text replacement on signs and labels** - Replace text on signs, product labels, or storefronts in existing images — type the new text in the prompt and Flux Kontext renders it in place. ## Flux Kontext + WorkBuddy questions ### Can I use Flux Kontext in WorkBuddy? Yes. Add RunAPI as an MCP server in WorkBuddy, then ask the agent to call the text_to_image tool with model set to flux-kontext-pro. The same RUNAPI_API_KEY you use for chat handles image generation. ### Do I need a separate API key for Flux Kontext? No. The same RUNAPI_API_KEY works for all RunAPI models — LLM, image, video, and music. One MCP server, one key, one billing account. ### Who handles the async task polling in WorkBuddy? The RunAPI MCP server does. Flux Kontext tasks are async, but the server tracks each task until it completes and returns the finished image URL to WorkBuddy, so you never poll manually. ### What does Flux Kontext cost? Flux Kontext Pro starts at 5 cents per image. Flux Kontext Max costs more for higher fidelity. Check the RunAPI pricing page for current rates — billing is pay-as-you-go with no subscription. ### Can Flux Kontext edit text directly in images? Yes. Pass the original image as image_url and write something like "change the sign text to OPEN" in the prompt. The model renders the new text in the same position and style as the original, which works well for label and storefront mockups. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not connected yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [Flux Kontext models →](https://runapi.ai/models/flux-kontext.md) - See all Flux Kontext variants, pricing, and API docs. ## Try Flux Kontext in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and start generating and editing images with Flux Kontext. [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 Flux Kontext for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Generate and edit images with Flux Kontext in WorkBuddy over MCP with RunAPI. One API key, text-guided editing, and character consistency from the workbench.", "url": "https://runapi.ai/workbuddy-flux-kontext" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Can I use Flux Kontext in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Add RunAPI as an MCP server in WorkBuddy, then ask the agent to call the text_to_image tool with model set to flux-kontext-pro. The same RUNAPI_API_KEY you use for chat handles image generation." } }, { "@type": "Question", "name": "Do I need a separate API key for Flux Kontext?", "acceptedAnswer": { "@type": "Answer", "text": "No. The same RUNAPI_API_KEY works for all RunAPI models — LLM, image, video, and music. One MCP server, one key, one billing account." } }, { "@type": "Question", "name": "Who handles the async task polling in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "The RunAPI MCP server does. Flux Kontext tasks are async, but the server tracks each task until it completes and returns the finished image URL to WorkBuddy, so you never poll manually." } }, { "@type": "Question", "name": "What does Flux Kontext cost?", "acceptedAnswer": { "@type": "Answer", "text": "Flux Kontext Pro starts at 5 cents per image. Flux Kontext Max costs more for higher fidelity. Check the RunAPI pricing page for current rates — billing is pay-as-you-go with no subscription." } }, { "@type": "Question", "name": "Can Flux Kontext edit text directly in images?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Pass the original image as image_url and write something like \"change the sign text to OPEN\" in the prompt. The model renders the new text in the same position and style as the original, which works well for label and storefront mockups." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use Flux Kontext in WorkBuddy via RunAPI", "description": "Add RunAPI as an MCP server in WorkBuddy, prompt the workbench agent to call the Flux Kontext text_to_image tool, and receive the generated image URL.", "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 the Authorization header reading your key from RUNAPI_API_KEY. If you already connected RunAPI for chat, Flux Kontext is exposed on the same server — no extra setup needed.", "url": "https://runapi.ai/workbuddy-flux-kontext#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Prompt the workbench agent", "text": "Ask WorkBuddy to call the RunAPI text_to_image tool with model set to flux-kontext-pro. Describe the image you want, or pass an image_url plus an editing instruction for in-context editing.", "url": "https://runapi.ai/workbuddy-flux-kontext#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Get the result", "text": "The MCP server creates the task, tracks it until completion, and hands the finished image URL back to WorkBuddy. The agent shows the URL in the conversation — no manual polling on your side.", "url": "https://runapi.ai/workbuddy-flux-kontext#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 Flux Kontext for WorkBuddy", "item": "https://runapi.ai/workbuddy-flux-kontext" } ] } ] ```