--- title: 透過 RunAPI 在 WorkBuddy 中使用 Wan — 影片及圖像 MCP 指南 | RunAPI description: 透過 RunAPI MCP 伺服器在 WorkBuddy 中使用阿里巴巴 Wan 生成影片及圖像。文字轉影片、圖片轉影片、語音轉影片，以及 Wan 2.7 圖像生成。 url: https://runapi.ai/zh-HK/workbuddy-wan.md canonical: https://runapi.ai/zh-HK/workbuddy-wan locale: zh-HK 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-HK/workbuddy-wan > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Wan。 Wan 是阿里巴巴的開源影片及圖像生成模型，採用 Apache 2.0 授權，在 Artificial Analysis 文字轉影片排行榜排名第一。涵蓋 Wan 2.2 至 2.7 超過 20 個變體——文字轉影片、圖片轉影片、帶唇形同步的語音轉影片、透過 R2V 進行影片編輯，以及最高 4K 的圖像生成。只需將 RunAPI 新增為 MCP 伺服器一次，所有 Wan endpoint 便成為 WorkBuddy 工作台內可呼叫的工具。 - [取得 API Key](https://runapi.ai/zh-HK/login) - [閱讀文件](https://runapi.ai/zh-HK/docs/guides) 一個 MCP 伺服器 · 20+ 個 Wan 變體 · Apache 2.0 開源 ### 提示詞 ```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" } } } } ``` ### 回應 ```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 伺服器指向 https://runapi.ai/mcp，使用 streamable HTTP，並從 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。Agent 會選取對應的 RunAPI MCP 工具並填入參數。 `"Generate a 1080p video with wan-2.7-text-to-video: ..."` 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 endpoint？ 全部都可以。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 的語音轉影片功能？ 請工作台 Agent 使用 wan-2.2-a14b-speech-to-video-turbo，附上 source_audio_url（音訊檔案）及 source_image_url（要動畫化的人臉）。Wan 生成唇形同步影片，使人臉說出音訊內容。輸出解析度支援 480p、580p 或 720p。 ### Wan 是開源的嗎？我可以自行託管嗎？ 是的。Wan 由阿里巴巴以 Apache 2.0 授權發布，模型權重公開可取得。透過 RunAPI，你可跳過 GPU 設定——WorkBuddy 呼叫一個 MCP 工具即可取得影片或圖像。如需自建私隱管線，相同權重亦可在自有基礎設施上運行。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-HK/workbuddy.md) - 尚未連接？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Wan on RunAPI →](https://runapi.ai/zh-HK/models/wan.md) - 查看所有 20+ 個 Wan 變體、定價方案及 endpoint 文件。 ## 立即在 WorkBuddy 中試用 Wan。 獲取免費 RunAPI 金鑰，將 MCP 伺服器新增至 WorkBuddy，以排名第一的開源模型生成影片——文字轉影片、圖片轉影片或語音轉影片。 [瀏覽模型 →](https://runapi.ai/zh-HK/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-HK/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-HK/models.md) - [收費](https://runapi.ai/zh-HK/pricing.md) - [服務商](https://runapi.ai/zh-HK/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-HK/docs/guides) - [SDK](https://runapi.ai/zh-HK/sdk.md) - [CLI](https://runapi.ai/zh-HK/cli.md) - [MCP Server](https://runapi.ai/zh-HK/mcp.md) - [x402](https://runapi.ai/zh-HK/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-HK/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-HK/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-HK/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-HK/contact.md) - [聯絡](https://runapi.ai/zh-HK/contact.md) ### 法律 - [條款](https://runapi.ai/zh-HK/terms.md) - [私隱](https://runapi.ai/zh-HK/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-HK/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-HK", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-HKicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI Wan", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP 伺服器在 WorkBuddy 中使用阿里巴巴 Wan 生成影片及圖像。文字轉影片、圖片轉影片、語音轉影片，以及 Wan 2.7 圖像生成。", "url": "https://runapi.ai/zh-HK/workbuddy-wan" }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以從 WorkBuddy 呼叫哪些 Wan endpoint？", "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": "請工作台 Agent 使用 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 由阿里巴巴以 Apache 2.0 授權發布，模型權重公開可取得。透過 RunAPI，你可跳過 GPU 設定——WorkBuddy 呼叫一個 MCP 工具即可取得影片或圖像。如需自建私隱管線，相同權重亦可在自有基礎設施上運行。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Wan", "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP 伺服器，提示工作台 Agent，讓它透過 RunAPI 呼叫 Wan 影片及圖像工具。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP 伺服器", "text": "在 WorkBuddy 中將名為 runapi 的 MCP 伺服器指向 https://runapi.ai/mcp，使用 streamable HTTP，並從 RUNAPI_API_KEY 環境變數讀取金鑰。若 RunAPI 已連接用於聊天或圖像，同一伺服器涵蓋所有 20+ 個 Wan 變體——無需額外設定。", "url": "https://runapi.ai/zh-HK/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。Agent 會選取對應的 RunAPI MCP 工具並填入參數。", "url": "https://runapi.ai/zh-HK/workbuddy-wan#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "讓工具返回結果", "text": "RunAPI MCP 工具建立任務，處理非同步輪詢直至狀態為 completed，並將成品影片或圖像 URL 傳回工作台——無需手動查看狀態。", "url": "https://runapi.ai/zh-HK/workbuddy-wan#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-HK", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "主頁", "item": "https://runapi.ai/zh-HK" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Wan", "item": "https://runapi.ai/zh-HK/workbuddy-wan" } ] } ] ```