跳转到主要内容
对已上传视频或音频执行完整的 翻译配音 流水线：语音识别、文稿翻译、AI 配音（克隆或预设音色）与渲染输出。可选字幕与口型同步。仅异步 — 配音文件通过 Webhook 投递。
本接口会在目标语言下 重新配音 你的媒体。它不是纯文本翻译，也不会只返回字幕 — 你会得到新的配音视频或音频文件。

​
任务类型

若请求 at 但素材为视频，服务端可能按 视频翻译（vt） 执行。请以受理响应与 Webhook 中的 taskType 为准。

​
流程

1

上传素材

走完完整的 素材上传 流程（含 complete / 瞬时上传）后，再使用已注册的 materialId
2

配置 Webhook

在 API 配置 设置 Webhook URL，并复制页面展示的 Secret 用于验签
3

提交任务

POST /openapi/v1/task/media-translation/create-async，携带 X-Idempotency-Key
4

接收结果

event 为 openapi-media-translation 的 Webhook 请求体

​
请求概要

必填包括 taskType、source.materialId、language（源/目标 locale）、options（配音、ASR、翻译等）。 source.materialId 必须来自 已走完完整流程 的 素材上传（或上传成功后的 素材列表）。不要使用仅出现在 gen-upload-url / 分片发起响应中的进行中 materialId。 区域代码见 支持的语言。完整 options 树见 创建媒体翻译（异步） 的请求体。

​
响应

  • HTTP Response（立即）：受理信息 — taskId、status、createdAt、实际 taskType
  • Webhook（完成时）：data.result 中的交付物 CDN URL
不要在 create-async 的 HTTP 响应中等待最终音视频 URL。

​
Webhook 结果中的音色字段

翻译脚本逐句结果与逐句 TTS 结果可能包含 voiceId 与 provider。请 原样复制 API 返回值，不要自行拼接或猜测。 若支持用户改句并再次提交，请成对保存并回传 voiceId 与 provider。见 音色。

​
任务管理

可轮询 GET /openapi/v1/tasks/detail 作为兜底。见 产品概览。