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`	等到任务出结果再返回（助手通常直接用它）。

支付宝 AI 付直连 / Alipay AI Pay (zero sign-up)

你的智能体如果接入了支付宝 AI 付（A2M 402 协议），可以完全跳过注册和充值，按次自动结算。普通 MCP 客户端用户请继续使用上方的 API 密钥方式。

Agents with an Alipay AI Pay wallet can call the endpoints below with no account at all — payment happens automatically over the A2M 402 protocol. Everyone else: use the API-key path above.

资源 / Resource	端点 / Endpoint	计价 / Pricing
多语种文本翻译 / Text translation	`POST /a2m/v1/translate`	¥0.1 / 次
AI 视频配音 / Video dubbing	`POST /a2m/v1/dubbing`	¥1 / 分钟（最低 ¥2，按实测时长动态计费）

调用流程 / Flow：

无凭证调用 → 返回 402，响应头 Payment-Needed 携带 Base64URL 编码账单（含金额、商家 RSA2 签名、out_trade_no）。
智能体按账单支付（支付宝 AI 付收银）→ 获得凭证。
携带凭证重试：请求头 Payment-Proof（Base64URL JSON：protocol.payment_proof、protocol.trade_no，可选 method.client_session）→ 验付通过即交付资源，响应头 Payment-Validation 可二次校验。

配音任务为异步处理：验付后立即返回任务受理凭证（含 job_id），成片与字幕通过 GET /a2m/v1/dubbing/status/{out_trade_no} 轮询获取（out_trade_no 即查询凭证）。

示例请求 / Example：

POST https://zvex.cn/a2m/v1/dubbing
Content-Type: application/json

{"video_url": "https://example.com/talk.mp4", "target_language": "ru"}

两个服务均已上架支付宝 AI 付服务市场（服务搜索"声桥"或"zvex"可发现）。市场挂牌价即最低消费，实际以 402 账单实时金额为准。

Both services are live on the Alipay AI Pay service bazaar — discoverable by searching "声桥" or "zvex". Listed prices are minimums; the 402 bill carries the exact dynamic amount.

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