API文档

产品定价

Hi,您好,欢迎使用有道智云同声传译接口服务。
本文档主要针对需要集成HTTP API的技术开发工程师,详细描述同声传译相关的技术内容。
如果您有与我们商务合作的需求,可以通过以下方式联系我们:
商务邮箱: AIcloud_Business@corp.youdao.com
如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:
客服QQ:1906538062
智云翻译技术交流QQ 3群: 807539209
智云翻译技术交流QQ 4群: 936752411
联系邮箱: zhiyun@corp.youdao.com
温馨提示:
同声传译能力:支持输入音频,然后输出音频语音转文本结果(STT)、文本翻译结果(TRANS)、翻译的语音结果(TTS)
同声传译API调用地址:
https://openapi.youdao.com
/speech-stream-server/simultaneous_interpretation?{请求参数}
POST,websocket
服务接口的调用分为认证、实时通信两阶段。
请求参数格式(url参数): key1=value1&key2=value2&key3=value3&key4=value4
参数名 | 参数类型 | 是否必填 | 描述 | 示例 |
---|---|---|---|---|
appKey | String | 是 | 已申请的应用ID | ID |
salt | String | 是 | UUID | uuid,唯一通用识别码 |
curtime | String | 是 | 时间戳(秒) | TimeStamp |
sign | String | 是 | 加密数字签名。 | sha256 |
signType | String | 是 | 数字签名类型 | 固定v3 |
osType | String | 是 | 调用类型 | 固定api |
source | String | 是 | 语言选择,参考支持语言列表 | en |
target | String | 是 | 语言选择,参考支持语言列表 | zh-CHS |
签名sign生成方法如下: signType=v3; sign=sha256(应用ID+salt+curtime+应用密钥)。
服务端通过 text message 返回 json字符串的认证结果,参数示例:
成功:
{
// 错误码
"errorCode": 0,
// 消息
"message": "SUCCESS"
}
失败:
{
// 错误码
"errorCode": 10001,
// 消息
"message": "UN_SUPPORT_STT"
}
2.1 发送音频流
目前仅支持wav
的音频格式,音频格式为16k
采样率,单声道。
认证成功之后,进入实时通信阶段,此阶段客户端发送音频流和结束标识,并接收转写结果或错误。
此阶段客户端通过 binary message
发送音频流,内容为音频的二进制数据,此过程的发送频率将影响文字结果展示的实时性。
建议以 200ms 间隔发送音频数据,若间隔超时 15s 以上,服务端将停止识别。
2.2 接收转写结果
交互过程中,服务端不断通过 text message 返回实时识别结果到客户端,响应结果是以json形式输出(为text message)。
返回的音频格式为mp3
{
"errorCode": 0,
"message": "SUCCESS",
"data": {
// trans:翻译;stt:输入语音转文字;tts:翻译文本转语音
"type": "stt",
// 当前类型的文本结果或者base64结果,文本以全量的形式返回,音频为增量
"text": "我是stt的结果",
// 表示是否最后一句话
"sentEnd": false
}
}
语言 | code |
---|---|
印地语 | hi |
葡萄牙语 | pt |
匈牙利语 | hu |
意大利语 | it |
阿拉伯语 | ar |
日语 | ja |
俄语 | ru |
加泰隆语 | ca |
韩语 | ko |
捷克语 | cs |
丹麦语 | da |
德语 | de |
简体中文 | zh-CHS |
希腊语 | el |
英语 | en |
西班牙语 | es |
越南语 | vi |
荷兰语 | nl |
芬兰语 | fi |
粤语 | yue |
法语 | fr |
希伯来语 | he |
错误码 | 错误描述 |
---|---|
101 | 缺少必填的参数,首先确保必填参数齐全,然后,确认参数书写是否正确。 |
102 | 不支持的语言类型 |
103 | 翻译文本过长 |
104 | 不支持的API类型 |
105 | 不支持的签名类型 |
106 | 不支持的响应类型 |
107 | 不支持的传输加密类型 |
108 | 应用ID无效,注册账号,登录后台创建应用和实例并完成绑定,可获得应用ID和应用密钥等信息 |
109 | batchLog格式不正确 |
110 | 无相关服务的有效实例,应用没有绑定服务。注:某些服务的结果发音需要tts,需要在控制台创建语音合成绑定应用后方能使用。 |
111 | 开发者账号无效 |
112 | 请求服务无效 |
113 | q不能为空 |
201 | 解密失败,可能为DES,BASE64,URLDecode的错误 |
202 | 签名检验失败 |
203 | 访问IP地址不在可访问IP列表 |
205 | 请求的接口与应用的平台类型不一致,确保接入方式(Android SDK、IOS SDK、API)与创建的应用平台类型一致。 |
206 | 因为时间戳无效导致签名校验失败 |
207 | 重放请求 |
303 | 服务端的其它异常 |
401 | 账户已经欠费停 |
402 | offlinesdk不可用 |
403 | 无权限 |
404 | 资源不存在 |
405 | auth服务不可用 |
411 | 访问频率受限,请稍后访问 |
412 | 超过最大翻译字符数 |
500 | 系统错误 |
10001 | 不支持的语音转文本引擎 |
10002 | 不支持的文本转语音引擎 |
10003 | 不支持的翻译引擎 |
10004 | 不支持的语言 |
20001 | 语音转文本引擎调用失败 |
30001 | session会话超时(15s无消息) |