--- title: 透過 RunAPI 在 WorkBuddy 中使用 Hailuo — 影片 MCP 指南 | RunAPI description: 透過 RunAPI MCP server 在 WorkBuddy 中使用 MiniMax Hailuo 生成影片。文字或圖片轉影片、6 種變體、原生 1080p、一組 API key。 url: https://runapi.ai/zh-TW/workbuddy-hailuo.md canonical: https://runapi.ai/zh-TW/workbuddy-hailuo locale: zh-TW site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-hailuo zh-CN: https://runapi.ai/zh-CN/workbuddy-hailuo es: https://runapi.ai/es/workbuddy-hailuo ja: https://runapi.ai/ja/workbuddy-hailuo de: https://runapi.ai/de/workbuddy-hailuo fr: https://runapi.ai/fr/workbuddy-hailuo pt-BR: https://runapi.ai/pt-BR/workbuddy-hailuo ko: https://runapi.ai/ko/workbuddy-hailuo it: https://runapi.ai/it/workbuddy-hailuo nl: https://runapi.ai/nl/workbuddy-hailuo pl: https://runapi.ai/pl/workbuddy-hailuo tr: https://runapi.ai/tr/workbuddy-hailuo zh-TW: https://runapi.ai/zh-TW/workbuddy-hailuo zh-HK: https://runapi.ai/zh-HK/workbuddy-hailuo ar: https://runapi.ai/ar/workbuddy-hailuo x-default: https://runapi.ai/workbuddy-hailuo model: hailuo --- > HTML version: https://runapi.ai/zh-TW/workbuddy-hailuo > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Hailuo。 Hailuo 是 MiniMax 的影片生成模型，可透過 6 種變體生成原生 1080p 影片，並提供準確的物理模擬 — Hailuo 02 和 2.3 各自都有 pro 與 standard 級別的 text-to-video 及 image-to-video endpoint。WorkBuddy 原生支援 MCP — 只要將 RunAPI 新增為 MCP server 一次，要求 workbench agent 製作影片，它便會呼叫 Hailuo 工具並回傳完成的 URL。 - [取得 API Key](https://runapi.ai/zh-TW/login) - [閱讀說明文件](https://runapi.ai/zh-TW/docs/guides) 一個 MCP server · text to video + image to video · 原生 1080p ### 提示詞 ```text Generate a video with MiniMax Hailuo 02 Pro through the runapi MCP server. Requirements: - Use the runapi MCP server's video generation tool. - Set model to "hailuo-02-text-to-video-pro". - Prompt: "A glass marble rolls across a wooden desk, catches the edge, and falls in slow motion. Camera follows the marble. Soft window light, shallow depth of field." - The task is async — wait for it to complete and 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": "hailuo-02-text-to-video-pro", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 三個步驟在 WorkBuddy 中使用 Hailuo 1. **新增 RunAPI MCP server** - 在 WorkBuddy 中註冊名為 runapi、指向 https://runapi.ai/mcp 的 MCP server，並使用 Authorization header 從 RUNAPI_API_KEY 讀取您的 key。如果您已將 RunAPI 連接至 WorkBuddy，同一個 server 已提供 Hailuo 工具 — 無需額外設定。 `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **提示工作台 agent** - 以自然語言描述場景、鏡頭運動與燈光，並指定變體 — hailuo-02-text-to-video-pro 可提供最佳 text-to-video 品質。若要生成以圖片為錨點的影片，請附加或連結來源圖片，agent 會使用搭配 first_frame_image_url 的 image_to_video 變體來保留您的主體。 `Generate a video with hailuo-02-text-to-video-pro: a glass marble rolls across a wooden desk and falls in slow motion, camera following, soft window light. ` 3. **取得影片 URL** - Hailuo 任務為非同步。WorkBuddy 會透過 MCP server 輪詢，直到 status 為 completed，接著將生成的影片 URL 發佈到您的對話中。pro 級別通常可在兩分鐘內完成。 `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Hailuo 工具參數 | 參數 | 類型 | 說明 | | --- | --- | --- | | `model` | `string` | 必填。以下其中一項：hailuo-02-text-to-video-pro、hailuo-02-text-to-video-standard、hailuo-02-image-to-video-pro、hailuo-02-image-to-video-standard、hailuo-2.3-image-to-video-pro、hailuo-2.3-image-to-video-standard。 | | `prompt` | `string` | 必填。影片場景、鏡頭運動及燈光的文字描述。 | | `first_frame_image_url` | `string` | image_to_video 變體必填。作為第一影格使用的來源圖片 URL。 | | `last_frame_image_url` | `string` | 選填。用作最後一幀的圖片 URL。僅適用於 Hailuo 02 image-to-video。 | | `duration_seconds` | `integer` | 選填。影片長度（秒）。可接受值：6 或 10。standard 版預設為 10；pro 版長度固定。 | | `output_resolution` | `string` | 選填。輸出解析度。02 standard 為 512p 或 768p；2.3 變體為 768p 或 1080p。 | ## WorkBuddy 上的 Hailuo 是什麼？ MiniMax 的 Hailuo 是同類中速度最快的影片生成器之一，可生成原生 1080p 影片，具備流暢可信的動態與良好的細節保留。它擅長處理物理模擬 — 物件持續性、運動連貫性與材質互動 — 並透過 Hailuo 2.3 提供專用的動漫與風格化內容模式。WorkBuddy 可透過 runapi MCP server 存取全部 6 種變體；這也是同一個以 RUNAPI_API_KEY 為 workbench 中所有其他模型提供支援的 server。 ## Hailuo 使用情境 - **社群媒體短影音** - 請 WorkBuddy 為 TikTok、Reels 或 YouTube 製作快速影片片段。Hailuo 的快速生成速度，讓您能從 workbench 製作多個變體並挑選最佳版本。 - **說明與行銷影片** - 根據自然語言簡述建立說明影片與行銷短片。Hailuo 可維持主體一致性，並以逼真的光線處理產品特寫。 - **動漫與風格化內容** - 將 Hailuo 2.3 變體用於動漫風格或插畫式影片，其專用渲染模式是其他影片模型未提供的 — 只要在 WorkBuddy 提示中指定變體。 ## Hailuo + WorkBuddy 問題 ### 我可以在 WorkBuddy 中使用 Hailuo 影片生成嗎？ 可以。使用您的 RUNAPI_API_KEY 將 RunAPI 新增為 MCP server，Hailuo 工具便會與其他所有 RunAPI 模型一同出現。請 workbench agent 使用場景描述與變體名稱製作影片，它會為您處理呼叫及非同步輪詢。 ### Hailuo 02 與 Hailuo 2.3 有何差異？ Hailuo 02 支援 text-to-video 和 image-to-video，並提供第一影格及最後影格控制。Hailuo 2.3 僅支援 image-to-video，但新增更佳的身體動作、微表情，以及 02 沒有的專用動漫與插畫渲染風格。WorkBuddy 可依每次請求在兩者間切換。 ### Pro 與 standard 定價有何不同？ Hailuo 02 Pro text-to-video 不論時長，每次生成費用為 57 美分。Standard 採按時長計費 — 6 秒為 30 美分，10 秒為 50 美分。image-to-video standard 定價也會將 output_resolution 納入計算。請查看 RunAPI 定價頁面以取得目前費率。 ### WorkBuddy 會等待影片完成，還是我必須自行輪詢？ 由 workbench agent 處理。Hailuo 任務為非同步 — 工具會回傳 task_id，WorkBuddy 透過 MCP server 輪詢任務，直到 status 為 completed，然後將影片 URL 發佈到您的對話中。典型生成時間為 60–120 秒。 ### Hailuo 的輸出解析度為何？ Hailuo 02 Pro 原生輸出 1080p；standard 版依 output_resolution 參數輸出 512p 或 768p。Hailuo 2.3 變體支援 768p 或 1080p。不進行後製升解析度處理。 - [WorkBuddy 設定指南 →](https://runapi.ai/zh-TW/workbuddy.md) - 尚未連線嗎？請先參閱 WorkBuddy 的 RunAPI MCP 設定指南。 - [RunAPI 上的 Hailuo →](https://runapi.ai/zh-TW/models/hailuo.md) - 查看所有 Hailuo 變體、定價方案及 API 文件。 ## 立即在 WorkBuddy 中試用 Hailuo。 取得免費 RunAPI key，將 MCP server 加入 WorkBuddy，無需離開 workbench 即可開始使用 MiniMax Hailuo 生成原生 1080p 影片。 [瀏覽模型 →](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 Hailuo", "applicationCategory": "DeveloperApplication", "description": "透過 RunAPI MCP server 在 WorkBuddy 中使用 MiniMax Hailuo 生成影片。文字或圖片轉影片、6 種變體、原生 1080p、一組 API key。", "url": "https://runapi.ai/zh-TW/workbuddy-hailuo" }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 Hailuo 影片生成嗎？", "acceptedAnswer": { "@type": "Answer", "text": "可以。使用您的 RUNAPI_API_KEY 將 RunAPI 新增為 MCP server，Hailuo 工具便會與其他所有 RunAPI 模型一同出現。請 workbench agent 使用場景描述與變體名稱製作影片，它會為您處理呼叫及非同步輪詢。" } }, { "@type": "Question", "name": "Hailuo 02 與 Hailuo 2.3 有何差異？", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 支援 text-to-video 和 image-to-video，並提供第一影格及最後影格控制。Hailuo 2.3 僅支援 image-to-video，但新增更佳的身體動作、微表情，以及 02 沒有的專用動漫與插畫渲染風格。WorkBuddy 可依每次請求在兩者間切換。" } }, { "@type": "Question", "name": "Pro 與 standard 定價有何不同？", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 Pro text-to-video 不論時長，每次生成費用為 57 美分。Standard 採按時長計費 — 6 秒為 30 美分，10 秒為 50 美分。image-to-video standard 定價也會將 output_resolution 納入計算。請查看 RunAPI 定價頁面以取得目前費率。" } }, { "@type": "Question", "name": "WorkBuddy 會等待影片完成，還是我必須自行輪詢？", "acceptedAnswer": { "@type": "Answer", "text": "由 workbench agent 處理。Hailuo 任務為非同步 — 工具會回傳 task_id，WorkBuddy 透過 MCP server 輪詢任務，直到 status 為 completed，然後將影片 URL 發佈到您的對話中。典型生成時間為 60–120 秒。" } }, { "@type": "Question", "name": "Hailuo 的輸出解析度為何？", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 Pro 原生輸出 1080p；standard 版依 output_resolution 參數輸出 512p 或 768p。Hailuo 2.3 變體支援 768p 或 1080p。不進行後製升解析度處理。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-TW", "@type": "HowTo", "name": "如何透過 RunAPI 在 WorkBuddy 中使用 Hailuo", "description": "在 WorkBuddy 中將 RunAPI 新增為 MCP server，提示 workbench agent 使用 Hailuo text-to-video 或 image-to-video 變體生成影片，即可收到完成的影片 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "新增 RunAPI MCP server", "text": "在 WorkBuddy 中註冊名為 runapi、指向 https://runapi.ai/mcp 的 MCP server，並使用 Authorization header 從 RUNAPI_API_KEY 讀取您的 key。如果您已將 RunAPI 連接至 WorkBuddy，同一個 server 已提供 Hailuo 工具 — 無需額外設定。", "url": "https://runapi.ai/zh-TW/workbuddy-hailuo#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "提示工作台 agent", "text": "以自然語言描述場景、鏡頭運動與燈光，並指定變體 — hailuo-02-text-to-video-pro 可提供最佳 text-to-video 品質。若要生成以圖片為錨點的影片，請附加或連結來源圖片，agent 會使用搭配 first_frame_image_url 的 image_to_video 變體來保留您的主體。", "url": "https://runapi.ai/zh-TW/workbuddy-hailuo#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "取得影片 URL", "text": "Hailuo 任務為非同步。WorkBuddy 會透過 MCP server 輪詢，直到 status 為 completed，接著將生成的影片 URL 發佈到您的對話中。pro 級別通常可在兩分鐘內完成。", "url": "https://runapi.ai/zh-TW/workbuddy-hailuo#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 Hailuo", "item": "https://runapi.ai/zh-TW/workbuddy-hailuo" } ] } ] ```