--- title: 通过 RunAPI 在 WorkBuddy 中使用 Veo 3 — MCP 视频指南 | RunAPI description: 在 WorkBuddy 中使用 Google Veo 3 生成带原生音频的视频。把 RunAPI 添加为 MCP 服务器，向工作台智能体下达指令，即可拿回视频 URL。 url: https://runapi.ai/zh-CN/workbuddy-veo-3.md canonical: https://runapi.ai/zh-CN/workbuddy-veo-3 locale: zh-CN site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-veo-3 zh-CN: https://runapi.ai/zh-CN/workbuddy-veo-3 es: https://runapi.ai/es/workbuddy-veo-3 ja: https://runapi.ai/ja/workbuddy-veo-3 de: https://runapi.ai/de/workbuddy-veo-3 fr: https://runapi.ai/fr/workbuddy-veo-3 pt-BR: https://runapi.ai/pt-BR/workbuddy-veo-3 ko: https://runapi.ai/ko/workbuddy-veo-3 it: https://runapi.ai/it/workbuddy-veo-3 nl: https://runapi.ai/nl/workbuddy-veo-3 pl: https://runapi.ai/pl/workbuddy-veo-3 tr: https://runapi.ai/tr/workbuddy-veo-3 zh-TW: https://runapi.ai/zh-TW/workbuddy-veo-3 zh-HK: https://runapi.ai/zh-HK/workbuddy-veo-3 ar: https://runapi.ai/ar/workbuddy-veo-3 x-default: https://runapi.ai/workbuddy-veo-3 model: veo-3 --- > HTML version: https://runapi.ai/zh-CN/workbuddy-veo-3 > Site index for agents: https://runapi.ai/llms.txt # 在 WorkBuddy 中使用 Veo 3 Veo 3 是 Google DeepMind 的视频生成模型，可生成最长 8 秒、1080p 的片段，并带有原生音频——与画面同步生成的对白、环境声和音乐。WorkBuddy 原生支持 MCP 协议，把 RunAPI 添加为 MCP 服务器后，工作台智能体即可把 Veo 3 当作工具直接调用，无需安装任何插件。 - [获取 API Key](https://runapi.ai/zh-CN/login) - [阅读文档](https://runapi.ai/zh-CN/docs/guides) 一个 MCP 服务器 · 一个 RunAPI 密钥 · 原生音频输出 ### Prompt ```text 使用 runapi MCP 服务器，用 Google Veo 3 生成一段电影级视频片段。 要求： - 使用模型 "veo-3.1"。 - 撰写包含场景、镜头运动和音频提示（引号内的对白、环境声、音乐）的描述性提示词。 - 将 duration_seconds 设置为 8，aspect_ratio 设置为 "16:9"。 - 任务是异步的。等待任务完成后，汇报视频 URL、最终状态和费用。 ``` ### MCP 配置 ```bash { "mcpServers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 结果 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "veo-3.1", "output": { "video_url": "https://media.runapi.ai/tasks/tsk_abc123/output.mp4", "duration_seconds": 8, "resolution": "1080p" } } ``` ## 三步在 WorkBuddy 中使用 Veo 3 1. **将 RunAPI 添加为 MCP 服务器** - 在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经为其他模型接入过 RunAPI，Veo 3 已经是可调用的工具——无需任何额外安装。 `url: https://runapi.ai/mcp transport: streamable_http auth: Bearer $RUNAPI_API_KEY ` 2. **向工作台智能体下达指令** - 让 WorkBuddy 用 Veo 3 生成视频。描述场景、镜头运动和音频提示——引号内的对白、环境声、音乐。指定模型 veo-3.1，将 duration_seconds 设置为 4、6 或 8，aspect_ratio 设置为 16:9 或 9:16。 `使用 runapi MCP 服务器生成一段 8 秒的 Veo 3 片段：……` 3. **由智能体调用工具并取回结果** - WorkBuddy 通过 runapi MCP 服务器调用 Veo 3 的 text_to_video 工具。任务是异步的——智能体会持续轮询直到状态变为 completed，然后把视频 URL 交回给你。视频包含根据提示词同步生成的音频。 `runapi.text_to_video -> task_id: tsk_abc123 -> status: completed` ## Veo 3 text_to_video 参数 | 参数 | 类型 | 说明 | | --- | --- | --- | | `model` | `string` | 必填。veo-3.1（标准质量）或 veo-3.1-fast（成本更低，生成更快）。 | | `prompt` | `string` | 必填。场景描述，包括视觉动作、镜头运动以及对白或环境声的音频提示。 | | `duration_seconds` | `integer` | 可选。视频时长（秒）。接受值：4、6、8。默认为 8。 | | `aspect_ratio` | `string` | 可选。输出宽高比。接受值：16:9、9:16、auto。 | | `input_mode` | `string` | 可选。生成模式。text（默认）、first_and_last_frames（关键帧引导）或 reference（风格参考）。 | | `first_frame_image_url` | `string` | 可选。首帧图像的 URL。当 input_mode 为 first_and_last_frames 时使用。 | ## WorkBuddy 上的 Veo 3 是什么？ Veo 3 是 Google DeepMind 的视频模型，能产出带精准环境音频的逼真电影级画面。它生成最长 8 秒的 1080p 片段，带有同步对白、音效和音乐——无需单独的音频处理流程。WorkBuddy 通过 runapi MCP 服务器接入它，工作台智能体像调用标准工具一样调用 Veo 3，使用的是 RUNAPI_API_KEY 中的同一个密钥。 ## Veo 3 使用场景 - **街头采访与对话场景** - 让 WorkBuddy 生成带人物说话对白的短视频场景。在提示词中描述对话内容，Veo 3 将同步生成口型动作和城市环境噪音。 - **大气感与风景内容** - 创作旅游 vlog 场景、雨中城市街景或雾中自然镜头，Veo 3 的环境音频生成无需后期音频制作即可增添层次感。 - **带旁白的产品演示视频** - 生成旁白介绍产品功能的展示短片。将旁白文字包含在提示词中，Veo 3 一次性渲染视觉演示和语音音频。 ## Veo 3 + WorkBuddy 常见问题 ### 我能在 WorkBuddy 中使用 Veo 3 吗？ 可以。WorkBuddy 原生支持 MCP。用你的 RUNAPI_API_KEY 将 RunAPI 添加为 MCP 服务器，工作台智能体即可直接调用 Veo 3 的 text_to_video 工具——无需插件、桥接服务或 Google Cloud 账户。 ### Veo 3 要付费吗，还是免费的？ Veo 3 是 RunAPI 上的付费模型。每次生成按任务计费，费用取决于时长和质量档位。veo-3.1-fast 比 veo-3.1 便宜。当前费率请查看 RunAPI 定价页面。无需订阅——按生成付费。 ### 为什么 Veo 3 比其他生成器慢？ Veo 3 在一次生成中同时产出视频和同步音频，处理时间更长，通常需要 60 到 180 秒。等待由 WorkBuddy 智能体代劳——它会轮询异步任务，视频就绪后向你汇报。迭代草稿时可改用 veo-3.1-fast 加快交付。 ### 生成后我能扩展或超分 Veo 3 视频吗？ 可以。RunAPI 通过同一个 MCP 服务器为 Veo 3 提供 extend_video 和 upscale_video 工具。让 WorkBuddy 引用原始生成的 task_id 来扩展片段，或将其超分至 1080p 或 4K。两者都是异步的，并单独计费。 ### 最大视频时长和分辨率是多少？ Veo 3 生成 4、6 或 8 秒、最高 1080p 基础分辨率的片段。你可以使用 upscale_video 工具将已完成的视频超分至 4K。宽高比选项为 16:9、9:16 和 auto。 - [WorkBuddy 配置指南 →](https://runapi.ai/zh-CN/workbuddy.md) - 尚未接入？请从 WorkBuddy 的 RunAPI MCP 配置指南开始。 - [RunAPI 上的 Veo 3 →](https://runapi.ai/zh-CN/models/veo-3.1.md) - 查看 Veo 3 版本、定价层级和 API 文档。 ## 立即在 WorkBuddy 中试用 Veo 3。 免费获取 RunAPI 密钥，在 WorkBuddy 中添加 MCP 服务器，即可使用 Google Veo 3 生成带原生音频的电影级视频。 [浏览模型 →](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 Veo 3", "applicationCategory": "DeveloperApplication", "description": "在 WorkBuddy 中使用 Google Veo 3 生成带原生音频的视频。把 RunAPI 添加为 MCP 服务器，向工作台智能体下达指令，即可拿回视频 URL。", "url": "https://runapi.ai/zh-CN/workbuddy-veo-3" }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "我能在 WorkBuddy 中使用 Veo 3 吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。WorkBuddy 原生支持 MCP。用你的 RUNAPI_API_KEY 将 RunAPI 添加为 MCP 服务器，工作台智能体即可直接调用 Veo 3 的 text_to_video 工具——无需插件、桥接服务或 Google Cloud 账户。" } }, { "@type": "Question", "name": "Veo 3 要付费吗，还是免费的？", "acceptedAnswer": { "@type": "Answer", "text": "Veo 3 是 RunAPI 上的付费模型。每次生成按任务计费，费用取决于时长和质量档位。veo-3.1-fast 比 veo-3.1 便宜。当前费率请查看 RunAPI 定价页面。无需订阅——按生成付费。" } }, { "@type": "Question", "name": "为什么 Veo 3 比其他生成器慢？", "acceptedAnswer": { "@type": "Answer", "text": "Veo 3 在一次生成中同时产出视频和同步音频，处理时间更长，通常需要 60 到 180 秒。等待由 WorkBuddy 智能体代劳——它会轮询异步任务，视频就绪后向你汇报。迭代草稿时可改用 veo-3.1-fast 加快交付。" } }, { "@type": "Question", "name": "生成后我能扩展或超分 Veo 3 视频吗？", "acceptedAnswer": { "@type": "Answer", "text": "可以。RunAPI 通过同一个 MCP 服务器为 Veo 3 提供 extend_video 和 upscale_video 工具。让 WorkBuddy 引用原始生成的 task_id 来扩展片段，或将其超分至 1080p 或 4K。两者都是异步的，并单独计费。" } }, { "@type": "Question", "name": "最大视频时长和分辨率是多少？", "acceptedAnswer": { "@type": "Answer", "text": "Veo 3 生成 4、6 或 8 秒、最高 1080p 基础分辨率的片段。你可以使用 upscale_video 工具将已完成的视频超分至 4K。宽高比选项为 16:9、9:16 和 auto。" } } ] }, { "@context": "https://schema.org", "inLanguage": "zh-CN", "@type": "HowTo", "name": "如何通过 RunAPI 在 WorkBuddy 中使用 Veo 3", "description": "在 WorkBuddy 中将 RunAPI 添加为 MCP 服务器，向工作台智能体下达指令，由它调用 Veo 3 的 text_to_video 工具生成带原生音频的视频。", "step": [ { "@type": "HowToStep", "position": 1, "name": "将 RunAPI 添加为 MCP 服务器", "text": "在 WorkBuddy 中注册一个名为 runapi 的 MCP 服务器，通过 streamable HTTP 指向 https://runapi.ai/mcp，并在 Authorization 请求头中从 RUNAPI_API_KEY 读取密钥。如果你已经为其他模型接入过 RunAPI，Veo 3 已经是可调用的工具——无需任何额外安装。", "url": "https://runapi.ai/zh-CN/workbuddy-veo-3#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "向工作台智能体下达指令", "text": "让 WorkBuddy 用 Veo 3 生成视频。描述场景、镜头运动和音频提示——引号内的对白、环境声、音乐。指定模型 veo-3.1，将 duration_seconds 设置为 4、6 或 8，aspect_ratio 设置为 16:9 或 9:16。", "url": "https://runapi.ai/zh-CN/workbuddy-veo-3#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "由智能体调用工具并取回结果", "text": "WorkBuddy 通过 runapi MCP 服务器调用 Veo 3 的 text_to_video 工具。任务是异步的——智能体会持续轮询直到状态变为 completed，然后把视频 URL 交回给你。视频包含根据提示词同步生成的音频。", "url": "https://runapi.ai/zh-CN/workbuddy-veo-3#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 Veo 3", "item": "https://runapi.ai/zh-CN/workbuddy-veo-3" } ] } ] ```