--- title: Use Grok Imagine in WorkBuddy via RunAPI — MCP Guide | RunAPI description: Generate images and video with Grok Imagine in WorkBuddy through the RunAPI MCP server. One key, text-to-image, image-to-video, and video with synchronized audio. url: https://runapi.ai/workbuddy-grok-imagine.md canonical: https://runapi.ai/workbuddy-grok-imagine locale: en site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-grok-imagine zh-CN: https://runapi.ai/zh-CN/workbuddy-grok-imagine es: https://runapi.ai/es/workbuddy-grok-imagine ja: https://runapi.ai/ja/workbuddy-grok-imagine de: https://runapi.ai/de/workbuddy-grok-imagine fr: https://runapi.ai/fr/workbuddy-grok-imagine pt-BR: https://runapi.ai/pt-BR/workbuddy-grok-imagine ko: https://runapi.ai/ko/workbuddy-grok-imagine it: https://runapi.ai/it/workbuddy-grok-imagine nl: https://runapi.ai/nl/workbuddy-grok-imagine pl: https://runapi.ai/pl/workbuddy-grok-imagine tr: https://runapi.ai/tr/workbuddy-grok-imagine zh-TW: https://runapi.ai/zh-TW/workbuddy-grok-imagine zh-HK: https://runapi.ai/zh-HK/workbuddy-grok-imagine ar: https://runapi.ai/ar/workbuddy-grok-imagine x-default: https://runapi.ai/workbuddy-grok-imagine model: grok-imagine --- > HTML version: https://runapi.ai/workbuddy-grok-imagine > Site index for agents: https://runapi.ai/llms.txt # Use Grok Imagine in WorkBuddy. Grok Imagine is xAI's image and video generation suite — text-to-image, image-to-image, text-to-video, and image-to-video. Add RunAPI as an MCP server in WorkBuddy and the workbench agent calls Grok Imagine as a tool with the same RUNAPI_API_KEY used for everything else — no extra plugins to install. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one MCP server · image and video tools · async handled for you ### Prompt ```text Generate an image with xAI Grok Imagine using the runapi MCP server. Requirements: - Use the RunAPI MCP tool for text-to-image generation. - Set the model to "grok-imagine-text-to-image". - Prompt: "a robot hand placing a chess piece on a board, dramatic side lighting, slow motion feel". - The task is async — wait until it completes, then give me the 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": "grok-imagine-text-to-image", "output": { "image_url": "https://media.runapi.ai/outputs/tsk_abc123.png" } } ``` ## Use Grok Imagine 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 the RUNAPI_API_KEY environment variable. If RunAPI is already connected for chat, the same server exposes Grok Imagine — no additional setup. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **Prompt the workbench agent** - Describe the image you want and name the model grok-imagine-text-to-image. The agent picks the matching RunAPI MCP tool and sends the request. For video, ask for grok-imagine-text-to-video; for image-to-video, add an image_url as the source frame. `"Generate an image with grok-imagine-text-to-image: ..."` 3. **Let the tool return the result** - The RunAPI MCP tool creates the task, waits through the async generation until the status is completed, and hands the finished image or video URL back into the workbench — no manual polling needed. `status: completed → image_url` ## Grok Imagine parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | Required. E.g. grok-imagine-text-to-image, grok-imagine-image-to-video. | | `prompt` | `string` | Text description of the desired output. | | `image_url` | `string` | Source image URL for image-to-image or image-to-video. | | `aspect_ratio` | `string` | Optional. Output aspect ratio, e.g. 16:9, 1:1. | ## What is Grok Imagine on WorkBuddy? Grok Imagine (Aurora) is xAI's image and video generator built into the Grok platform. It produces photorealistic portraits, anime-style illustrations, and short video clips with synchronized audio from text prompts. Through the runapi MCP server, WorkBuddy agents call it for text-to-image, image editing, and video generation without needing a Grok or SuperGrok subscription. ## Grok Imagine use cases - **Photorealistic portrait generation** - Generate high-quality realistic portraits and character images from text descriptions, useful for social media profiles, marketing personas, or creative projects. - **Social media content creation** - Produce images and short video clips for social posts, stories, and ads directly from text prompts, with no watermark on outputs. - **Stylized artwork and anime characters** - Create illustration-style and anime character art from detailed prompts, generating consistent character designs for games, branding, or content series. ## Grok Imagine + WorkBuddy questions ### Can I use Grok Imagine in WorkBuddy? Yes. WorkBuddy speaks MCP natively, so add RunAPI as an MCP server named runapi with your RUNAPI_API_KEY. Then ask the workbench agent for an image or video with a Grok Imagine model slug like grok-imagine-text-to-image, and the tool handles the rest. ### Is Grok Imagine still free, or do I need a paid plan? Through RunAPI, Grok Imagine uses pay-per-task billing — no Grok subscription or SuperGrok plan required. You pay only for completed generations from your RunAPI credit balance. Check the RunAPI pricing page for current rates. ### Can Grok Imagine generate videos with audio? Yes. Grok Imagine supports text-to-video generation with synchronized audio. Ask WorkBuddy to use the grok-imagine-text-to-video model, and the output includes both video and matching audio in a single file. ### Is Grok Imagine asynchronous or synchronous in WorkBuddy? Asynchronous. The task returns a task_id immediately, and the RunAPI MCP tool keeps checking the status until the output is ready — WorkBuddy just receives the finished URL, so you never poll by hand. ### How does Grok Imagine compare to Midjourney and DALL-E for photorealistic images? Grok Imagine produces strong photorealistic results, especially for portraits and character generation. It also supports video output, which Midjourney and DALL-E do not. Quality varies by prompt — test with your specific use case to compare. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not connected yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [Grok Imagine models →](https://runapi.ai/models/grok-imagine.md) - See all Grok Imagine variants, pricing, and API docs. ## Try Grok Imagine in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and start generating images and video with xAI Grok Imagine. [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 Grok Imagine for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Generate images and video with Grok Imagine in WorkBuddy through the RunAPI MCP server. One key, text-to-image, image-to-video, and video with synchronized audio.", "url": "https://runapi.ai/workbuddy-grok-imagine" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Can I use Grok Imagine in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. WorkBuddy speaks MCP natively, so add RunAPI as an MCP server named runapi with your RUNAPI_API_KEY. Then ask the workbench agent for an image or video with a Grok Imagine model slug like grok-imagine-text-to-image, and the tool handles the rest." } }, { "@type": "Question", "name": "Is Grok Imagine still free, or do I need a paid plan?", "acceptedAnswer": { "@type": "Answer", "text": "Through RunAPI, Grok Imagine uses pay-per-task billing — no Grok subscription or SuperGrok plan required. You pay only for completed generations from your RunAPI credit balance. Check the RunAPI pricing page for current rates." } }, { "@type": "Question", "name": "Can Grok Imagine generate videos with audio?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Grok Imagine supports text-to-video generation with synchronized audio. Ask WorkBuddy to use the grok-imagine-text-to-video model, and the output includes both video and matching audio in a single file." } }, { "@type": "Question", "name": "Is Grok Imagine asynchronous or synchronous in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Asynchronous. The task returns a task_id immediately, and the RunAPI MCP tool keeps checking the status until the output is ready — WorkBuddy just receives the finished URL, so you never poll by hand." } }, { "@type": "Question", "name": "How does Grok Imagine compare to Midjourney and DALL-E for photorealistic images?", "acceptedAnswer": { "@type": "Answer", "text": "Grok Imagine produces strong photorealistic results, especially for portraits and character generation. It also supports video output, which Midjourney and DALL-E do not. Quality varies by prompt — test with your specific use case to compare." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use Grok Imagine in WorkBuddy via RunAPI", "description": "Add RunAPI as an MCP server in WorkBuddy and prompt the workbench agent to generate images and video with xAI Grok Imagine through one key.", "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 the RUNAPI_API_KEY environment variable. If RunAPI is already connected for chat, the same server exposes Grok Imagine — no additional setup.", "url": "https://runapi.ai/workbuddy-grok-imagine#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Prompt the workbench agent", "text": "Describe the image you want and name the model grok-imagine-text-to-image. The agent picks the matching RunAPI MCP tool and sends the request. For video, ask for grok-imagine-text-to-video; for image-to-video, add an image_url as the source frame.", "url": "https://runapi.ai/workbuddy-grok-imagine#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Let the tool return the result", "text": "The RunAPI MCP tool creates the task, waits through the async generation until the status is completed, and hands the finished image or video URL back into the workbench — no manual polling needed.", "url": "https://runapi.ai/workbuddy-grok-imagine#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 Grok Imagine for WorkBuddy", "item": "https://runapi.ai/workbuddy-grok-imagine" } ] } ] ```