--- title: 通过 RunAPI 在 WorkBuddy 中使用 Runway — 视频 MCP 指南 | RunAPI description: 在 WorkBuddy 中通过 RunAPI MCP 服务器使用 Runway Gen-4 生成视频。文生视频、5 秒或 10 秒片段、720p/1080p，一个 API 密钥搞定。 url: https://runapi.ai/zh-CN/workbuddy-runway.md canonical: https://runapi.ai/zh-CN/workbuddy-runway locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-runway zh-CN: https://runapi.ai/zh-CN/workbuddy-runway es: https://runapi.ai/es/workbuddy-runway ja: https://runapi.ai/ja/workbuddy-runway de: https://runapi.ai/de/workbuddy-runway fr: https://runapi.ai/fr/workbuddy-runway pt-BR: https://runapi.ai/pt-BR/workbuddy-runway ko: https://runapi.ai/ko/workbuddy-runway it: https://runapi.ai/it/workbuddy-runway nl: https://runapi.ai/nl/workbuddy-runway pl: https://runapi.ai/pl/workbuddy-runway tr: https://runapi.ai/tr/workbuddy-runway zh-TW: https://runapi.ai/zh-TW/workbuddy-runway zh-HK: https://runapi.ai/zh-HK/workbuddy-runway ar: https://runapi.ai/ar/workbuddy-runway x-default: https://runapi.ai/workbuddy-runway model: runway --- > HTML version: https://runapi.ai/zh-CN/workbuddy-runway > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Runway Runway Gen-4 可根据文本提示词或首帧图像，以 720p 或 1080p 生成 5 秒或 10 秒的视频。WorkBuddy 原生支持 MCP —— 只需把 RunAPI 添加为 MCP 服务器一次，之后直接向工作台智能体要视频即可。它会调用 Runway 工具，等待异步任务完成，并把最终的视频 URL 发回到你的对话中。扩展片段或用 Runway Aleph 重塑素材风格也是同样的方式。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 一个 RunAPI 密钥 · 720p 或 1080p 输出 ### Prompt ```text 通过 runapi MCP 服务器用 Runway Gen-4 生成一段视频。 要求： - 使用 runapi MCP 服务器的视频生成工具。 - 将 model 设为 "runway"。 - 提示词："无人机镜头在日出时分掠过薄雾笼罩的山间湖泊缓缓升起，电影级光效"。 - 将 duration_seconds 设为 10，output_resolution 设为 "1080p"。 - 任务是异步的 —— 等它完成后把视频 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": "runway", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ``` ## 三步在 WorkBuddy 中使用 Runway 1. **添加 RunAPI MCP 服务器** - 注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经把 RunAPI 接入了 WorkBuddy，同一个服务器就已经暴露了 Runway 工具 —— 无需额外配置。 `{ "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ` 2. **向工作台智能体发出提示** - 用自然语言向 WorkBuddy 描述你要的 Runway 视频 —— 描述场景，选择 5 秒或 10 秒，指定 720p 或 1080p。智能体会把你的需求映射到 runapi MCP 服务器暴露的 Runway 工具上；附上参考图时还会自动带上 first_frame_image_url。 `用 Runway Gen-4 生成一段 10 秒 1080p 视频： 无人机镜头在日出时分掠过薄雾笼罩的山间湖泊缓缓升起。 ` 3. **接收视频 URL** - Runway 任务是异步的。WorkBuddy 会通过 MCP 服务器轮询任务，直到状态为 completed，然后把输出的视频 URL 发到你的对话中。要扩展片段，让智能体带上 source_task_id 调用 extend_video 即可。 `{ "task_id": "tsk_abc123", "status": "completed", "output": { "video_url": "https://media.runapi.ai/videos/tsk_abc123.mp4" } } ` ## Runway 工具参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。Gen-4 使用 runway，Aleph edit_video 使用 runway-aleph。 | | `prompt` | `string` | 必填。对视频内容的文字描述 —— 镜头运动、场景、光照。 | | `duration_seconds` | `integer` | 必填。视频时长：5 或 10 秒。 | | `output_resolution` | `string` | 必填。输出分辨率：720p 或 1080p。影响定价。 | | `first_frame_image_url` | `string` | 可选。用作视频首帧的图像 URL。 | | `aspect_ratio` | `string` | 可选。输出宽高比：16:9、9:16、1:1、4:3 或 3:4。 | ## WorkBuddy 上的 Runway 是什么？ Runway Gen-4 以快速、干净的电影级输出、流畅的运动效果和出色的提示词遵从性著称。它可根据文本提示词或参考图像生成 5 秒或 10 秒、720p 或 1080p 的视频片段，其世界一致性能让角色和环境在镜头内保持稳定。WorkBuddy 通过 runapi MCP 服务器调用它 —— 与工作台里其他所有模型共用同一个服务器和 RUNAPI_API_KEY。 ## Runway 使用场景 - **创作者的片头与 B-roll** - 让 WorkBuddy 为 YouTube、Instagram 或 TikTok 内容生成精美的片头序列和 B-roll 素材。Runway 的电影感构图能把一句自然语言需求变成广播级质量的片段。 - **微广告与短视频 Reels** - 在工作台内直接创作 5 秒或 10 秒的广告短片和推广 Reels。附上产品图像作为首帧，Runway 会以镜头运动和自然光效为其制作动画。 - **影视制作预可视化** - 为叙事驱动的内容生成带一致角色的概念短片。使用参考图像锁定角色外观，在正式制作前完成多个镜头的预可视化。 ## Runway + WorkBuddy 常见问题 ### 我可以在 WorkBuddy 中使用 Runway 视频生成吗？ 可以。用你的 RUNAPI_API_KEY 把 RunAPI 添加为 MCP 服务器后，Runway 工具会和其他 RunAPI 模型一起出现。向工作台智能体描述视频需求 —— 提示词、时长（5 或 10 秒）、分辨率（720p 或 1080p），剩下的调用它会替你完成。 ### Runway Gen-4 和 Runway Aleph 有什么区别？ Runway Gen-4（model：runway）处理 text_to_video 和 extend_video —— 从文本或图像创建新片段。Runway Aleph（model：runway-aleph）处理 edit_video —— 用文本提示词重塑现有素材的风格。两者由同一个 runapi MCP 服务器暴露，WorkBuddy 可以按每次请求灵活切换。 ### Runway 在 RunAPI 上的定价如何运作？ Runway 采用基于 duration_seconds 和 output_resolution 的矩阵计费。5 秒 720p 片段的费用低于 10 秒 1080p 片段。当前费率请查看 RunAPI 定价页面。按量付费，无需订阅。 ### WorkBuddy 会等视频生成完吗，还是要我自己轮询？ 工作台智能体会处理好这一切。Runway 任务是异步的 —— 工具先返回一个 task_id，WorkBuddy 通过 MCP 服务器轮询任务直到状态为 completed，然后把视频 URL 发到你的对话中。你完全不需要自己管理轮询。 ### 我可以在生成后扩展 Runway 视频吗？ 可以。让 WorkBuddy 扩展该片段即可 —— 智能体会带上原始生成的 source_task_id 和你的新提示词调用 extend_video。扩展部分会追加到现有片段，按片段计价并基于 output_resolution。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未接入？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [Runway on RunAPI →](https://runapi.ai/zh-CN/models/runway.md) - 查看 Runway Gen-4 和 Aleph 版本、定价和 API 文档。 ## 立即在 WorkBuddy 中试用 Runway。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，不离开工作台即可用 Runway Gen-4 以 720p 或 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 Runway", "applicationCategory": "DeveloperApplication", "description": "在 WorkBuddy 中通过 RunAPI MCP 服务器使用 Runway Gen-4 生成视频。文生视频、5 秒或 10 秒片段、720p/1080p，一个 API 密钥搞定。", "url": "https://runapi.ai/zh-CN/workbuddy-runway" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我可以在 WorkBuddy 中使用 Runway 视频生成吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。用你的 RUNAPI_API_KEY 把 RunAPI 添加为 MCP 服务器后，Runway 工具会和其他 RunAPI 模型一起出现。向工作台智能体描述视频需求 —— 提示词、时长（5 或 10 秒）、分辨率（720p 或 1080p），剩下的调用它会替你完成。" } }, { "@type": "Question", "name": "Runway Gen-4 和 Runway Aleph 有什么区别？", "acceptedAnswer": { "@type": "Answer", "text": "Runway Gen-4（model：runway）处理 text_to_video 和 extend_video —— 从文本或图像创建新片段。Runway Aleph（model：runway-aleph）处理 edit_video —— 用文本提示词重塑现有素材的风格。两者由同一个 runapi MCP 服务器暴露，WorkBuddy 可以按每次请求灵活切换。" } }, { "@type": "Question", "name": "Runway 在 RunAPI 上的定价如何运作？", "acceptedAnswer": { "@type": "Answer", "text": "Runway 采用基于 duration_seconds 和 output_resolution 的矩阵计费。5 秒 720p 片段的费用低于 10 秒 1080p 片段。当前费率请查看 RunAPI 定价页面。按量付费，无需订阅。" } }, { "@type": "Question", "name": "WorkBuddy 会等视频生成完吗，还是要我自己轮询？", "acceptedAnswer": { "@type": "Answer", "text": "工作台智能体会处理好这一切。Runway 任务是异步的 —— 工具先返回一个 task_id，WorkBuddy 通过 MCP 服务器轮询任务直到状态为 completed，然后把视频 URL 发到你的对话中。你完全不需要自己管理轮询。" } }, { "@type": "Question", "name": "我可以在生成后扩展 Runway 视频吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。让 WorkBuddy 扩展该片段即可 —— 智能体会带上原始生成的 source_task_id 和你的新提示词调用 extend_video。扩展部分会追加到现有片段，按片段计价并基于 output_resolution。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Runway", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，向工作台智能体发出提示，用可控时长和分辨率生成 Runway Gen-4 视频，并接收最终的视频 URL。", "step": [ { "@type": "HowToStep", "position": 1, "name": "添加 RunAPI MCP 服务器", "text": "注册一个名为 runapi 的 MCP 服务器，指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经把 RunAPI 接入了 WorkBuddy，同一个服务器就已经暴露了 Runway 工具 —— 无需额外配置。", "url": "https://runapi.ai/zh-CN/workbuddy-runway#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台智能体发出提示", "text": "用自然语言向 WorkBuddy 描述你要的 Runway 视频 —— 描述场景，选择 5 秒或 10 秒，指定 720p 或 1080p。智能体会把你的需求映射到 runapi MCP 服务器暴露的 Runway 工具上；附上参考图时还会自动带上 first_frame_image_url。", "url": "https://runapi.ai/zh-CN/workbuddy-runway#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "接收视频 URL", "text": "Runway 任务是异步的。WorkBuddy 会通过 MCP 服务器轮询任务，直到状态为 completed，然后把输出的视频 URL 发到你的对话中。要扩展片段，让智能体带上 source_task_id 调用 extend_video 即可。", "url": "https://runapi.ai/zh-CN/workbuddy-runway#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 Runway", "item": "https://runapi.ai/zh-CN/workbuddy-runway" } ] } ] ```