--- title: Use Wan in WorkBuddy via RunAPI — Video & Image MCP Guide | RunAPI description: Generate video and images with Alibaba Wan in WorkBuddy through the RunAPI MCP server. Text-to-video, image-to-video, speech-to-video, and Wan 2.7 image generation. url: https://runapi.ai/workbuddy-wan.md canonical: https://runapi.ai/workbuddy-wan locale: en site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-wan zh-CN: https://runapi.ai/zh-CN/workbuddy-wan es: https://runapi.ai/es/workbuddy-wan ja: https://runapi.ai/ja/workbuddy-wan de: https://runapi.ai/de/workbuddy-wan fr: https://runapi.ai/fr/workbuddy-wan pt-BR: https://runapi.ai/pt-BR/workbuddy-wan ko: https://runapi.ai/ko/workbuddy-wan it: https://runapi.ai/it/workbuddy-wan nl: https://runapi.ai/nl/workbuddy-wan pl: https://runapi.ai/pl/workbuddy-wan tr: https://runapi.ai/tr/workbuddy-wan zh-TW: https://runapi.ai/zh-TW/workbuddy-wan zh-HK: https://runapi.ai/zh-HK/workbuddy-wan ar: https://runapi.ai/ar/workbuddy-wan x-default: https://runapi.ai/workbuddy-wan model: wan --- > HTML version: https://runapi.ai/workbuddy-wan > Site index for agents: https://runapi.ai/llms.txt # Use Wan in WorkBuddy. Wan is Alibaba's open-source video and image generation model, Apache 2.0 licensed and ranked #1 on the Artificial Analysis text-to-video leaderboard. It spans 20+ variants from Wan 2.2 through 2.7 — text-to-video, image-to-video, speech-to-video with lip-sync, video editing via R2V, and image generation up to 4K. Add RunAPI as an MCP server once and every Wan endpoint becomes a callable tool inside the WorkBuddy workbench. - [Get API Key](https://runapi.ai/login) - [Read the docs](https://runapi.ai/docs/guides) one MCP server · 20+ Wan variants · Apache 2.0 open source ### Prompt ```text Generate a video with Alibaba Wan 2.7 using the runapi MCP server. Requirements: - Use the RunAPI MCP tool for text-to-video generation. - Set model to "wan-2.7-text-to-video". - Set output_resolution to "1080p" for full HD output. - Prompt: "A drone shot rising over terraced rice paddies at golden hour, mist rolling through the valleys, slow upward camera tilt". - The task is async — wait for the tool to report the task as completed, then 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": "wan-2.7-text-to-video", "output": { "video_url": "https://media.runapi.ai/outputs/tsk_abc123.mp4" } } ``` ## Use Wan 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 or images, the same server covers all 20+ Wan variants — no extra setup. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **Prompt the workbench agent** - Tell WorkBuddy what to generate and which Wan variant to use — wan-2.7-text-to-video for text-to-video, wan-2.7-image-to-video with a first_frame_image_url for image-to-video, or wan-2.2-a14b-speech-to-video-turbo with source_audio_url and source_image_url for lip-synced speech video. The agent picks the matching RunAPI MCP tool and fills in the parameters. `"Generate a 1080p video with wan-2.7-text-to-video: ..."` 3. **Let the tool return the result** - The RunAPI MCP tool creates the task, handles the async polling until the status is completed, and hands the finished video or image URL back into the workbench — no manual status checks needed. `status: completed → video_url` ## Wan text_to_video parameters | Parameter | Type | Description | | --- | --- | --- | | `model` | `string` | Required. wan-2.7-text-to-video, wan-2.6-text-to-video, wan-2.5-text-to-video, wan-2.2-a14b-text-to-video-turbo, or wan-2.7-r2v. | | `prompt` | `string` | Required. Text description of the desired video scene, including camera motion, lighting, and subject detail. | | `output_resolution` | `string` | Optional. 720p or 1080p for Wan 2.5+. Wan 2.2 also accepts 480p and 580p. Defaults to 720p. | | `aspect_ratio` | `string` | Optional. For wan-2.7-r2v only. Accepted values: 16:9, 9:16, 1:1, 4:3, 3:4. | | `duration_seconds` | `integer` | Optional. For wan-2.7-r2v only. Video length in seconds, 2 to 10. | | `seed` | `integer` | Optional. Reproducibility seed for deterministic output. | ## What is Wan on WorkBuddy? Wan by Alibaba is an open-source (Apache 2.0) video model ranked at the top of the Artificial Analysis text-to-video leaderboard. It offers first-frame and last-frame control for endpoint-anchored generation, multi-shot video with character consistency, and native audio including lip-synced speech-to-video. Through the runapi MCP server, WorkBuddy reaches all 20+ Wan variants as callable tools with a single RUNAPI_API_KEY. ## Wan use cases - **Storyboard-to-video workflow** - Use first-frame and last-frame anchoring to turn storyboard panels into video sequences. Each clip starts and ends on your keyframes, maintaining visual continuity across a multi-shot project. - **Virtual presenters and brand mascots** - Generate talking-head video from a face image and audio file using Wan's speech-to-video tool. The model handles lip sync and head movement for consistent brand spokesperson content. - **Multi-shot sequences with character consistency** - Build dialogue-heavy or narrative content where the same character appears across multiple clips. Wan's temporal consistency keeps faces and outfits stable between shots. ## Wan + WorkBuddy questions ### Which Wan endpoints can I call from WorkBuddy? All of them. text_to_video, image_to_video, speech_to_video, text_to_image (Wan 2.7 Image), edit_video, and animate. The runapi MCP server exposes each as a tool — for example wan-2.7-text-to-video for video generation and wan-2.7-image for image generation up to 4K. ### How do I connect Wan to WorkBuddy? Add RunAPI as an MCP server named runapi pointing at https://runapi.ai/mcp, with your key in the RUNAPI_API_KEY environment variable. Once connected, ask WorkBuddy to list the server's tools and every Wan variant — plus the rest of the RunAPI catalog — is ready to call. ### What is the difference between Wan 2.5, 2.6, and 2.7? Wan 2.5 introduced 1080p output. Wan 2.6 added video editing (R2V) and flash variants for faster generation. Wan 2.7 adds image generation (wan-2.7-image, wan-2.7-image-pro up to 4K), video editing (wan-2.7-edit-video), and improved text-to-video quality that leads the Artificial Analysis leaderboard. ### How does speech-to-video work with Wan in WorkBuddy? Ask the workbench agent to use wan-2.2-a14b-speech-to-video-turbo with source_audio_url (the audio file) and source_image_url (the face to animate). Wan generates a lip-synced video where the face speaks the audio. Output resolution supports 480p, 580p, or 720p. ### Is Wan open-source? Can I self-host it? Yes. Wan is released under Apache 2.0 by Alibaba and the model weights are publicly available. Through RunAPI you skip the GPU setup — WorkBuddy calls one MCP tool and gets the video or image back. If you need a self-hosted pipeline for privacy, the same weights run on your own infrastructure. - [WorkBuddy setup guide →](https://runapi.ai/workbuddy.md) - Not connected yet? Start with the RunAPI MCP setup guide for WorkBuddy. - [Wan on RunAPI →](https://runapi.ai/models/wan.md) - See all 20+ Wan variants, pricing tiers, and endpoint docs. ## Try Wan in WorkBuddy today. Get a free RunAPI key, add the MCP server to WorkBuddy, and generate video with the #1 ranked open-source model — text-to-video, image-to-video, or speech-to-video. [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 Wan for WorkBuddy", "applicationCategory": "DeveloperApplication", "description": "Generate video and images with Alibaba Wan in WorkBuddy through the RunAPI MCP server. Text-to-video, image-to-video, speech-to-video, and Wan 2.7 image generation.", "url": "https://runapi.ai/workbuddy-wan" }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Which Wan endpoints can I call from WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "All of them. text_to_video, image_to_video, speech_to_video, text_to_image (Wan 2.7 Image), edit_video, and animate. The runapi MCP server exposes each as a tool — for example wan-2.7-text-to-video for video generation and wan-2.7-image for image generation up to 4K." } }, { "@type": "Question", "name": "How do I connect Wan to WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Add RunAPI as an MCP server named runapi pointing at https://runapi.ai/mcp, with your key in the RUNAPI_API_KEY environment variable. Once connected, ask WorkBuddy to list the server's tools and every Wan variant — plus the rest of the RunAPI catalog — is ready to call." } }, { "@type": "Question", "name": "What is the difference between Wan 2.5, 2.6, and 2.7?", "acceptedAnswer": { "@type": "Answer", "text": "Wan 2.5 introduced 1080p output. Wan 2.6 added video editing (R2V) and flash variants for faster generation. Wan 2.7 adds image generation (wan-2.7-image, wan-2.7-image-pro up to 4K), video editing (wan-2.7-edit-video), and improved text-to-video quality that leads the Artificial Analysis leaderboard." } }, { "@type": "Question", "name": "How does speech-to-video work with Wan in WorkBuddy?", "acceptedAnswer": { "@type": "Answer", "text": "Ask the workbench agent to use wan-2.2-a14b-speech-to-video-turbo with source_audio_url (the audio file) and source_image_url (the face to animate). Wan generates a lip-synced video where the face speaks the audio. Output resolution supports 480p, 580p, or 720p." } }, { "@type": "Question", "name": "Is Wan open-source? Can I self-host it?", "acceptedAnswer": { "@type": "Answer", "text": "Yes. Wan is released under Apache 2.0 by Alibaba and the model weights are publicly available. Through RunAPI you skip the GPU setup — WorkBuddy calls one MCP tool and gets the video or image back. If you need a self-hosted pipeline for privacy, the same weights run on your own infrastructure." } } ] }, { "@context": "https://schema.org", "inLanguage": "en", "@type": "HowTo", "name": "How to use Wan in WorkBuddy via RunAPI", "description": "Add RunAPI as an MCP server in WorkBuddy, prompt the workbench agent, and let it call the Wan video and image tools through RunAPI.", "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 or images, the same server covers all 20+ Wan variants — no extra setup.", "url": "https://runapi.ai/workbuddy-wan#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "Prompt the workbench agent", "text": "Tell WorkBuddy what to generate and which Wan variant to use — wan-2.7-text-to-video for text-to-video, wan-2.7-image-to-video with a first_frame_image_url for image-to-video, or wan-2.2-a14b-speech-to-video-turbo with source_audio_url and source_image_url for lip-synced speech video. The agent picks the matching RunAPI MCP tool and fills in the parameters.", "url": "https://runapi.ai/workbuddy-wan#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "Let the tool return the result", "text": "The RunAPI MCP tool creates the task, handles the async polling until the status is completed, and hands the finished video or image URL back into the workbench — no manual status checks needed.", "url": "https://runapi.ai/workbuddy-wan#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 Wan for WorkBuddy", "item": "https://runapi.ai/workbuddy-wan" } ] } ] ```