--- title: 通过 RunAPI 在 WorkBuddy 中使用 Wan — 视频与图像 MCP 指南 | RunAPI description: 在 WorkBuddy 中通过 RunAPI MCP 服务器使用 Alibaba Wan 生成视频和图像。文生视频、图生视频、语音生视频，以及 Wan 2.7 图像生成。 url: https://runapi.ai/zh-CN/workbuddy-wan.md canonical: https://runapi.ai/zh-CN/workbuddy-wan locale: zh-CN 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/zh-CN/workbuddy-wan > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Wan Wan 是 Alibaba 的开源视频与图像生成模型，采用 Apache 2.0 许可，在 Artificial Analysis 文生视频排行榜上位列第一。它涵盖从 Wan 2.2 到 2.7 的 20 多个版本——文生视频、图生视频、带口型同步的语音生视频、通过 R2V 进行视频编辑，以及最高 4K 的图像生成。把 RunAPI 添加为 MCP 服务器后，每个 Wan 端点都会成为 WorkBuddy 工作台内可直接调用的工具。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 20+ 个 Wan 版本 · Apache 2.0 开源 ### 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 配置 ```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" } } ``` ## 三步在 WorkBuddy 中使用 Wan 1. **添加 RunAPI MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，密钥从 RUNAPI_API_KEY 环境变量读取。如果你已经为聊天或图像连接了 RunAPI，同一个服务器即可覆盖全部 20+ 个 Wan 版本，无需额外配置。 `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **向工作台智能体下达提示词** - 告诉 WorkBuddy 要生成什么、用哪个 Wan 版本——文生视频用 wan-2.7-text-to-video，图生视频用 wan-2.7-image-to-video 并附上 first_frame_image_url，口型同步语音视频用 wan-2.2-a14b-speech-to-video-turbo 并附上 source_audio_url 和 source_image_url。智能体会自动选择对应的 RunAPI MCP 工具并填好参数。 `"用 wan-2.7-text-to-video 生成一段 1080p 视频：……"` 3. **等待工具返回结果** - RunAPI MCP 工具会创建任务、自动轮询直到状态为 completed，并把完成的视频或图像 URL 直接送回工作台——无需手动查询状态。 `status: completed → video_url` ## Wan text_to_video 参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。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 或 wan-2.7-r2v。 | | `prompt` | `string` | 必填。对所需视频场景的文字描述，包括镜头运动、光照和主体细节。 | | `output_resolution` | `string` | 可选。Wan 2.5+ 为 720p 或 1080p。Wan 2.2 还接受 480p 和 580p。默认为 720p。 | | `aspect_ratio` | `string` | 可选。仅适用于 wan-2.7-r2v。可接受值：16:9、9:16、1:1、4:3、3:4。 | | `duration_seconds` | `integer` | 可选。仅适用于 wan-2.7-r2v。视频时长（秒），2 到 10。 | | `seed` | `integer` | 可选。用于确定性输出的可复现种子。 | ## WorkBuddy 上的 Wan 是什么？ Wan 是阿里巴巴推出的开源（Apache 2.0）视频模型，在 Artificial Analysis 文生视频排行榜上位列榜首。它提供首帧和末帧控制用于锚定生成、带角色一致性的多镜头视频，以及包含口型同步语音生视频在内的原生音频支持。通过 runapi MCP 服务器，WorkBuddy 用一个 RUNAPI_API_KEY 即可把全部 20+ 个 Wan 版本作为可调用工具接入工作台。 ## Wan 使用场景 - **分镜转视频工作流** - 使用首帧和末帧锚定，将分镜板画面转化为视频序列。每个片段在你的关键帧上开始和结束，在多镜头项目中保持视觉连续性。 - **虚拟主播与品牌吉祥物** - 通过 Wan 的语音生视频工具，根据人脸图像和音频文件生成说话头像视频。模型处理口型同步和头部运动，产出风格一致的品牌代言人内容。 - **带角色一致性的多镜头序列** - 构建相同角色跨多个片段出现的对话密集或叙事内容。Wan 的时序一致性在镜头间保持面部和服装的稳定。 ## Wan + WorkBuddy 常见问题 ### 我可以从 WorkBuddy 调用哪些 Wan 端点？ 全部都可以。text_to_video、image_to_video、speech_to_video、text_to_image（Wan 2.7 Image）、edit_video 和 animate。runapi MCP 服务器把每个端点都暴露为工具——例如 wan-2.7-text-to-video 用于视频生成，wan-2.7-image 用于最高 4K 的图像生成。 ### 如何把 Wan 接入 WorkBuddy？ 将 RunAPI 添加为名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，密钥放在 RUNAPI_API_KEY 环境变量中。连接后让 WorkBuddy 列出该服务器的工具，所有 Wan 版本——以及 RunAPI 目录中的其他模型——即可直接调用。 ### Wan 2.5、2.6 和 2.7 有什么区别？ Wan 2.5 引入了 1080p 输出。Wan 2.6 增加了视频编辑（R2V）和用于更快生成的 flash 版本。Wan 2.7 新增了图像生成（wan-2.7-image、wan-2.7-image-pro 最高 4K）、视频编辑（wan-2.7-edit-video），以及在 Artificial Analysis 排行榜上领先的更优文生视频质量。 ### 在 WorkBuddy 中如何使用 Wan 的语音生视频？ 让工作台智能体使用 wan-2.2-a14b-speech-to-video-turbo，附上 source_audio_url（音频文件）和 source_image_url（要驱动的人脸）。Wan 会生成一段口型同步的视频，其中人脸说出该音频。输出分辨率支持 480p、580p 或 720p。 ### Wan 是开源的吗？我可以自托管吗？ 可以。Wan 由 Alibaba 以 Apache 2.0 许可发布，模型权重公开可用。通过 RunAPI 你可以跳过 GPU 部署——WorkBuddy 调用一个 MCP 工具即可拿到视频或图像。如果你出于隐私需要自托管管线，相同的权重也能在你自己的基础设施上运行。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 还没连接？从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [RunAPI 上的 Wan →](https://runapi.ai/zh-CN/models/wan.md) - 查看所有 20 多个 Wan 版本、定价层级和端点文档。 ## 立即在 WorkBuddy 中试用 Wan。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，使用排名第一的开源模型生成视频——文生视频、图生视频或语音生视频。 [浏览模型 →](https://runapi.ai/zh-CN/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-CN/.md) ### 产品 - [模型目录](https://runapi.ai/zh-CN/models.md) - [定价](https://runapi.ai/zh-CN/pricing.md) - [提供方](https://runapi.ai/zh-CN/models#all-models) ### 开发者 - [文档](https://runapi.ai/zh-CN/docs/guides) - [SDK](https://runapi.ai/zh-CN/sdk.md) - [CLI](https://runapi.ai/zh-CN/cli.md) - [MCP Server](https://runapi.ai/zh-CN/mcp.md) - [x402](https://runapi.ai/zh-CN/x402.md) ### 指南 - [Claude Code 与 Cursor](https://runapi.ai/zh-CN/claude-code-vs-cursor.md) - [Cursor API 设置](https://runapi.ai/zh-CN/cursor-api-setup.md) - [RunAPI 与 OpenRouter](https://runapi.ai/zh-CN/openrouter-alternative.md) ### 公司 - [企业版](https://runapi.ai/zh-CN/contact.md) - [联系](https://runapi.ai/zh-CN/contact.md) ### 法律 - [服务条款](https://runapi.ai/zh-CN/terms.md) - [隐私政策](https://runapi.ai/zh-CN/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-CN/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-CN", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-CNicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "SoftwareApplication", "name": "适用于 WorkBuddy 的 RunAPI Wan", "applicationCategory": "DeveloperApplication", "description": "在 WorkBuddy 中通过 RunAPI MCP 服务器使用 Alibaba Wan 生成视频和图像。文生视频、图生视频、语音生视频，以及 Wan 2.7 图像生成。", "url": "https://runapi.ai/zh-CN/workbuddy-wan" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以从 WorkBuddy 调用哪些 Wan 端点？", "acceptedAnswer": { "@type": "Answer", "text": "全部都可以。text_to_video、image_to_video、speech_to_video、text_to_image（Wan 2.7 Image）、edit_video 和 animate。runapi MCP 服务器把每个端点都暴露为工具——例如 wan-2.7-text-to-video 用于视频生成，wan-2.7-image 用于最高 4K 的图像生成。" } }, { "@type": "Question", "name": "如何把 Wan 接入 WorkBuddy？", "acceptedAnswer": { "@type": "Answer", "text": "将 RunAPI 添加为名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，密钥放在 RUNAPI_API_KEY 环境变量中。连接后让 WorkBuddy 列出该服务器的工具，所有 Wan 版本——以及 RunAPI 目录中的其他模型——即可直接调用。" } }, { "@type": "Question", "name": "Wan 2.5、2.6 和 2.7 有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "Wan 2.5 引入了 1080p 输出。Wan 2.6 增加了视频编辑（R2V）和用于更快生成的 flash 版本。Wan 2.7 新增了图像生成（wan-2.7-image、wan-2.7-image-pro 最高 4K）、视频编辑（wan-2.7-edit-video），以及在 Artificial Analysis 排行榜上领先的更优文生视频质量。" } }, { "@type": "Question", "name": "在 WorkBuddy 中如何使用 Wan 的语音生视频？", "acceptedAnswer": { "@type": "Answer", "text": "让工作台智能体使用 wan-2.2-a14b-speech-to-video-turbo，附上 source_audio_url（音频文件）和 source_image_url（要驱动的人脸）。Wan 会生成一段口型同步的视频，其中人脸说出该音频。输出分辨率支持 480p、580p 或 720p。" } }, { "@type": "Question", "name": "Wan 是开源的吗？我可以自托管吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。Wan 由 Alibaba 以 Apache 2.0 许可发布，模型权重公开可用。通过 RunAPI 你可以跳过 GPU 部署——WorkBuddy 调用一个 MCP 工具即可拿到视频或图像。如果你出于隐私需要自托管管线，相同的权重也能在你自己的基础设施上运行。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Wan", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，向工作台智能体下达提示词，让它通过 RunAPI 调用 Wan 的视频和图像工具。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，密钥从 RUNAPI_API_KEY 环境变量读取。如果你已经为聊天或图像连接了 RunAPI，同一个服务器即可覆盖全部 20+ 个 Wan 版本，无需额外配置。", "url": "https://runapi.ai/zh-CN/workbuddy-wan#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台智能体下达提示词", "text": "告诉 WorkBuddy 要生成什么、用哪个 Wan 版本——文生视频用 wan-2.7-text-to-video，图生视频用 wan-2.7-image-to-video 并附上 first_frame_image_url，口型同步语音视频用 wan-2.2-a14b-speech-to-video-turbo 并附上 source_audio_url 和 source_image_url。智能体会自动选择对应的 RunAPI MCP 工具并填好参数。", "url": "https://runapi.ai/zh-CN/workbuddy-wan#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "等待工具返回结果", "text": "RunAPI MCP 工具会创建任务、自动轮询直到状态为 completed，并把完成的视频或图像 URL 直接送回工作台——无需手动查询状态。", "url": "https://runapi.ai/zh-CN/workbuddy-wan#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首页", "item": "https://runapi.ai/zh-CN" }, { "@type": "ListItem", "position": 2, "name": "适用于 WorkBuddy 的 RunAPI Wan", "item": "https://runapi.ai/zh-CN/workbuddy-wan" } ] } ] ```