Vidu API
工作台
文档
登录

Vidu MCP Streamable Http 协议

安装与配置

前提条件

Vidu API 密钥:从 Vidu Platform 获取 (API Credits 需要从Vidu Platform购买)

如何使用 MCP Server

1. 获取 Vidu API 密钥

  • 访问 Vidu Platform
  • 注册/登录您的账户
  • 在个人设置中创建并复制您的 API 密钥

2. 配置 MCP 客户端

启动Inspector工具

  1. 启动 Inspector
    npx @modelcontextprotocol/inspector
  2. 配置连接参数
    • 选择 Transport TypeStreamable HTTP
    • Authorization 部分配置:
      • Header Name: x-md-Authorization
      • Bearer Token: Token {your_api_key} (请将 {your_api_key} 替换为您的实际 API 密钥)
  3. 建立连接
    • 点击 Connect 按钮即可建立 HTTP Streamable 连接

配置Cursor/Claude for Desktop

  • 打开您的 MCP 客户端(如 Claude for Desktop 或 Cursor)
  • 找到客户端设置
  • 找到并打开 mcp_config.json 文件(或相应的配置文件)
  • 根据您选择的方式添加配置:
{
"mcpServers": {
"Vidu":{
"url": "https://api.vidu.cn/mcp/v1",
"headers": {
"Authorization": "Token {your_api_key}"
}
}
}
}
  • 保存配置文件

3. 重启 MCP 客户端或刷新 MCP 服务器

  • 完全关闭并重新打开您的 MCP 客户端
  • 或者,如果客户端支持,使用刷新 MCP 服务器选项

具体客户端配置

Claude for Desktop 配置

  1. 打开 Claude 应用
  2. 转到 Claude > 设置 > 开发者 > 编辑配置
  3. 打开 claude_desktop_config.json 文件
  4. 添加上述配置并保存
  5. 重启 Claude 应用
    • 如果连接成功, 首页不会提示任何error, 且mcp设置亮绿灯
    • 如果连接失败, 首页会提示连接失败

Cursor 配置

  1. 打开 Cursor 应用
  2. 转到设置 > Model Context Protocol
  3. 添加新服务器
  4. 填写服务器详情(与上面 JSON 配置中的信息相同)
  5. 保存并重启 or 刷新mcp server

使用示例

文生视频

通过 Claude 或 Cursor,您可以使用自然语言描述要生成的视频:
基础示例
以浅蓝色和淡琥珀色为基调的超写实时尚摄影风格,一位身着宇航服的宇航员在雾中穿行。背景由迷人的白色和金色灯光组成,营造出极简主义的静物画和令人印象深刻的全景场景。
进阶示例(带参数)
使用以下参数生成夜间城市景观视频:
提示:夜空下摩天大楼灯光闪烁,汽车灯光在道路上形成光带
模型:viduq1
风格:普通
时长:5
宽高比:16:9
分辨率:1080p
运动幅度:中等

参考生视频

基础示例
1:https://image1.png
2:https://image2.png
3:https://image3.png
生成一个视频,图2的黑猫和图3的皮卡丘在图1的通往海边的小路上走着打闹,皮卡丘打在黑猫的头上,黑猫扑向皮卡丘,动作快,场面激烈,画质逼真。
进阶示例(带参数)
使用以下参数生成一个视频:
提示:图二的黑猫和图三的皮卡丘在图一的通往海边的小路上走着打闹,皮卡丘打在黑猫的头上,黑猫扑向皮卡丘,动作快,场面激烈,画质逼真
1: https://image1.png
2:https://image2.png
3:https://image3.png
模型:viduq1
风格:普通
时长:5
宽高比:16:9
分辨率:1080p