雙同聲傳譯
說(shuō)明
Hi,您好,歡迎使用有道智云同聲傳譯接口服務(wù)。
本文檔主要針對(duì)需要集成HTTP API的技術(shù)開(kāi)發(fā)工程師,詳細(xì)描述同聲傳譯相關(guān)的技術(shù)內(nèi)容。
如果您有與我們商務(wù)合作的需求,可以通過(guò)以下方式聯(lián)系我們:
商務(wù)郵箱: AIcloud_Business@corp.youdao.com
如果您對(duì)文檔內(nèi)容有任何疑問(wèn),可以通過(guò)以下幾種方式聯(lián)系我們:
客服QQ:1906538062
智云翻譯技術(shù)交流QQ 3群: 807539209
智云翻譯技術(shù)交流QQ 4群: 936752411
聯(lián)系郵箱: zhiyun@corp.youdao.com
溫馨提示:
- 本文檔主要針對(duì)開(kāi)發(fā)人員,接入測(cè)試前需要獲取應(yīng)用ID和應(yīng)用密鑰;如果您還沒(méi)有,請(qǐng)按照 新手指南 獲取。
- 平臺(tái)向每個(gè)賬戶贈(zèng)送50元的體驗(yàn)金,供用戶集成前測(cè)試所用。
接口說(shuō)明
同聲傳譯能力:支持輸入音頻,然后輸出音頻語(yǔ)音轉(zhuǎn)文本結(jié)果(STT)、文本翻譯結(jié)果(TRANS)、翻譯的語(yǔ)音結(jié)果(TTS)
接口調(diào)用參數(shù)
同聲傳譯API調(diào)用地址:
https://openapi.youdao.com
1)接口地址
/speech-stream-server/simultaneous_interpretation?{請(qǐng)求參數(shù)}
2)請(qǐng)求方式
POST,websocket
3)接口參數(shù)
服務(wù)接口的調(diào)用分為認(rèn)證、實(shí)時(shí)通信兩階段。
1.認(rèn)證階段
請(qǐng)求參數(shù)格式(url參數(shù)): key1=value1&key2=value2&key3=value3&key4=value4
參數(shù)名 |
參數(shù)類型 |
是否必填 |
描述 |
示例 |
appKey |
String |
是 |
已申請(qǐng)的應(yīng)用ID |
ID |
salt |
String |
是 |
UUID |
uuid,唯一通用識(shí)別碼 |
curtime |
String |
是 |
時(shí)間戳(秒) |
TimeStamp |
sign |
String |
是 |
加密數(shù)字簽名。 |
sha256 |
signType |
String |
是 |
數(shù)字簽名類型 |
固定v3 |
osType |
String |
是 |
調(diào)用類型 |
固定api |
source |
String |
是 |
語(yǔ)言選擇,參考支持語(yǔ)言列表 |
en |
target |
String |
是 |
語(yǔ)言選擇,參考支持語(yǔ)言列表 |
zh-CHS |
簽名sign生成方法如下: signType=v3; sign=sha256(應(yīng)用ID+salt+curtime+應(yīng)用密鑰)。
服務(wù)端通過(guò) text message 返回 json字符串的認(rèn)證結(jié)果,參數(shù)示例:
成功:
{
// 錯(cuò)誤碼
"errorCode": 0,
// 消息
"message": "SUCCESS"
}
失敗:
{
// 錯(cuò)誤碼
"errorCode": 10001,
// 消息
"message": "UN_SUPPORT_STT"
}
2.實(shí)時(shí)通信階段
2.1 發(fā)送音頻流
目前僅支持wav
的音頻格式,音頻格式為16k
采樣率,單聲道。
認(rèn)證成功之后,進(jìn)入實(shí)時(shí)通信階段,此階段客戶端發(fā)送音頻流和結(jié)束標(biāo)識(shí),并接收轉(zhuǎn)寫結(jié)果或錯(cuò)誤。
此階段客戶端通過(guò) binary message
發(fā)送音頻流,內(nèi)容為音頻的二進(jìn)制數(shù)據(jù),此過(guò)程的發(fā)送頻率將影響文字結(jié)果展示的實(shí)時(shí)性。
建議以 200ms 間隔發(fā)送音頻數(shù)據(jù),若間隔超時(shí) 15s 以上,服務(wù)端將停止識(shí)別。
2.2 接收轉(zhuǎn)寫結(jié)果
交互過(guò)程中,服務(wù)端不斷通過(guò) text message 返回實(shí)時(shí)識(shí)別結(jié)果到客戶端,響應(yīng)結(jié)果是以json形式輸出(為text message)。
返回的音頻格式為mp3
{
"errorCode": 0,
"message": "SUCCESS",
"data": {
// trans:翻譯;stt:輸入語(yǔ)音轉(zhuǎn)文字;tts:翻譯文本轉(zhuǎn)語(yǔ)音
"type": "stt",
// 當(dāng)前類型的文本結(jié)果或者base64結(jié)果,文本以全量的形式返回,音頻為增量
"text": "我是stt的結(jié)果",
// 表示是否最后一句話
"sentEnd": false
}
}
4)支持的語(yǔ)言
語(yǔ)言 |
code |
印地語(yǔ) |
hi |
葡萄牙語(yǔ) |
pt |
匈牙利語(yǔ) |
hu |
意大利語(yǔ) |
it |
阿拉伯語(yǔ) |
ar |
日語(yǔ) |
ja |
俄語(yǔ) |
ru |
加泰隆語(yǔ) |
ca |
韓語(yǔ) |
ko |
捷克語(yǔ) |
cs |
丹麥語(yǔ) |
da |
德語(yǔ) |
de |
簡(jiǎn)體中文 |
zh-CHS |
希臘語(yǔ) |
el |
英語(yǔ) |
en |
西班牙語(yǔ) |
es |
越南語(yǔ) |
vi |
荷蘭語(yǔ) |
nl |
芬蘭語(yǔ) |
fi |
粵語(yǔ) |
yue |
法語(yǔ) |
fr |
希伯來(lái)語(yǔ) |
he |
錯(cuò)誤代碼列表
錯(cuò)誤碼 |
錯(cuò)誤描述 |
101 |
缺少必填的參數(shù),首先確保必填參數(shù)齊全,然后,確認(rèn)參數(shù)書寫是否正確。 |
102 |
不支持的語(yǔ)言類型 |
103 |
翻譯文本過(guò)長(zhǎng) |
104 |
不支持的API類型 |
105 |
不支持的簽名類型 |
106 |
不支持的響應(yīng)類型 |
107 |
不支持的傳輸加密類型 |
108 |
應(yīng)用ID無(wú)效,注冊(cè)賬號(hào),登錄后臺(tái)創(chuàng)建應(yīng)用和實(shí)例并完成綁定,可獲得應(yīng)用ID和應(yīng)用密鑰等信息 |
109 |
batchLog格式不正確 |
110 |
無(wú)相關(guān)服務(wù)的有效實(shí)例,應(yīng)用沒(méi)有綁定服務(wù)。注:某些服務(wù)的結(jié)果發(fā)音需要tts,需要在控制臺(tái)創(chuàng)建語(yǔ)音合成綁定應(yīng)用后方能使用。 |
111 |
開(kāi)發(fā)者賬號(hào)無(wú)效 |
112 |
請(qǐng)求服務(wù)無(wú)效 |
113 |
q不能為空 |
201 |
解密失敗,可能為DES,BASE64,URLDecode的錯(cuò)誤 |
202 |
簽名檢驗(yàn)失敗 |
203 |
訪問(wèn)IP地址不在可訪問(wèn)IP列表 |
205 |
請(qǐng)求的接口與應(yīng)用的平臺(tái)類型不一致,確保接入方式(Android SDK、IOS SDK、API)與創(chuàng)建的應(yīng)用平臺(tái)類型一致。 |
206 |
因?yàn)闀r(shí)間戳無(wú)效導(dǎo)致簽名校驗(yàn)失敗 |
207 |
重放請(qǐng)求 |
303 |
服務(wù)端的其它異常 |
401 |
賬戶已經(jīng)欠費(fèi)停 |
402 |
offlinesdk不可用 |
403 |
無(wú)權(quán)限 |
404 |
資源不存在 |
405 |
auth服務(wù)不可用 |
411 |
訪問(wèn)頻率受限,請(qǐng)稍后訪問(wèn) |
412 |
超過(guò)最大翻譯字符數(shù) |
500 |
系統(tǒng)錯(cuò)誤 |
10001 |
不支持的語(yǔ)音轉(zhuǎn)文本引擎 |
10002 |
不支持的文本轉(zhuǎn)語(yǔ)音引擎 |
10003 |
不支持的翻譯引擎 |
10004 |
不支持的語(yǔ)言 |
20001 |
語(yǔ)音轉(zhuǎn)文本引擎調(diào)用失敗 |
30001 |
session會(huì)話超時(shí)(15s無(wú)消息) |