zvex 多语种视频译制配音

把视频链接或文本交给声桥：自动完成语音识别、说话人分离、翻译、AI 音色复刻配音（按角色还原原说话人音色）、字幕与成片合成。

能力与定价

| 能力 | 端点 | 计价 | |---|---|---| | 视频译制配音 | POST https://zvex.cn/a2m/v1/dubbing | ¥1/分钟（最低 ¥2/单），按服务端 ffprobe 实测时长动态计费 | | 文本翻译 | POST https://zvex.cn/a2m/v1/translate | ¥0.1/次 |

目标语言规则（必须遵守）：

当前仅支持：俄语（ru）、英语（en）、西班牙语（es）
用户明确指定语言时：中文→ru 场景直接传 ru；日语/法语等暂不支持
用户未指定时：默认传 en（配音）或 ru（翻译场景按上下文判断）
用户指定了不支持的语言：明确告知仅支持 ru/en/es，不要臆传其他代码

检索关键词

中文：视频翻译、视频配音、字幕翻译、配音成片、短剧出海、译制
English: video translation, video dubbing, translate video, subtitle, localization

调用流程（支付宝 AI 付 · A2M 402 协议）

无凭证调用：直接 POST，返回 402，响应头 Payment-Needed 携带 Base64URL 编码账单。解码后 protocol 含 out_trade_no、amount、currency、resource_id、pay_before、seller_signature（商家 RSA2 签名，收款方经平台核验）。
支付：使用你的支付宝 AI 付钱包按账单完成支付（账单已由商家签名，金额与收款方以账单为准）。
携带凭证重试：支付完成后取得 trade_no 与 payment_proof，构造请求头：
```
Payment-Proof: Base64URL(JSON{
  "protocol": {"payment_proof": "<...>", "trade_no": "<...>"},
  "method":   {"client_session": <可选>}
})
```
重试原请求 → 200 交付资源，响应头 Payment-Validation 可作二次校验。
凭证失败处理：402 INVALID_PAYMENT_PROOF 表示凭证无效/过期/已使用——不要重用旧凭证，重新发起调用获取新账单再支付。

文本翻译（同步）

POST /a2m/v1/translate
{"text": "要翻译的文本", "target_language": "ru"}

200 → {"resource_id": "/a2m/v1/translate",
       "content": {"status": "success", "translation": "<译文>", ...}}

text 单次不超过 64KB。

视频配音（异步任务）

POST /a2m/v1/dubbing
{"video_url": "https://example.com/talk.mp4", "target_language": "zh"}

200 → {"content": {"job_id": 123, "status": "queued",
                   "poll": "GET /a2m/v1/dubbing/status/{out_trade_no}"}}

验付通过即受理入队（返回较快），成片需轮询状态接口：

status = queued / processing → 等待后再次查询（任务耗时数分钟，视视频时长与队列）
status = completed → 返回 final_video_url 与 subtitle_url
status = failed → 返回 error；费用补偿联系商家

out_trade_no 即查询凭证，请保留。

异常处理规则（写死）

| 响应 | 含义 | 必须执行的动作 | |---|---|---| | 402 + Payment-Needed | 无凭证，账单已生成 | 引导完成支付宝 AI 付支付，然后带 Payment-Proof 重试 | | 402 INVALID_PAYMENT_PROOF | 凭证无效/过期/已使用 | 不要重用旧凭证；重新发起调用获取新账单再支付 | | 400 EMPTY_TEXT / EMPTY_VIDEO_URL | 缺必填参数 | 向用户索要 text 或 video_url 后重试 | | 400 QUOTE_FAILED | 视频链接无法探测时长 | 确认是公网可直连的视频文件直链，更换链接 | | 400 BAD_TARGET_LANGUAGE | 目标语言不支持 | 按上方语言规则提示仅支持 ru/en/es | | status = failed（轮询） | 任务执行失败 | 告知用户任务失败；费用补偿联系商家，不要自动重付 | | 网络超时/连接失败 | 服务或网络异常 | 稍后重试同一请求；已有账单在 pay_before 前仍有效 |

约束

video_url 必须是公网可直连的 http(s) 视频文件直链，单个 ≤ 500MB
动态账单金额由服务端按实测时长生成，支付金额必须与账单一致
同一 payment_proof 只能使用一次；凭证无效时重新获取账单

服务方

声桥 zvex（https://zvex.cn）。两个服务均已上架支付宝 AI 付服务市场（搜索"声桥"或"zvex"）：声桥AI文本翻译、声桥AI视频配音。协议细节与 MCP 接入方式见 https://zvex.cn/docs/mcp。

常见问题（FAQ）

Q1：支持哪些目标语言？ 当前仅俄语(ru)/英语(en)/西班牙语(es)，其余语言请求在计费前拦截。 Q2：视频配音怎么计费？ 按服务端 ffprobe 实测时长动态计费；首次调用返回含时长的账单，确认后支付。 Q3：首次返回账单不是结果？ 正常（按次付费）；支付后同参数带 Payment-Proof 头重发即得结果，同账单幂等。 Q4：没有支付宝？ zvex.cn 生成 API Key，请求体带 zvex_api_key 按积分结算。 Q5：配音保留原声音吗？ 是，按角色还原原说话人音色；输出含配音成片与字幕。