zvex
获取 API Token

把 zvex 接入你的 AI 助手

把 zvex 接入 Claude Desktop、Cursor 或任意 MCP 客户端——直接把视频链接发给你的 AI 助手，拿回配音成片。

先去创建一个 API 密钥 → 看配置方式 支付宝 AI 付智能体：零注册直连 ↓

这是什么

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

开始之前

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

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

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" 即可。

你的助手能做什么

Tool作用
estimate_cost按时长预估积分消耗，并返回当前余额。
upload_video上传本地视频文件，返回 file_id（同文件只需上传一次）。
submit_dubbing_job提交一个译制任务：视频直链 或 已上传的 file_id（二选一）+ 目标语言，返回任务号。
get_job_status查询任务状态；完成时带回成片与字幕链接。
wait_for_job等到任务出结果再返回（助手通常直接用它）。

支付宝 AI 付直连（零注册）

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

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

调用流程：

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

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

示例请求：

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

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

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

计费与限制

常见问题

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

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

拿到密钥，然后直接开口。

创建 API 密钥