实时语音翻译 API 简介
概念解释
实时语音翻译:可实现对连续音频流的实时翻译和整句翻译,转换成识别后文本信息并返翻译后文字流。
说明
Hi,您好,欢迎使用有道智云实时语音翻译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元的体验金,供用户集成前测试所用,具体资费规则详见 实时语音翻译服务报价 。
接口说明
接口地址:
wss://openapi.youdao.com/stream_speech_trans?{请求参数}
协议须知
调用方在集成实时语音翻译API时,请遵循以下规则。
规则 | 描述 |
---|---|
传输方式 | WSS |
字符编码 | 统一使用UTF-8编码 |
响应格式 | JSON |
语音格式 | wav(不压缩、pcm编码) |
语音采样率 | 16k |
语音编码 | 16bit位深的单声道 |
接口调用参数
服务接口的调用分为认证、实时通信两阶段。
1 .认证阶段
请求参数格式:
key1=value1&key2=value2&key3=value3&key4=value4
参数说明:
参数 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
appKey | String | 是 | 已申请的应用ID | 应用ID |
salt | String | 是 | UUID | uuid,唯一通用识别码 |
curtime | String | 是 | 时间戳(秒) | 1522292849 |
sign | String | 是 | 签名 | sha256(应用ID + salt + curtime + 应用密钥) |
signType | String | 是 | 数字签名类型 | v4 |
from | String | 是 | 源语言选择 | 参照下方语言表 |
to | String | 是 | 目标语言选择 | 参照下方语言表 |
format | String | 是 | 音频格式,支持wav | wav |
channel | String | 是 | 声道,支持单声道,值为1 | 1 |
version | String | 是 | api版本 | v1 |
rate | String | 是 | 采样率 | 16000 |
transPattern | String | 否 | 支持的翻译模式: 实时语音识别(stream) 整句翻译(sentence) | sentence |
noitn | String | 否 | 强制把阿拉伯数字转为英文单词 (0/1),默认值为0 表示不强制 | 0 |
- 注意:noitn参数只适用于以下语种:中文( zh-CHS ),粤语(yue ),英文( en ),英语(澳大利亚)( en-AUS ),英语(印度)(en-IND ),英语(英国)(en-GBR ),日文( ja ),韩文( ko ),西班牙语( es ),俄语(ru ),阿拉伯语(ar )
签名生成方法如下:
sign=sha256(应用ID
+salt
+curtime
+应用密钥
)。(仅API接入方式的应用有应用密钥)
2. 实时通信阶段
认证成功之后,进入实时通信阶段,此阶段客户端发送音频流和结束标识,并接收转写结果。
2. 2. 1 发送音频流
此阶段客户端通过 binary message 发送音频流,内容为音频的二进制数据,此过程的发送频率将影响文字结果展示的实时性。
建议以 200ms 间隔发送音频数据,若间隔超时 15s 以上,服务端将停止识别。
2. 2. 2 发送结束标识
客户端完成所有音频数据的发送后,需发送一个特殊的 binary message 到服务端作为音频流
发送结束的标识,内容为:
{"end": "true"}
输出结果
认证结果说明
服务端通过 text message 返回 json字符串的认证结果,参数示例:
参数 | 类型 | 说明 |
---|---|---|
errorCode | String | 错误码,详见 错误代码列表 |
action | String | 状态标识,started:握手,recognition:识别,error:错误 |
result | String | 识别结果数据 |
成功:
{
"result": {},
"action": "started",
"errorCode": "0"
}
失败:
{
"result": "{}",
"action": "error",
"errorCode": "202"
}
识别结果说明
交互过程中,服务端不断通过 text message 返回实时识别结果到客户端,响应结果是以json形式输出(为text message)。
识别结果 result 参数说明:
参数 | 含义 | 说明 |
---|---|---|
bg | 分句开始时间 | 单位毫秒/ms (仅简体中文、通用英文、中英混合包括此字段) |
ed | 分句结束时间 | 单位毫秒/ms (仅简体中文、通用英文、中英混合包括此字段) |
partial | 是否是中间结果 | true:中间结果;false:完整句子 |
segId | 分句 id | 从 1 开始递增 |
context | 识别结果 | |
tranContent | 翻译结果 |
识别结果示例:
{
"result": {
"transPattern": "stream",
"segId": 0,
"bg": 60,
"context": "Have a good day.",
"tranContent": "祝你今天愉快。",
"partial": true,
"ed": 840
},
"errorCode": "0",
"action": "recognition"
}
支持的语言表
代码 | 语言 |
---|---|
zh-CHS | 简体中文 |
en | 通用英文 |
enzh | 中英混合 |
ar-IL | 阿拉伯语(以色列) |
ar-JO | 阿拉伯语(约旦) |
ar-AE | 阿拉伯语(阿拉伯联合酋长国) |
ar-BH | 阿拉伯语(巴林) |
ar-DZ | 阿拉伯语(阿尔及利亚) |
ar-SA | 阿拉伯语(沙特阿拉伯) |
ar-IQ | 阿拉伯语(伊拉克) |
ar-KW | 阿拉伯语(科威特) |
ar-MA | 阿拉伯语(摩洛哥) |
ar-TN | 阿拉伯语(突尼斯) |
ar-OM | 阿拉伯语(阿曼) |
ar-PS | 阿拉伯语(巴勒斯坦国) |
ar-QA | 阿拉伯语(卡塔尔) |
ar-LB | 阿拉伯语(黎巴嫩) |
ar-EG | 阿拉伯语(埃及) |
pl | 波兰语(波兰) |
da | 丹麦语(丹麦) |
de | 德语(德国) |
ru | 俄语 |
fr | 法语(法国) |
fr-CA | 法语(加拿大) |
fi | 芬兰语(芬兰) |
ko | 韩语(韩国) |
nl | 荷兰语(荷兰) |
cs | 捷克语(捷克共和国) |
hr | 克罗地亚语(克罗地亚) |
lv | 拉脱维亚语(拉脱维亚) |
ro | 罗马尼亚语(罗马尼亚) |
ms | 马来语(马来西亚) |
pt-BRA | 葡萄牙语(巴西) |
pt | 葡萄牙语(葡萄牙) |
ja | 日语(日本) |
sv | 瑞典语(瑞典) |
te | 泰卢固语(印度) |
ta | 泰米尔语(印度) |
ta-SG | 泰米尔语(新加坡) |
ta-LK | 泰米尔语(斯里兰卡) |
ta-MY | 泰米尔语(马来西亚) |
th | 泰语(泰国) |
tr | 土耳其语(土耳其) |
es | 西班牙语(西班牙) |
es-AR | 西班牙语(阿根廷) |
es-BO | 西班牙语(玻利维亚) |
es-CL | 西班牙语(智利) |
es-COL | 西班牙语(哥伦比亚) |
es-CR | 西班牙语(哥斯达黎加) |
es-EC | 西班牙语(厄瓜多尔) |
es-SV | 西班牙语(萨尔瓦多) |
es-US | 西班牙语(美国) |
es-GT | 西班牙语(危地马拉) |
es-HN | 西班牙语(洪都拉斯) |
es-MEX | 西班牙语(墨西哥) |
es-NI | 西班牙语(尼加拉瓜) |
es-PA | 西班牙语(巴拿马) |
es-PY | 西班牙语(巴拉圭) |
es-PE | 西班牙语(秘鲁) |
es-PR | 西班牙语(波多黎各) |
es-DO | 西班牙语(多米尼加共和国) |
es-UY | 西班牙语(乌拉圭) |
es-VE | 西班牙语(委内瑞拉) |
it | 意大利语(意大利) |
hi | 印地语(印度) |
en-AUS | 英语(澳大利亚) |
en-CA | 英语(加拿大) |
en-GH | 英语(加纳) |
en-GBR | 英语(英国) |
en-IND | 英语(印度) |
en-IE | 英语(爱尔兰) |
en-KE | 英语(肯尼亚) |
en-NZ | 英语(新西兰) |
en-NG | 英语(尼日利亚) |
en-PH | 英语(菲律宾) |
en-SG | 英语(新加坡) |
en-ZAF | 英语(南非) |
en-TZ | 英语(坦桑尼亚) |
en-US | 英语(美国) |
vi | 越南语(越南) |
zh-TWN | 台湾普通话(中国台湾) |
lo | 老挝语(老挝) |
bn | 孟加拉语(孟加拉) |
bn-IN | 孟加拉语(印度) |
tl | 菲律宾语 |
- 注:目标语言不支持 “enzh 中英混合”
服务配置
支持格式 | 免费用户最大支持并发 | 单次最大请求时长(s) | 支持语言 |
---|---|---|---|
wav | 10 | 3600 | 参考支持的语言列表 |
错误代码列表
错误码 | 含义 |
---|---|
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 | 签名检验失败 |
203 | 访问IP地址不在可访问IP列表 |
205 | 请求的接口与应用的平台类型不一致,确保接入方式(Android SDK、IOS SDK、API)与创建的应用平台类型一致。如有疑问请参考入门指南 |
206 | 因为时间戳无效导致签名校验失败 |
207 | 重放请求 |
301 | 辞典查询失败 |
302 | 翻译查询失败 |
303 | 服务端的其它异常 |
304 | 会话闲置太久超时 |
401 | 账户已经欠费停 |
402 | offlinesdk不可用 |
411 | 访问频率受限,请稍后访问 |
412 | 长请求过于频繁,请稍后访问 |
1001 | 无效的OCR类型 |
1002 | 不支持的OCR image类型 |
1003 | 不支持的OCR Language类型 |
1004 | 识别图片过大 |
1201 | 图片base64解密失败 |
1301 | OCR段落识别失败 |
1411 | 访问频率受限 |
1412 | 超过最大识别字节数 |
2003 | 不支持的语言识别Language类型 |
2004 | 合成字符过长 |
2005 | 不支持的音频文件类型 |
2006 | 不支持的发音类型 |
2201 | 解密失败 |
2301 | 服务的异常 |
2411 | 访问频率受限,请稍后访问 |
2412 | 超过最大请求字符数 |
3001 | 不支持的语音格式 |
3002 | 不支持的语音采样率 |
3003 | 不支持的语音声道 |
3004 | 不支持的语音上传类型 |
3005 | 不支持的语言类型 |
3006 | 不支持的识别类型 |
3007 | 识别音频文件过大 |
3008 | 识别音频时长过长 |
3009 | 不支持的音频文件类型 |
3010 | 不支持的发音类型 |
3201 | 解密失败 |
3301 | 语音识别失败 |
3302 | 语音翻译失败 |
3303 | 服务的异常 |
3411 | 访问频率受限,请稍后访问 |
3412 | 超过最大请求字符数 |
4001 | 不支持的语音识别格式 |
4002 | 不支持的语音识别采样率 |
4003 | 不支持的语音识别声道 |
4004 | 不支持的语音上传类型 |
4005 | 不支持的语言类型 |
4006 | 识别音频文件过大 |
4007 | 识别音频时长过长 |
4201 | 解密失败 |
4301 | 语音识别失败 |
4303 | 服务的异常 |
4411 | 访问频率受限,请稍后访问 |
4412 | 超过最大请求时长 |
5001 | 无效的OCR类型 |
5002 | 不支持的OCR image类型 |
5003 | 不支持的语言类型 |
5004 | 识别图片过大 |
5005 | 不支持的图片类型 |
5006 | 文件为空 |
5201 | 解密错误,图片base64解密失败 |
5301 | OCR段落识别失败 |
5411 | 访问频率受限 |
5412 | 超过最大识别流量 |
9001 | 不支持的语音格式 |
9002 | 不支持的语音采样率 |
9003 | 不支持的语音声道 |
9004 | 不支持的语音上传类型 |
9005 | 不支持的语音识别 Language类型 |
9301 | ASR识别失败 |
9303 | 服务器内部错误 |
9411 | 访问频率受限(超过最大调用次数) |
9412 | 超过最大处理语音长度 |
10001 | 无效的OCR类型 |
10002 | 不支持的OCR image类型 |
10004 | 识别图片过大 |
10201 | 图片base64解密失败 |
10301 | OCR段落识别失败 |
10411 | 访问频率受限 |
10412 | 超过最大识别流量 |
11001 | 不支持的语音识别格式 |
11002 | 不支持的语音识别采样率 |
11003 | 不支持的语音识别声道 |
11004 | 不支持的语音上传类型 |
11005 | 不支持的语言类型 |
11006 | 识别音频文件过大 |
11007 | 识别音频时长过长,最大支持30s |
11201 | 解密失败 |
11301 | 语音识别失败 |
11303 | 服务的异常 |
11411 | 访问频率受限,请稍后访问 |
11412 | 超过最大请求时长 |
12001 | 图片尺寸过大 |
12002 | 图片base64解密失败 |
12003 | 引擎服务器返回错误 |
12004 | 图片为空 |
12005 | 不支持的识别图片类型 |
12006 | 图片无匹配结果 |
13001 | 不支持的角度类型 |
13002 | 不支持的文件类型 |
13003 | 表格识别图片过大 |
13004 | 文件为空 |
13301 | 表格识别失败 |
15001 | 需要图片 |
15002 | 图片过大(1M) |
15003 | 服务调用失败 |
17001 | 需要图片 |
17002 | 图片过大(1M) |
17003 | 识别类型未找到 |
17004 | 不支持的识别类型 |
17005 | 服务调用失败 |
版本更新记录
上线日期 | 版本号 | 更新内容 |
---|---|---|
2019.07.09 | v1.0.0 | 有道智云实时语音翻译API上线 |
2019.08.20 | v1.1.0 | 实时语音翻译API所支持语种扩充至86个 |
常用语言Demo
Java 示例
Python3 示例
C#示例
PHP 示例
go 示例
注:其他开发语言请参照 接口API文档 进行开发,也欢迎企业咨询来提出你们需要的demo。