MCP 接入 · zvex

What this is

zvex 提供 MCP (Model Context Protocol) 服务。配置一次之后，你在 Claude Desktop / Cursor 里说一句「把这条视频译制成俄语」，助手就会自动提交任务、等待完成、把成片链接给你。

zvex speaks MCP. Configure it once and your assistant can submit dubbing jobs, poll them, and hand you the finished video — all from a normal conversation.

Before you start

注册并充值 —— 新账号送 10 分钟免费额度，够试一条短片。查看价格 →
创建 API 密钥 —— 登录后到账户设置 → API 密钥，创建一个，复制 zvex- 开头的那串（只显示一次）。

密钥是凭据，别外传。它等同于你的账号积分，任何拿到它的人都能提交任务并消耗你的额度。怀疑泄露就在设置页吊销重建。

Treat the key like a password. Revoke and recreate it from the same page if it leaks.

Configure your client

Claude Desktop（claude_desktop_config.json）或 Cursor（.cursor/mcp.json）里加上：

{
  "mcpServers": {
    "zvex": {
      "command": "uvx",
      "args": ["zvex"],
      "env": {
        "ZVEX_API_KEY": "zvex-your-key-here"
      }
    }
  }
}

首次调用时 uvx 会自动下载并启动它，不需要你手动装 Python 包。自建部署（用自己的域名）再加一个 "ZVEX_BASE_URL": "https://your-domain" 即可。

uvx fetches and runs the server on demand — no manual install. Add ZVEX_BASE_URL only if you self-host.

What your assistant can do

Tool	作用 / What it does
`estimate_cost`	按时长预估积分消耗，并返回当前余额。
`submit_dubbing_job`	提交一个译制任务（视频直链 + 目标语言），返回任务号。
`get_job_status`	查询任务状态；完成时带回成片与字幕链接。
`wait_for_job`	等到任务出结果再返回（助手通常直接用它）。

Billing and limits

10 积分 / 分钟，按服务端实测时长计费；任务失败或取消全额退还。
视频需是公网可访问的 http(s) 直链，单个不超过 500MB。
每个账号同一时间只跑一个任务，重复提交会返回 409。
目标语言以部署支持集为准（当前 ru / en / es）。

Troubleshooting

现象 / Symptom	原因与处理
`401 API key is missing, invalid, or revoked`	密钥没配、配错或已被吊销 —— 到账户设置核对或重建。
`402 Not enough credits`	积分不足，充值后再试。
`409 Another job … still running`	上一个任务还没结束，等它跑完（单并发限制）。
`400 … 非公网地址`	视频链接指向了内网地址，换公网可访问的直链。

工具报错会原样带回服务端原因，助手通常能自己判断下一步，不用你去翻日志。

Connect zvex to your AI assistant