VIDIA

这是什么？ / What is this?

KO — VIDIA 是一项 AI 视频制作服务：选择一个套餐（视频制作方案），输入主题，VIDIA 就会生成脚本，并制作旁白、图片、AI 视频片段和字幕。借助此 MCP 服务，Claude、Cursor、Codex 等 AI Agent 可以直接从 VIDIA 获取报价，在用户同意后开始制作、跟踪进度并下载成品视频。

EN — VIDIA 是一项 AI 视频制作服务：选择一个套餐（制作方案），输入主题，VIDIA 就会撰写脚本，并制作旁白、图片、AI 视频片段和字幕。借助此 MCP 服务，AI Agent 可以获取报价，在用户同意后开始制作、跟踪进度并下载成品视频。

服务由 VIDIA 托管。服务器由 VIDIA 运营。

https://vidia.kr/mcp

快速开始 / Quick start

1. 创建 API 密钥 / Create an API key

请在 vidia.kr/settings/api 创建密钥。权限分为两种。 在 vidia.kr/settings/api 创建密钥。权限范围有两种：

tools/list 无需密钥即可使用。密钥从 tools/call 开始验证。 tools/list 无需密钥即可使用；tools/call 会验证密钥。

2. 连接 / Connect

claude mcp add --transport http vidia https://vidia.kr/mcp --header "Authorization: Bearer YOUR_VIDIA_API_KEY"

{
  "mcpServers": {
    "vidia": {
      "command": "npx",
      "args": ["-y", "vidia-mcp"],
      "env": { "VIDIA_API_KEY": "YOUR_VIDIA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "vidia": {
      "url": "https://vidia.kr/mcp",
      "headers": { "Authorization": "Bearer YOUR_VIDIA_API_KEY" }
    }
  }
}

{
  "servers": {
    "vidia": {
      "type": "http",
      "url": "https://vidia.kr/mcp",
      "headers": { "Authorization": "Bearer YOUR_VIDIA_API_KEY" }
    }
  }
}

[mcp_servers.vidia]
command = "npx"
args = ["-y", "vidia-mcp"]
env_vars = ["VIDIA_API_KEY"]

VIDIA_API_KEY=YOUR_VIDIA_API_KEY npx -y vidia-mcp

3. 提问 / Ask

“请帮我获取 VIDIA 健康科普短视频套餐的报价，主题是‘为什么打哈欠会传染？’” “请帮我获取 VIDIA 关于哈欠为什么会传染的健康短视频报价。”

Agent 会依次调用 vidia_list_packages → vidia_get_package → vidia_quote 来展示报价；用户同意后，会调用 vidia_start_run 开始制作，再通过 vidia_get_run 查询进度，并通过 vidia_get_downloads 获取成品链接。

工具 / 工具

参数和结果格式请参阅 TOOLS.md。

安全保障

• 使用测试密钥（vd_test_…）连接，即可免费演练整个流程：约 40 秒后会收到示例结果，且每个响应都带有 test: true。
• 支持 OAuth 的应用可以跳过此套餐：输入 https://vidia.kr/mcp 并登录 VIDIA。
• 只有 vidia_start_run、vidia_start_batch 和 vidia_run_action 的 add_budget / approve_price 操作会冻结点数。开始制作需要有效的报价 ID、预算、idempotency_key 和 confirm: true；使用相同的 idempotency_key 重试不会创建第二项制作。
• run 密钥设有每日制作上限，且可随时撤销。
• 制作停止时，请查看制作状态中的 pending 和 actions，并使用 vidia_run_action 处理（也可以在网页项目页面继续）。密钥可以设置单项制作和每日预算上限，以及 IP 允许列表。
• 此套餐仅转发 JSON-RPC。密钥仅通过 Authorization 请求头发送，并会从所有输出中隐藏。

环境变量 / Environment

REST API / SDK

如需在代码中直接使用，请使用 vidia-api。

许可证

MIT