OpenClaw LaunchOpenClaw Launch
← 国内应用

国内应用接入

Vidu MCP 接入：确认参数后生成视频，再按任务查询结果

为 Hermes Agent 或 OpenClaw 连接 Vidu 官方文生视频 API。用您自己的 API Key 和账户积分生成素材，保存任务 ID，并及时下载完成后的结果。

让每次视频生成都有明确的参数与结果

想把竹林晨雾、城市夜景或产品使用场景变成短视频时，助手可以先协助整理镜头描述，再将您确认的提示词提交到 Vidu。当前托管连接使用生数科技的官方文生视频接口，提供创建任务和查询生成结果两项操作。

视频生成会消耗您自己的 Vidu 积分，耗时也受排队与模型处理影响。工具会先返回任务 ID，而非立即返回完整视频；助手随后用该 ID 查询状态，在成功后交付结果链接。

Hermes Agent 和 OpenClaw 都从国内应用列表连接 Vidu。API Key 保存在服务端，工具加载完成后即可使用；如果 Hermes 仍显示重载中，请等待就绪。为避免连接测试意外计费，可以先准备提示词和参数，或查询您已有的任务。

接入后可以做什么？

  • 整理生成方案：Agent 可以先把创意写成提示词，并列出模型、时长、画幅与分辨率供您核对。这是助手的文字准备工作，本身不会提交 Vidu 生成任务。
  • 确认后创建视频任务：目前支持 viduq3-turbo、viduq3-pro、viduq2 和 viduq1。工具要求明确指定模型，并在确认内容与费用风险后才提交。
  • 查询状态与结果地址：按 task_id 查询原任务，成功时取得视频及可用封面地址。查询是只读的，不会重新发起生成；结果链接通常只有 24 小时有效期。

如何取得 Vidu API Key 并接入？

请使用 Vidu API 平台的 API Key。登录平台后，在 API Keys／API Key 管理中创建密钥，并检查自己的 API 积分与接口权限；网页创作界面的使用资格不应直接当作 API 额度保证。

Vidu 官方 FAQ：API Key 创建与 API 积分开通

  1. 登录 API 平台 — 进入 platform.vidu.cn 并登录，在 API Key 管理中创建专用于助手的密钥。请将完整 Key 放在密码管理器中，不要发送到聊天消息。
  2. 核对账户与计划 — 检查 Vidu API 账户积分、目标模型的调用权限和当前计费规则。先决定您愿意使用的模型、时长和分辨率，再安排真实生成。
  3. 连接您的助手 — 在 OpenClaw Launch 国内应用列表选择 Vidu，将 Key 填入 API Key 字段。Hermes Agent 与 OpenClaw 使用同一入口；等待连接和工具加载就绪。
  4. 先预览再确认 — 让助手展示提示词、model、duration、aspect_ratio 和 resolution。确认这一次生成可消耗自己的 Vidu 额度后，再允许传 confirm:true 创建任务。
  5. 查询并及时保存素材 — 保留创建返回的 task_id，查询该任务直到完成。拿到结果后及时下载到安全位置；若创建请求超时或返回异常，先去 Vidu 任务列表核对，不要自动重试。
凭证与权限边界：Vidu API Key 由 OpenClaw Launch 服务端加密保存，只在服务端请求官方接口时使用，不写入机器人容器。连接页保存 Key 不等于完成上游认证或充值验证；接口仍会检查凭证、权限、请求频率与额度。您可以断开连接，并在 Vidu 平台管理或撤销不用的密钥。

连接后可以直接这样问

  • “为一个竹林晨雾短片准备 Vidu 提示词，选择 viduq3-turbo、5 秒、16:9、720p；先展示全部参数，等我确认费用后再生成。”
  • “我想做一段 9:16 的城市夜景竖屏视频，使用 viduq2、5 秒、720p。先帮我精简镜头描述，不要提交生成。”
  • “查询刚才返回的 Vidu task_id，成功后给我视频和封面链接，并提醒我及时下载；如果未完成，不要重复生成。”

使用前必须知道的限制

当前支持的模型和时长为：viduq3-turbo／viduq3-pro 1–16 秒，viduq2 1–10 秒，viduq1 仅 5 秒。Q3 与 Q2 可选 540p、720p、1080p，以及 16:9、9:16、3:4、4:3、1:1；Q1 仅支持 1080p 和 16:9、9:16、1:1。参数仍须符合上游账号权限。连接不提供图生视频、参考生视频、取消任务或任务列表，也不接受音频开关、seed、回调地址与错峰模式等额外参数。模型名称必须明确指定。

每次创建都可能消耗真实积分；工具要求 confirm:true，并禁止自动重复提交创建请求。遇到超时、服务异常或响应不完整时，任务仍可能已经创建，请先到 Vidu 平台核对。任务结果通常 24 小时后失效，应及时保存；素材在对外使用前需检查画面与内容，避免把私密信息写入提示词。

托管连接还是自己搭工具？

方案适合谁您需要负责什么
OpenClaw Launch 托管希望尽快让机器人持续在线并连接Vidu的用户提供必要授权、确认敏感操作并管理自己的应用账户
自行部署已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者为 Hermes Agent 或 OpenClaw 分别配置兼容的视频工具，保管 API Key，维护模型参数和任务状态处理；实现付费生成前确认、创建请求不自动重试、结果链接下载与保留策略。自行维护的部署需要单独完成这些能力。

自行部署是合理选择；托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3，续费 $6/月，支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。

已经有机器人？前往国内应用一键接入查看连接状态；第一次部署可先阅读养龙虾入门指南。

Vidu接入常见问题

Vidu 接入支持 Hermes Agent 吗？

支持。OpenClaw Launch 的 Hermes Agent 和 OpenClaw 都可通过国内应用页面连接 Vidu，使用确认后的文生视频与任务查询。Hermes 首次连接后可能需要等待工具重载。

创建 Vidu 任务需要确认什么？

需要确认完整提示词、模型、时长、画幅、分辨率以及消耗自己账户积分的费用风险。工具只在 confirm:true 时提交真实生成请求。

生成请求超时后能直接重试吗？

不要自动重试。任务可能已经创建并计费，应先在 Vidu 平台任务列表核对；有任务 ID 时优先查询原任务。

支持哪些 Vidu 模型？

当前托管连接允许 viduq3-turbo、viduq3-pro、viduq2、viduq1，且必须明确选择一个。它不代表 Vidu 官方所有模型或所有视频功能已经接入。

能上传图片生成视频或取消任务吗？

当前连接没有图片输入或取消任务操作，只提供文生视频与指定任务结果查询。其他功能请通过 Vidu 官方平台和已支持的工具处理。

视频链接可以长期保存吗？

结果链接通常只有 24 小时有效期。应及时下载视频到自己控制的存储位置，不要把临时结果地址当作永久素材库。

继续配置您的中文 AI 助手

连接 Vidu，让视频创意进入可控的生成流程

先创建持续在线的 AI Agent，再从国内应用列表连接Vidu。托管首月 $3，续费 $6/月，支持支付宝和微信支付。

开始部署Vidu助手