--- title: 透過 RunAPI 在 WorkBuddy 中使用 Wan — 影片與圖片 MCP 指南 | RunAPI description: 透過 RunAPI MCP server 在 WorkBuddy 中使用 Alibaba Wan 生成影片和圖片。text-to-video、image-to-video、speech-to-video，以及 Wan 2.7 圖片生成。 url: https://runapi.ai/zh-TW/workbuddy-wan.md canonical: https://runapi.ai/zh-TW/workbuddy-wan locale: zh-TW 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-TW/workbuddy-wan > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Wan。 Wan 是 Alibaba 的開源影片與圖片生成模型，採用 Apache 2.0 授權，並在 Artificial Analysis text-to-video 排行榜位居第 1。它涵蓋從 Wan 2.2 至 2.7 的 20 多種變體 — text-to-video、image-to-video、具唇形同步的 speech-to-video、透過 R2V 進行影片編輯，以及最高 4K 的圖片生成。只要將 RunAPI 新增為 MCP server 一次，WorkBuddy workbench 內的每個 Wan endpoint 都會成為可呼叫工具。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides) 一個 MCP server · 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 server** - 在 WorkBuddy 中註冊名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並從 RUNAPI_API_KEY 環境變數讀取您的 key。若 RunAPI 已連接用於 chat 或 images，同一個 server 即涵蓋全部 20 多種 Wan 變體 — 無需額外設定。 `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **提示工作台 agent** - 告訴 WorkBuddy 要生成什麼及使用哪種 Wan 變體 — text-to-video 使用 wan-2.7-text-to-video、image-to-video 使用帶有 first_frame_image_url 的 wan-2.7-image-to-video，或使用帶有 source_audio_url 和 source_image_url 的 wan-2.2-a14b-speech-to-video-turbo 製作唇形同步語音影片。agent 會選擇相符的 RunAPI MCP 工具並填入參數。 `"Generate a 1080p video with wan-2.7-text-to-video: ..."` 3. **讓工具傳回結果** - RunAPI MCP 工具會建立任務、處理非同步輪詢直到 status 為 completed，並將完成的影片或圖片 URL 交回 workbench — 無需手動檢查狀態。 `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 是什麼？ Alibaba 的 Wan 是一款開源（Apache 2.0）影片模型，在 Artificial Analysis text-to-video 排行榜名列前茅。它提供第一影格與最後影格控制，讓生成內容固定於 endpoint 錨點；也支援具角色一致性的多鏡頭影片，以及包含唇形同步 speech-to-video 的原生音訊。透過 runapi MCP server，WorkBuddy 只需一組 RUNAPI_API_KEY，即可將全部 20 多種 Wan 變體作為可呼叫工具使用。 ## Wan 使用情境 - **分鏡稿轉影片工作流程** - 利用首幀與末幀錨點將分鏡稿面板轉換為影片序列。每段片段的起點與終點對應您的關鍵幀，確保多鏡頭專案的視覺連貫性。 - **虛擬主持人與品牌吉祥物** - 使用 Wan 的 speech-to-video 工具，根據臉部圖片和音訊檔生成真人講解影片。模型會處理唇形同步和頭部動作，適合一致的品牌代言人內容。 - **具角色一致性的多鏡頭序列** - 製作對話量大或敘事性內容，讓相同角色出現在多段片段中。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 server 將每項功能公開為工具 — 例如使用 wan-2.7-text-to-video 生成影片，以及使用 wan-2.7-image 生成最高 4K 的圖片。 ### 如何將 Wan 連接至 WorkBuddy？ 將 RunAPI 新增為名為 runapi、指向 https://runapi.ai/mcp 的 MCP server，並將您的 key 放在 RUNAPI_API_KEY 環境變數中。連接後，請 WorkBuddy 列出 server 的工具，所有 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 排行榜上領先的文字轉影片品質。 ### Wan 的 speech-to-video 在 WorkBuddy 中如何運作？ 請 workbench agent 使用 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-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [Wan on RunAPI →](https://runapi.ai/zh-TW/models/wan.md) - 查看所有 20+ 種 Wan 變體、定價方案與 endpoint 文件。 ## 立即在 WorkBuddy 中試用 Wan。 取得免費 RunAPI key，將 MCP server 加入 WorkBuddy，並使用排名第 1 的開源模型生成影片 — text-to-video、image-to-video 或 speech-to-video。 [瀏覽模型 →](https://runapi.ai/zh-TW/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/zh-TW/.md) ### 產品 - [模型目錄](https://runapi.ai/zh-TW/models.md) - [價格](https://runapi.ai/zh-TW/pricing.md) - [提供商](https://runapi.ai/zh-TW/models#all-models) ### 開發者 - [文件](https://runapi.ai/zh-TW/docs/guides) - [SDK](https://runapi.ai/zh-TW/sdk.md) - [CLI](https://runapi.ai/zh-TW/cli.md) - [MCP Server](https://runapi.ai/zh-TW/mcp.md) - [x402](https://runapi.ai/zh-TW/x402.md) ### 指南 - [Claude Code 與 Cursor](https://runapi.ai/zh-TW/claude-code-vs-cursor.md) - [Cursor API 設定](https://runapi.ai/zh-TW/cursor-api-setup.md) - [RunAPI 與 OpenRouter](https://runapi.ai/zh-TW/openrouter-alternative.md) ### 公司 - [企業版](https://runapi.ai/zh-TW/contact.md) - [聯絡我們](https://runapi.ai/zh-TW/contact.md) ### 法律 - [服務條款](https://runapi.ai/zh-TW/terms.md) - [隱私權](https://runapi.ai/zh-TW/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/zh-TW/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/zh-TW", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/zh-TWicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "SoftwareApplication", "name": "適用於 WorkBuddy 的 RunAPI Wan", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 在 WorkBuddy 中使用 Alibaba Wan 生成影片和圖片。text-to-video、image-to-video、speech-to-video，以及 Wan 2.7 圖片生成。", "url": "https://runapi.ai/zh-TW/workbuddy-wan" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@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 server 將每項功能公開為工具 — 例如使用 wan-2.7-text-to-video 生成影片，以及使用 wan-2.7-image 生成最高 4K 的圖片。" } }, { "@type": "Question", "name": "如何將 Wan 連接至 WorkBuddy？", "acceptedAnswer": { "@type": "Answer", "text": "將 RunAPI 新增為名為 runapi、指向 https://runapi.ai/mcp 的 MCP server，並將您的 key 放在 RUNAPI_API_KEY 環境變數中。連接後，請 WorkBuddy 列出 server 的工具，所有 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": "Wan 的 speech-to-video 在 WorkBuddy 中如何運作？", "acceptedAnswer": { "@type": "Answer", "text": "請 workbench 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 由 Alibaba 以 Apache 2.0 發布，模型權重可公開取得。透過 RunAPI，您可略過 GPU 設定 — WorkBuddy 呼叫一個 MCP 工具就能取得影片或圖片。若您因隱私需要自架管線，相同權重也可在自己的基礎架構上執行。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Wan", "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP server，提示 workbench agent，讓它透過 RunAPI 呼叫 Wan 影片與圖片工具。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP server", "text": "在 WorkBuddy 中註冊名為 runapi 的 MCP server，透過 streamable HTTP 指向 https://runapi.ai/mcp，並從 RUNAPI_API_KEY 環境變數讀取您的 key。若 RunAPI 已連接用於 chat 或 images，同一個 server 即涵蓋全部 20 多種 Wan 變體 — 無需額外設定。", "url": "https://runapi.ai/zh-TW/workbuddy-wan#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "提示工作台 agent", "text": "告訴 WorkBuddy 要生成什麼及使用哪種 Wan 變體 — text-to-video 使用 wan-2.7-text-to-video、image-to-video 使用帶有 first_frame_image_url 的 wan-2.7-image-to-video，或使用帶有 source_audio_url 和 source_image_url 的 wan-2.2-a14b-speech-to-video-turbo 製作唇形同步語音影片。agent 會選擇相符的 RunAPI MCP 工具並填入參數。", "url": "https://runapi.ai/zh-TW/workbuddy-wan#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "讓工具傳回結果", "text": "RunAPI MCP 工具會建立任務、處理非同步輪詢直到 status 為 completed，並將完成的影片或圖片 URL 交回 workbench — 無需手動檢查狀態。", "url": "https://runapi.ai/zh-TW/workbuddy-wan#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "首頁", "item": "https://runapi.ai/zh-TW" }, { "@type": "ListItem", "position": 2, "name": "適用於 WorkBuddy 的 RunAPI Wan", "item": "https://runapi.ai/zh-TW/workbuddy-wan" } ] } ] ```