--- title: 通过 RunAPI 在 WorkBuddy 中使用 Hailuo — 视频 MCP 指南 | RunAPI description: 在 WorkBuddy 中通过 RunAPI MCP 服务器使用 MiniMax Hailuo 从文本或图像生成视频。6 个版本、原生 1080p，一个 API 密钥搞定。 url: https://runapi.ai/zh-CN/workbuddy-hailuo.md canonical: https://runapi.ai/zh-CN/workbuddy-hailuo locale: zh-CN 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-CN/workbuddy-hailuo > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Hailuo Hailuo 是 MiniMax 的视频生成模型，可生成原生 1080p 画面并精确模拟物理效果，涵盖 6 个版本 —— Hailuo 02 和 2.3，每个版本都提供 pro 和 standard 层级的文生视频与图生视频端点。WorkBuddy 原生支持 MCP —— 把 RunAPI 添加为 MCP 服务器一次，向工作台智能体要视频，它会调用 Hailuo 工具并把最终的视频 URL 发回给你。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 文生视频 + 图生视频 · 原生 1080p ### Prompt ```text 通过 runapi MCP 服务器用 MiniMax Hailuo 02 Pro 生成一段视频。 要求： - 使用 runapi MCP 服务器的视频生成工具。 - 将 model 设为 "hailuo-02-text-to-video-pro"。 - 提示词："一颗玻璃弹珠滚过木质书桌，碰到桌沿后以慢动作坠落。 镜头跟随弹珠。柔和的窗光，浅景深。" - 任务是异步的 —— 等它完成后把视频 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": "hailuo-02-text-to-video-pro", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 三步在 WorkBuddy 中使用 Hailuo 1. **添加 RunAPI MCP 服务器** - 注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经把 RunAPI 接入了 WorkBuddy，同一个服务器就已经暴露了 Hailuo 工具 —— 无需额外配置。 `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **向工作台智能体发出提示** - 用自然语言描述场景、镜头运动和光照，并指定版本 —— 文生视频质量最佳的是 hailuo-02-text-to-video-pro。如需基于图像锚定视频，附上或链接一张源图像，智能体会改用 image_to_video 版本并通过 first_frame_image_url 保留你的主体。 `用 hailuo-02-text-to-video-pro 生成一段视频： 一颗玻璃弹珠滚过木质书桌，以慢动作坠落， 镜头跟随，柔和的窗光。 ` 3. **接收视频 URL** - Hailuo 任务是异步的。WorkBuddy 会通过 MCP 服务器轮询任务，直到状态为 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 图生视频上可用。 | | `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 服务器即可调用全部 6 个版本，与工作台里其他所有模型共用同一个服务器和 RUNAPI_API_KEY。 ## Hailuo 使用场景 - **社交媒体短视频** - 让 WorkBuddy 为 TikTok、Reels 或 YouTube 快速生成视频片段。Hailuo 的高速生成使你可以在工作台里一次产出多个版本，再从中挑选最佳。 - **解说与营销视频** - 用一句自然语言需求创作解说视频和营销短片。Hailuo 在保持主体一致性和产品特写写实光效方面表现出色。 - **动漫与风格化内容** - 使用 Hailuo 2.3 版本进行动漫风格或插画风格的视频创作，提供其他视频模型所没有的专用渲染模式 —— 在 WorkBuddy 提示词里指定版本名即可。 ## Hailuo + WorkBuddy 常见问题 ### 我可以在 WorkBuddy 中使用 Hailuo 视频生成吗？ 可以。用你的 RUNAPI_API_KEY 把 RunAPI 添加为 MCP 服务器后，Hailuo 工具会和其他 RunAPI 模型一起出现。向工作台智能体描述场景并指定版本名，调用和异步轮询它都会替你完成。 ### Hailuo 02 和 Hailuo 2.3 有什么区别？ Hailuo 02 同时支持文生视频和图生视频，并提供首帧与末帧控制。Hailuo 2.3 仅支持图生视频，但增强了肢体动作和微表情，并新增了 02 所没有的专属动漫与插画渲染风格。WorkBuddy 可以按每次请求灵活切换两者。 ### pro 与 standard 的定价如何运作？ Hailuo 02 Pro 文生视频每次生成收费 57 美分，与时长无关。standard 采用基于时长的定价 —— 6 秒收费 30 美分，10 秒收费 50 美分。图生视频 standard 的定价还会考虑 output_resolution。当前费率请查看 RunAPI 定价页面。 ### WorkBuddy 会等视频生成完吗，还是要我自己轮询？ 工作台智能体会处理好这一切。Hailuo 任务是异步的 —— 工具先返回一个 task_id，WorkBuddy 通过 MCP 服务器轮询任务直到状态为 completed，然后把视频 URL 发到你的对话中。典型生成时间为 60-120 秒。 ### Hailuo 输出什么分辨率？ Hailuo 02 Pro 输出原生 1080p。standard 根据 output_resolution 参数输出 512p 或 768p。Hailuo 2.3 版本支持 768p 或 1080p。不进行后期超分放大。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未接入？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Hailuo 模型 →](https://runapi.ai/zh-CN/models/hailuo.md) - 查看所有 Hailuo 版本、定价层级和 API 文档。 ## 立即在 WorkBuddy 中试用 Hailuo。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，不离开工作台即可用 MiniMax Hailuo 生成原生 1080p 视频。 [浏览模型 →](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 Hailuo", "applicationCategory": "DeveloperApplication", "description": "在 WorkBuddy 中通过 RunAPI MCP 服务器使用 MiniMax Hailuo 从文本或图像生成视频。6 个版本、原生 1080p，一个 API 密钥搞定。", "url": "https://runapi.ai/zh-CN/workbuddy-hailuo" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 Hailuo 视频生成吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。用你的 RUNAPI_API_KEY 把 RunAPI 添加为 MCP 服务器后，Hailuo 工具会和其他 RunAPI 模型一起出现。向工作台智能体描述场景并指定版本名，调用和异步轮询它都会替你完成。" } }, { "@type": "Question", "name": "Hailuo 02 和 Hailuo 2.3 有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 同时支持文生视频和图生视频，并提供首帧与末帧控制。Hailuo 2.3 仅支持图生视频，但增强了肢体动作和微表情，并新增了 02 所没有的专属动漫与插画渲染风格。WorkBuddy 可以按每次请求灵活切换两者。" } }, { "@type": "Question", "name": "pro 与 standard 的定价如何运作？", "acceptedAnswer": { "@type": "Answer", "text": "Hailuo 02 Pro 文生视频每次生成收费 57 美分，与时长无关。standard 采用基于时长的定价 —— 6 秒收费 30 美分，10 秒收费 50 美分。图生视频 standard 的定价还会考虑 output_resolution。当前费率请查看 RunAPI 定价页面。" } }, { "@type": "Question", "name": "WorkBuddy 会等视频生成完吗，还是要我自己轮询？", "acceptedAnswer": { "@type": "Answer", "text": "工作台智能体会处理好这一切。Hailuo 任务是异步的 —— 工具先返回一个 task_id，WorkBuddy 通过 MCP 服务器轮询任务直到状态为 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-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Hailuo", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，向工作台智能体发出提示，用 Hailuo 的文生视频或图生视频版本生成视频，并接收最终的视频 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经把 RunAPI 接入了 WorkBuddy，同一个服务器就已经暴露了 Hailuo 工具 —— 无需额外配置。", "url": "https://runapi.ai/zh-CN/workbuddy-hailuo#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台智能体发出提示", "text": "用自然语言描述场景、镜头运动和光照，并指定版本 —— 文生视频质量最佳的是 hailuo-02-text-to-video-pro。如需基于图像锚定视频，附上或链接一张源图像，智能体会改用 image_to_video 版本并通过 first_frame_image_url 保留你的主体。", "url": "https://runapi.ai/zh-CN/workbuddy-hailuo#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "接收视频 URL", "text": "Hailuo 任务是异步的。WorkBuddy 会通过 MCP 服务器轮询任务，直到状态为 completed，然后把生成的视频 URL 发到你的对话中。pro 层级的典型处理时间在两分钟以内。", "url": "https://runapi.ai/zh-CN/workbuddy-hailuo#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 Hailuo", "item": "https://runapi.ai/zh-CN/workbuddy-hailuo" } ] } ] ```