--- title: Use Topaz in WorkBuddy via RunAPI — Upscaling Guide | RunAPI description: Upscale images with Topaz in WorkBuddy via the RunAPI MCP server. One API key, up to 4x resolution enhancement, async tasks handled by the workbench agent. url: https://runapi.ai/workbuddy-topaz.md canonical: https://runapi.ai/workbuddy-topaz locale: en site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-topaz zh-CN: https://runapi.ai/zh-CN/workbuddy-topaz es: https://runapi.ai/es/workbuddy-topaz ja: https://runapi.ai/ja/workbuddy-topaz de: https://runapi.ai/de/workbuddy-topaz fr: https://runapi.ai/fr/workbuddy-topaz pt-BR: https://runapi.ai/pt-BR/workbuddy-topaz ko: https://runapi.ai/ko/workbuddy-topaz it: https://runapi.ai/it/workbuddy-topaz nl: https://runapi.ai/nl/workbuddy-topaz pl: https://runapi.ai/pl/workbuddy-topaz tr: https://runapi.ai/tr/workbuddy-topaz zh-TW: https://runapi.ai/zh-TW/workbuddy-topaz zh-HK: https://runapi.ai/zh-HK/workbuddy-topaz ar: https://runapi.ai/ar/workbuddy-topaz x-default: https://runapi.ai/workbuddy-topaz model: topaz --- > HTML version: https://runapi.ai/workbuddy-topaz > Site index for agents: https://runapi.ai/llms.txt # Use Topaz in WorkBuddy. Topaz by Topaz Labs upscales images up to 4x resolution using neural networks that recover detail without artifacts. WorkBuddy speaks MCP natively — add RunAPI as an MCP server, hand the agent an image URL and a scale factor, and it returns the enhanced result to the workbench. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one MCP server · one API key · async task handled by the agent ### Prompt ```text Use the runapi MCP server to upscale an image with Topaz. Requirements: - Call the RunAPI upscale tool with model set to "topaz-upscale-image". - Image URL: https://example.com/photo.jpg - Set scale to 4. - Wait until the task completes, then give me the upscaled image URL. ``` ### MCP config ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer ${RUNAPI_API_KEY}" } } } } ``` ### Result ```json { "task_id": "tsk_abc123", "status": "completed", "model": "topaz-upscale-image", "output": { "image_url": "https://runapi.ai/files/tsk_abc123_4x.png" } } ``` ## Use Topaz 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 RunAPI is already connected for chat or image generation, the same server exposes Topaz. `url: https://runapi.ai/mcp` 2. **Prompt the workbench agent** - Paste the prompt into WorkBuddy with the source image_url, model set to topaz-upscale-image, and an optional scale factor of 1, 2, or 4. The agent maps your request onto the RunAPI upscale tool. `model: topaz-upscale-image` 3. **Let the agent return the result** - The tool call creates an async task with status pending. WorkBuddy handles the waiting for you and posts the upscaled image URL back into the conversation once the task completes. `task_id: tsk_abc123` ## Topaz upscale API parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | Required. topaz-upscale-image or topaz-upscale-video. | | `image_url` | `string` | URL of the image to upscale. | | `scale` | `integer` | Optional. Upscale factor: 1, 2, or 4. Default 2. | | `callback_url` | `string` | Optional. Webhook URL for async completion notification. | ## What is Topaz on WorkBuddy? Topaz is the pro-grade image finishing tool that photographers call the "gold standard for photo fidelity." It upscales images up to 4x resolution with crystal-clear results that stay faithful to the original — unlike some upscalers that add AI-generated detail that was not in the source image. On RunAPI it runs as an API-backed MCP tool rather than a desktop app subscription, so the WorkBuddy agent can chain upscaling after any generation step in an automated pipeline. ## Topaz use cases - **Upscaling AI-generated images to print quality** - Take outputs from any generation model on the same MCP server and upscale them to 8K resolution for commercial print licensing, large-format posters, or packaging — all in one WorkBuddy conversation. - **Noise reduction and face restoration** - Clean up noisy low-light photos and restore blurry faces in portraits, recovering detail that was lost to compression or poor capture conditions. - **Batch processing large photo collections** - Ask WorkBuddy to run hundreds of product photos or archival images through upscaling in a single automated pass, with each image processed as its own async task. ## Topaz + WorkBuddy questions ### Can I use Topaz in WorkBuddy? Yes. WorkBuddy speaks MCP natively. Add RunAPI as an MCP server pointing at https://runapi.ai/mcp with your RUNAPI_API_KEY, then ask the agent to call the upscale tool with model set to topaz-upscale-image. ### Do I need a separate API key for Topaz? No. The same RUNAPI_API_KEY behind the runapi MCP server also handles Topaz upscaling. All RunAPI models share one API key and one credits balance. ### Is Topaz upscaling async or sync? Async. The tool call returns a task_id immediately, and the WorkBuddy agent waits on your behalf until the upscaled image is ready, then returns the URL in the conversation — no manual polling. ### What does Topaz upscaling cost? Topaz uses pay-as-you-go per-task pricing through RunAPI. Check the RunAPI pricing page for current rates. There is no monthly subscription or minimum spend — unlike the $199/year Topaz desktop app subscription. ### Does quality degrade on certain image types? Topaz works best on photographic content. Heavily compressed images, very small source files, or images with existing AI artifacts may produce results that look plasticky or over-smoothed at high scale factors. Start with 2x to test quality before committing to 4x on a batch. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not connected yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [Topaz models →](https://runapi.ai/models/topaz.md) - See all Topaz variants, pricing, and API docs. ## Try Topaz in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and start upscaling images with Topaz from the 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 Topaz for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Upscale images with Topaz in WorkBuddy via the RunAPI MCP server. One API key, up to 4x resolution enhancement, async tasks handled by the workbench agent.", "url": "https://runapi.ai/workbuddy-topaz" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Can I use Topaz in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. WorkBuddy speaks MCP natively. Add RunAPI as an MCP server pointing at https://runapi.ai/mcp with your RUNAPI_API_KEY, then ask the agent to call the upscale tool with model set to topaz-upscale-image." } }, { "@type": "Question", "name": "Do I need a separate API key for Topaz?", "acceptedAnswer": { "@type": "Answer", "text": "No. The same RUNAPI_API_KEY behind the runapi MCP server also handles Topaz upscaling. All RunAPI models share one API key and one credits balance." } }, { "@type": "Question", "name": "Is Topaz upscaling async or sync?", "acceptedAnswer": { "@type": "Answer", "text": "Async. The tool call returns a task_id immediately, and the WorkBuddy agent waits on your behalf until the upscaled image is ready, then returns the URL in the conversation — no manual polling." } }, { "@type": "Question", "name": "What does Topaz upscaling cost?", "acceptedAnswer": { "@type": "Answer", "text": "Topaz uses pay-as-you-go per-task pricing through RunAPI. Check the RunAPI pricing page for current rates. There is no monthly subscription or minimum spend — unlike the $199/year Topaz desktop app subscription." } }, { "@type": "Question", "name": "Does quality degrade on certain image types?", "acceptedAnswer": { "@type": "Answer", "text": "Topaz works best on photographic content. Heavily compressed images, very small source files, or images with existing AI artifacts may produce results that look plasticky or over-smoothed at high scale factors. Start with 2x to test quality before committing to 4x on a batch." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use Topaz in WorkBuddy via RunAPI", "description": "Add RunAPI as an MCP server in WorkBuddy and prompt the workbench agent to enhance image resolution with the Topaz upscale tool.", "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 RunAPI is already connected for chat or image generation, the same server exposes Topaz.", "url": "https://runapi.ai/workbuddy-topaz#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Prompt the workbench agent", "text": "Paste the prompt into WorkBuddy with the source image_url, model set to topaz-upscale-image, and an optional scale factor of 1, 2, or 4. The agent maps your request onto the RunAPI upscale tool.", "url": "https://runapi.ai/workbuddy-topaz#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Let the agent return the result", "text": "The tool call creates an async task with status pending. WorkBuddy handles the waiting for you and posts the upscaled image URL back into the conversation once the task completes.", "url": "https://runapi.ai/workbuddy-topaz#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 Topaz for WorkBuddy", "item": "https://runapi.ai/workbuddy-topaz" } ] } ] ```