帮助与文档 > 产品文档 > AIGC > API文档 > 数字人视频翻译
数字人视频翻译

数字人-视频翻译简介

说明

Hi,您好,欢迎使用有道智云数字人视频翻译接口服务。

本文档主要针对需要集成HTTP API的技术开发工程师,详细描述数字人视频翻译能力相关的技术内容。

如果您有与我们商务合作的需求,可以通过以下方式联系我们:

商务邮箱: AIcloud_Business@corp.youdao.com

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

客服QQ:1906538062

智云翻译技术交流QQ 1群: 652880659

智云翻译技术交流QQ 2群: 669384425

智云翻译技术交流QQ 3群: 807539209

智云翻译技术交流QQ 4群: 936752411

联系邮箱: 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签名类型v4true
fileName文件名称最长不超过200字符true
from源语言语种中:zh-CHS、英:entrue
to目标语言语种中:zh-CHS、英:entrue
format文件格式mp4true
sliceNum文件分片数目建议分片大小为10M-80M。取值范围:1~300true
fileSize文件大小注意:文件大小限制为300M,取值范围为:1024-314572800 bytetrue

签名生成方法如下:
signType=v4;
sign=sha256(应用ID+salt+curtime+应用密钥);

返回结果:
参数名称描述类型
errorCode错误码text
msg描述text
requestId请求idtext
result结果
+transId任务IDtext

分片上传接口

1、接口说明:

采用multipart方式分片上传。

  • Content-Type: multipart/form-data
2、地址:

POST请求: baseUrl + /upload

字段名含义备注必填
appKey应用标识(应用 ID)可在应用管理 查看true
curtime当前时间戳(秒)当前UTC时间戳(秒)true
q任务IDtrue
salt随机字符串随机字符串,可使用UUID进行生产true
sign签名信息:sha256(appKey+salt+curtime+密钥)true
signType签名类型v4true
sliceId当前分片id。取值范围:1~300取值从1开始true
filemultipartFile视频文件分片分片大小不能大于100Mtrue

签名生成方法如下:
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任务IDtrue
salt随机字符串随机字符串,可使用UUID进行生产true
sign签名信息:sha256(appKey+salt+curtime+密钥)true
signType签名类型v4true

签名生成方法如下:
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任务IDtrue
salt随机字符串随机字符串,可使用UUID进行生产true
sign签名信息:sha256(appKey+salt+curtime+密钥)true
signType签名类型v4true

签名生成方法如下:
signType=v4;
sign=sha256(应用ID+salt+curtime+应用密钥);

3、返回结果:
参数名称描述类型
errorCode错误码text
msg描述text
result结果
+transId任务IDtext
+status任务状态text

status取值:

status含义
0任务创建
1视频数据上传完成
2翻译任务处理中
3上传数据不合法
4翻译失败
5翻译成功,可获取结果视频资源

获取处理结果接口

1、接口说明:

获取任务结果。
注:结果视频仅保存7天

2、地址:

POST请求: baseUrl + /get_result

字段名含义备注必填
appKey应用标识(应用 ID)可在应用管理 查看true
curtime当前时间戳(秒)当前UTC时间戳(秒)true
q任务IDtrue
salt随机字符串随机字符串,可使用UUID进行生产true
sign签名信息:sha256(appKey+salt+curtime+密钥)sfgaggtrue
signType签名类型v4true

签名生成方法如下:
signType=v4;
sign=sha256(应用ID+salt+curtime+应用密钥);

3、返回结果:
参数名称描述类型
errorCode错误码text
msg描述text
result结果
+transId任务IDtext
+url翻译视频URL地址, 仅7天内有效text

状态码

状态码状态码含义
101缺少必填的参数,首先确保必填参数齐全,然后,确认参数书写是否正确。
102不支持的语言类型
103翻译文本过长
104不支持的API类型
105不支持的签名类型
106不支持的响应类型
107不支持的传输加密类型
108应用ID无效,注册账号,登录后台创建应用并完成绑定,可获得应用ID和应用密钥等信息
109batchLog格式不正确
110无相关服务的有效应用,应用没有绑定服务。注:某些服务的结果发音需要tts服务,需要在控制台创建语音合成实例绑定应用后方能使用。
111开发者账号无效
112请求服务无效
113q不能为空
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非法的参数取值范围