--- title: Use Runway in WorkBuddy via RunAPI — Video MCP Guide | RunAPI description: Generate video with Runway Gen-4 in WorkBuddy through the RunAPI MCP server. Text-to-video, 5s or 10s clips, 720p/1080p, one API key. url: https://runapi.ai/workbuddy-runway.md canonical: https://runapi.ai/workbuddy-runway locale: en site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-runway zh-CN: https://runapi.ai/zh-CN/workbuddy-runway es: https://runapi.ai/es/workbuddy-runway ja: https://runapi.ai/ja/workbuddy-runway de: https://runapi.ai/de/workbuddy-runway fr: https://runapi.ai/fr/workbuddy-runway pt-BR: https://runapi.ai/pt-BR/workbuddy-runway ko: https://runapi.ai/ko/workbuddy-runway it: https://runapi.ai/it/workbuddy-runway nl: https://runapi.ai/nl/workbuddy-runway pl: https://runapi.ai/pl/workbuddy-runway tr: https://runapi.ai/tr/workbuddy-runway zh-TW: https://runapi.ai/zh-TW/workbuddy-runway zh-HK: https://runapi.ai/zh-HK/workbuddy-runway ar: https://runapi.ai/ar/workbuddy-runway x-default: https://runapi.ai/workbuddy-runway model: runway --- > HTML version: https://runapi.ai/workbuddy-runway > Site index for agents: https://runapi.ai/llms.txt # Use Runway in WorkBuddy. Runway Gen-4 generates 5-second or 10-second videos at 720p or 1080p from a text prompt or a first-frame image. WorkBuddy speaks MCP natively — add RunAPI as an MCP server once, then ask the workbench agent for a video. It calls the Runway tool, waits for the async task, and drops the finished video URL back into your chat. Extend clips or restyle footage with Runway Aleph the same way. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one MCP server · one RunAPI key · 720p or 1080p output ### Prompt ```text Generate a video with Runway Gen-4 through the runapi MCP server. Requirements: - Use the runapi MCP server's video generation tool. - Set model to "runway". - Prompt: "A drone shot rising over a misty mountain lake at sunrise, cinematic lighting". - Set duration_seconds to 10 and output_resolution to "1080p". - The task is async — wait for it to complete and give me the video 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": "runway", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## Use Runway in WorkBuddy in three steps 1. **Add the RunAPI MCP server** - Register RunAPI as an MCP server named runapi pointing at https://runapi.ai/mcp, with the Authorization header reading your key from RUNAPI_API_KEY. If you already connected RunAPI to WorkBuddy, the same server exposes the Runway tools — no extra setup needed. `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **Prompt the workbench agent** - Ask WorkBuddy for a Runway video in plain language — describe the scene, pick 5 or 10 seconds, and choose 720p or 1080p. The agent maps your request onto the Runway tool exposed by the runapi MCP server, including first_frame_image_url if you attach a reference image. `Generate a 10-second 1080p video with Runway Gen-4: a drone shot rising over a misty mountain lake at sunrise. ` 3. **Receive the video URL** - The Runway task is asynchronous. WorkBuddy polls it through the MCP server until the status is completed, then posts the output video URL into your conversation. To extend the clip, ask the agent to call extend_video with the source_task_id. `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Runway tool parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | Required. Use runway for Gen-4, or runway-aleph for Aleph edit_video. | | `prompt` | `string` | Required. Text description of the video content — camera motion, scene, lighting. | | `duration_seconds` | `integer` | Required. Video length: 5 or 10 seconds. | | `output_resolution` | `string` | Required. Output resolution: 720p or 1080p. Affects pricing. | | `first_frame_image_url` | `string` | Optional. URL of an image to use as the first frame of the video. | | `aspect_ratio` | `string` | Optional. Output aspect ratio: 16:9, 9:16, 1:1, 4:3, or 3:4. | ## What is Runway on WorkBuddy? Runway Gen-4 is known for quick, clean, cinematic output with smooth motion and strong prompt adherence. It generates 5 or 10 second clips at 720p or 1080p from text prompts or reference images, with world consistency that keeps characters and environments stable within a shot. WorkBuddy reaches it through the runapi MCP server — the same server and RUNAPI_API_KEY that power every other model in the workbench. ## Runway use cases - **Intros and B-rolls for creators** - Ask WorkBuddy for polished intro sequences and B-roll footage for YouTube, Instagram, or TikTok content. Runway's cinematic framing produces broadcast-quality clips from a plain-language brief. - **Micro-ads and short reels** - Create 5-second or 10-second ad clips and promotional reels from the workbench. Attach a product image as the first frame and Runway animates it with camera movement and natural lighting. - **Filmmaking pre-visualization** - Generate concept clips for narrative-driven content with consistent characters. Use reference images to lock down character appearance across multiple shots before committing to production. ## Runway + WorkBuddy questions ### Can I use Runway video generation in WorkBuddy? Yes. Add RunAPI as an MCP server with your RUNAPI_API_KEY, and the Runway tools appear alongside every other RunAPI model. Ask the workbench agent for a video with a prompt, duration (5 or 10 seconds), and resolution (720p or 1080p), and it handles the call for you. ### What is the difference between Runway Gen-4 and Runway Aleph? Runway Gen-4 (model: runway) handles text_to_video and extend_video — creating new clips from text or images. Runway Aleph (model: runway-aleph) handles edit_video — restyling existing footage with a text prompt. Both are exposed by the same runapi MCP server, so WorkBuddy can switch between them per request. ### How does Runway pricing work on RunAPI? Runway uses matrix billing based on duration_seconds and output_resolution. A 5-second 720p clip costs less than a 10-second 1080p clip. Check the RunAPI pricing page for current rates. Pay-per-use, no subscription required. ### Does WorkBuddy wait for the video, or do I poll myself? The workbench agent handles it. Runway tasks are asynchronous — the tool returns a task_id, and WorkBuddy polls the task through the MCP server until the status is completed, then posts the video URL into your conversation. You never manage the polling loop yourself. ### Can I extend a Runway video after generating it? Yes. Ask WorkBuddy to extend the clip — the agent calls extend_video with the source_task_id from the original generation and your new prompt. The extension appends to the existing clip, with per-clip pricing based on output_resolution. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not connected yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [Runway on RunAPI →](https://runapi.ai/models/runway.md) - See Runway Gen-4 and Aleph variants, pricing, and API docs. ## Try Runway in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and generate cinematic video with Runway Gen-4 at 720p or 1080p without leaving 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 Runway for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Generate video with Runway Gen-4 in WorkBuddy through the RunAPI MCP server. Text-to-video, 5s or 10s clips, 720p/1080p, one API key.", "url": "https://runapi.ai/workbuddy-runway" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Can I use Runway video generation in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Add RunAPI as an MCP server with your RUNAPI_API_KEY, and the Runway tools appear alongside every other RunAPI model. Ask the workbench agent for a video with a prompt, duration (5 or 10 seconds), and resolution (720p or 1080p), and it handles the call for you." } }, { "@type": "Question", "name": "What is the difference between Runway Gen-4 and Runway Aleph?", "acceptedAnswer": { "@type": "Answer", "text": "Runway Gen-4 (model: runway) handles text_to_video and extend_video — creating new clips from text or images. Runway Aleph (model: runway-aleph) handles edit_video — restyling existing footage with a text prompt. Both are exposed by the same runapi MCP server, so WorkBuddy can switch between them per request." } }, { "@type": "Question", "name": "How does Runway pricing work on RunAPI?", "acceptedAnswer": { "@type": "Answer", "text": "Runway uses matrix billing based on duration_seconds and output_resolution. A 5-second 720p clip costs less than a 10-second 1080p clip. Check the RunAPI pricing page for current rates. Pay-per-use, no subscription required." } }, { "@type": "Question", "name": "Does WorkBuddy wait for the video, or do I poll myself?", "acceptedAnswer": { "@type": "Answer", "text": "The workbench agent handles it. Runway tasks are asynchronous — the tool returns a task_id, and WorkBuddy polls the task through the MCP server until the status is completed, then posts the video URL into your conversation. You never manage the polling loop yourself." } }, { "@type": "Question", "name": "Can I extend a Runway video after generating it?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Ask WorkBuddy to extend the clip — the agent calls extend_video with the source_task_id from the original generation and your new prompt. The extension appends to the existing clip, with per-clip pricing based on output_resolution." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use Runway in WorkBuddy via RunAPI", "description": "Add RunAPI as an MCP server in WorkBuddy, prompt the workbench agent to generate a Runway Gen-4 video with duration and resolution control, and receive the finished video URL.", "step": [ { "@type": "HowToStep", "position": 1, "name": "Add the RunAPI MCP server", "text": "Register RunAPI as an MCP server named runapi pointing at https://runapi.ai/mcp, with the Authorization header reading your key from RUNAPI_API_KEY. If you already connected RunAPI to WorkBuddy, the same server exposes the Runway tools — no extra setup needed.", "url": "https://runapi.ai/workbuddy-runway#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Prompt the workbench agent", "text": "Ask WorkBuddy for a Runway video in plain language — describe the scene, pick 5 or 10 seconds, and choose 720p or 1080p. The agent maps your request onto the Runway tool exposed by the runapi MCP server, including first_frame_image_url if you attach a reference image.", "url": "https://runapi.ai/workbuddy-runway#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Receive the video URL", "text": "The Runway task is asynchronous. WorkBuddy polls it through the MCP server until the status is completed, then posts the output video URL into your conversation. To extend the clip, ask the agent to call extend_video with the source_task_id.", "url": "https://runapi.ai/workbuddy-runway#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 Runway for WorkBuddy", "item": "https://runapi.ai/workbuddy-runway" } ] } ] ```