API文档
产品定价
数字人视频翻译
数字人-视频翻译简介
概念解释
数字人视频翻译服务，快速、准确翻译视频文本，克隆声音，改变口型，在切换语言的同时保留表达者音色与表达风格，逼真的口型与自然的神情可满足跨境电商出海营销、广告多国投放、自媒体视频创作等多样化的视频翻译需求
说明
Hi，您好，欢迎使用有道智云数字人视频翻译接口服务。
本文档主要针对需要集成HTTP API的技术开发工程师，详细描述数字人视频翻译能力相关的技术内容。
如果您有与我们商务合作的需求，可以通过以下方式联系我们：
商务邮箱： AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问，可以通过以下几种方式联系我们：
客服QQ：1906538062
AIGC产品技术交流群 ：837394306
联系邮箱： zhiyun@corp.youdao.com
温馨提示：
- 本文档主要针对开发人员，接入测试前需要获取应用ID和应用密钥，并创建应用；如果您还没有，请按照 新手指南 获取。
- 平台向每个账户赠送50元的体验金，供用户集成前测试所用。
协议须知
调用方在集成数字人视频翻译API时，请遵循以下规则。
使用mp4视频数据
Content-Type: application/x-www-form-urlencoded
接口调用参数
数字人-视频翻译线上调用地址：
baseUrl:
<https://openapi.youdao.com/sampling_digital_human/paas/trans>
准备上传接口
1、接口说明：
文件准备上传接口
2、地址：
POST请求: baseUrl + /prepare
| 字段名 | 含义 | 备注 | 必填 |
|---|---|---|---|
| appKey | 应用标识（应用 ID） | 可在应用管理 查看 | true |
| curtime | 当前时间戳(秒) | 当前UTC时间戳(秒) | true |
| salt | 随机字符串 | 随机字符串，可使用UUID进行生产 | true |
| sign | 签名信息：sha256(appKey+salt+curtime+密钥) | true | |
| signType | 签名类型 | v4 | true |
| fileName | 文件名称 | 最长不超过200字符 | true |
| from | 源语言语种 | 中：zh-CHS、英：en | true |
| to | 目标语言语种 | 中：zh-CHS、英：en | true |
| format | 文件格式 | mp4 | true |
| sliceNum | 文件分片数目 | 建议分片大小为10M-80M。取值范围：1~300 | true |
| fileSize | 文件大小 | 注意：文件大小限制为300M,取值范围为：1024-314572800 byte | true |
签名生成方法如下： signType=v4； sign=sha256(应用ID+salt+curtime+应用密钥)；
返回结果：
| 参数名称 | 描述 | 类型 |
|---|---|---|
| errorCode | 错误码 | text |
| msg | 描述 | text |
| requestId | 请求id | text |
| result | 结果 | |
| +transId | 任务ID | text |
分片上传接口
1、接口说明：
采用multipart方式分片上传。
- Content-Type: multipart/form-data
2、地址：
POST请求: baseUrl + /upload
| 字段名 | 含义 | 备注 | 必填 |
|---|---|---|---|
| appKey | 应用标识（应用 ID） | 可在应用管理 查看 | true |
| curtime | 当前时间戳(秒) | 当前UTC时间戳(秒) | true |
| q | 任务ID | true | |
| salt | 随机字符串 | 随机字符串，可使用UUID进行生产 | true |
| sign | 签名信息：sha256(appKey+salt+curtime+密钥) | true | |
| signType | 签名类型 | v4 | true |
| sliceId | 当前分片id。取值范围：1~300 | 取值从1开始 | true |
| file | multipartFile视频文件分片 | 分片大小不能大于100M | true |
签名生成方法如下： signType=v4； sign=sha256(应用ID+salt+curtime+应用密钥)；
3、返回结果：
| 参数名称 | 描述 | 类型 |
|---|---|---|
| errorCode | 错误码 | text |
| msg | 描述 | text |
| result | 结果 |
分片合并接口
1、接口说明：
视频分片数据合并, 当所有分片上传完成时调用。
2、地址：
POST请求: baseUrl + /merge
| 字段名 | 含义 | 备注 | 必填 |
|---|---|---|---|
| appKey | 应用标识（应用 ID） | 可在应用管理 查看 | true |
| curtime | 当前时间戳(秒) | 当前UTC时间戳(秒) | true |
| q | 任务ID | true | |
| salt | 随机字符串 | 随机字符串，可使用UUID进行生产 | true |
| sign | 签名信息：sha256(appKey+salt+curtime+密钥) | true | |
| signType | 签名类型 | v4 | true |
签名生成方法如下： signType=v4； sign=sha256(应用ID+salt+curtime+应用密钥)；
3、返回结果：
| 参数名称 | 描述 | 类型 |
|---|---|---|
| errorCode | 错误码 | text |
| msg | 描述 | text |
| result | 结果 |
获取翻译进度接口
1、接口说明：
获取翻译任务实时进度。
2、地址：
POST请求: baseUrl + /get_progress
| 字段名 | 含义 | 备注 | 必填 |
|---|---|---|---|
| appKey | 应用标识（应用 ID） | 可在应用管理 查看 | true |
| curtime | 当前时间戳(秒) | 当前UTC时间戳(秒) | true |
| q | 任务ID | true | |
| salt | 随机字符串 | 随机字符串，可使用UUID进行生产 | true |
| sign | 签名信息：sha256(appKey+salt+curtime+密钥) | true | |
| signType | 签名类型 | v4 | true |
签名生成方法如下： signType=v4； sign=sha256(应用ID+salt+curtime+应用密钥)；
3、返回结果：
| 参数名称 | 描述 | 类型 |
|---|---|---|
| errorCode | 错误码 | text |
| msg | 描述 | text |
| result | 结果 | |
| +transId | 任务ID | text |
| +status | 任务状态 | text |
status取值：
| status | 含义 |
|---|---|
| 0 | 任务创建 |
| 1 | 视频数据上传完成 |
| 2 | 翻译任务处理中 |
| 3 | 上传数据不合法 |
| 4 | 翻译失败 |
| 5 | 翻译成功,可获取结果视频资源 |
获取处理结果接口
1、接口说明：
获取任务结果。
注：结果视频仅保存7天
2、地址：
POST请求: baseUrl + /get_result
| 字段名 | 含义 | 备注 | 必填 |
|---|---|---|---|
| appKey | 应用标识（应用 ID） | 可在应用管理 查看 | true |
| curtime | 当前时间戳(秒) | 当前UTC时间戳(秒) | true |
| q | 任务ID | true | |
| salt | 随机字符串 | 随机字符串，可使用UUID进行生产 | true |
| sign | 签名信息：sha256(appKey+salt+curtime+密钥) | sfgagg | true |
| signType | 签名类型 | v4 | true |
签名生成方法如下： signType=v4； sign=sha256(应用ID+salt+curtime+应用密钥)；
3、返回结果：
| 参数名称 | 描述 | 类型 |
|---|---|---|
| errorCode | 错误码 | text |
| msg | 描述 | text |
| result | 结果 | |
| +transId | 任务ID | text |
| +url | 翻译视频URL地址, 仅7天内有效 | text |
错误代码列表
| 状态码 | 状态码含义 |
|---|---|
| 101 | 缺少必填的参数，首先确保必填参数齐全，然后，确认参数书写是否正确。 |
| 102 | 不支持的语言类型 |
| 103 | 翻译文本过长 |
| 104 | 不支持的API类型 |
| 105 | 不支持的签名类型 |
| 106 | 不支持的响应类型 |
| 107 | 不支持的传输加密类型 |
| 108 | 应用ID无效，注册账号，登录后台创建应用并完成绑定，可获得应用ID和应用密钥等信息 |
| 109 | batchLog格式不正确 |
| 110 | 无相关服务的有效应用，应用没有绑定服务。注：某些服务的结果发音需要tts服务，需要在控制台创建语音合成实例绑定应用后方能使用。 |
| 111 | 开发者账号无效 |
| 112 | 请求服务无效 |
| 113 | q不能为空 |
| 114 | 不支持的图片传输方式 |
| 201 | 解密失败，可能为DES,BASE64,URLDecode的错误 |
| 202 | 签名检验失败，如果确认应用ID和应用密钥的正确性，仍返回202，一般是编码问题。请确保翻译文本 q 为UTF-8编码. |
| 203 | 访问IP地址不在可访问IP列表 |
| 205 | 请求的接口与应用的平台类型不一致，确保接入方式（Android SDK、IOS SDK、API）与创建的应用平台类型一致。如有疑问请参考入门指南 |
| 206 | 因为时间戳无效导致签名校验失败 |
| 207 | 重放请求 |
| 303 | 服务异常 |
| 405 | 鉴权失败 |
| DH10005 | 任务ID错误 |
| DH10010 | 文件下载失败 |
| DH10021 | 数据格式不合法 |
| DH10022 | 上传失败 |
| DH10023 | 上传文件数据不匹配 |
| DH10024 | 请求参数不合法 |
| DH10025 | 上传文件过大 |
| DH10026 | 非法的参数取值范围 |