填寫(xiě)應(yīng)用信息
點(diǎn)擊確定跳轉(zhuǎn)頁(yè)面后保存應(yīng)用密鑰
文本翻譯API接口提供有道的翻譯服務(wù)，包含了中英翻譯和小語(yǔ)種翻譯功能。您只需要通過(guò)調(diào)用文本翻譯API，傳入待翻譯的內(nèi)容，并指定要翻譯的源語(yǔ)言（支持源語(yǔ)言語(yǔ)種自動(dòng)檢測(cè)）和目標(biāo)語(yǔ)言種類(lèi)，就可以得到相應(yīng)的翻譯結(jié)果。
文本翻譯API HTTPS地址：
https://openapi.youdao.com/api
調(diào)用方在集成文本翻譯API時(shí)，請(qǐng)遵循以下規(guī)則。
| 規(guī)則 | 描述 |
|---|---|
| 傳輸方式 | HTTPS |
| 請(qǐng)求方式 | GET/POST |
| 字符編碼 | 統(tǒng)一使用UTF-8 編碼 |
| 請(qǐng)求格式 | 表單 |
| 響應(yīng)格式 | JSON |
調(diào)用API需要向接口發(fā)送以下字段來(lái)訪問(wèn)服務(wù)。
| 字段名 | 類(lèi)型 | 含義 | 必填 | 備注 |
|---|---|---|---|---|
| q | text | 待翻譯文本 | True | 必須是UTF-8編碼 |
| from | text | 源語(yǔ)言 | True | 參考下方?支持語(yǔ)言?(可設(shè)置為auto) |
| to | text | 目標(biāo)語(yǔ)言 | True | 參考下方?支持語(yǔ)言 |
| appKey | text | 應(yīng)用ID | True | 可在應(yīng)用管理?查看 |
| salt | text | 隨機(jī)字符串，可使用UUID進(jìn)行生產(chǎn) | True | uuid (可使用uuid生成) |
| sign | text | 簽名 | True | sha256(應(yīng)用ID+input+salt+curtime+應(yīng)用密鑰) |
| signType | text | 簽名類(lèi)型 | True | v3 |
| curtime | text | 當(dāng)前UTC時(shí)間戳(秒) | true | TimeStamp |
| ext | text | 翻譯結(jié)果音頻格式，支持mp3 | false | mp3 |
| voice | text | 翻譯結(jié)果發(fā)音選擇 | false | 0為女聲，1為男聲。默認(rèn)為女聲 |
| strict | text | 是否嚴(yán)格按照指定from和to進(jìn)行翻譯：true/false | false | 如果為false，則會(huì)自動(dòng)中譯英，英譯中。默認(rèn)為false |
| vocabId | text | 用戶(hù)上傳的術(shù)語(yǔ)表 | false | 用戶(hù)指定的術(shù)語(yǔ)表ID： out_id，支持英中互譯，更多語(yǔ)種方向請(qǐng)前往控制臺(tái)查詢(xún) |
| domain | text | 領(lǐng)域化翻譯 | false | 默認(rèn)為：general。僅在控制臺(tái)開(kāi)通領(lǐng)域化翻譯的情況下可傳，支持領(lǐng)域見(jiàn)下表 |
| rejectFallback | text | 拒絕領(lǐng)域化翻譯降級(jí)-當(dāng)領(lǐng)域化翻譯失敗時(shí)改為通用翻譯 | false | true或false，默認(rèn)為：false。僅在控制臺(tái)開(kāi)通領(lǐng)域化翻譯的情況生效。 |
簽名生成方法如下：
signType=v3；
sign=sha256(應(yīng)用ID+input+salt+curtime+應(yīng)用密鑰)；
其中，input的計(jì)算方式為：input=q前10個(gè)字符+q長(zhǎng)度+q后10個(gè)字符（當(dāng)q長(zhǎng)度大于20）或input=q字符串（當(dāng)q長(zhǎng)度小于等于20）；
注意：
不同語(yǔ)言獲取時(shí)間戳，請(qǐng)參看此鏈接
如果對(duì)簽名有疑問(wèn)，可以參看各語(yǔ)言demo。
登錄控制臺(tái)，選擇文本翻譯服務(wù)，點(diǎn)擊右側(cè)的術(shù)語(yǔ)表，選擇新建，填寫(xiě)表名稱(chēng)和語(yǔ)言方向，添加需要的術(shù)語(yǔ)表，然后獲取對(duì)應(yīng)詞表id即可。
對(duì)專(zhuān)業(yè)或者學(xué)術(shù)有要求的翻譯場(chǎng)景，開(kāi)通方式如下：
登錄控制臺(tái)，選擇文本翻譯服務(wù)，勾選下面的領(lǐng)域翻譯服務(wù)，點(diǎn)擊保存即可開(kāi)通使用。
| 取值 | 含義 |
|---|---|
| general | 通用（默認(rèn)取值） |
| computers | 計(jì)算機(jī) |
| medicine | 醫(yī)學(xué) |
| finance | 金融經(jīng)濟(jì) |
| game | 游戲 |
返回的結(jié)果是json格式，包含字段與FROM和TO的值有關(guān)，具體說(shuō)明如下：
| 字段名 | 類(lèi)型 | 含義 | 備注 |
|---|---|---|---|
| errorCode | text | 錯(cuò)誤返回碼 | 一定存在 |
| query | text | 源語(yǔ)言 | 查詢(xún)正確時(shí)，一定存在 |
| translation | Array | 翻譯結(jié)果 | 查詢(xún)正確時(shí)，一定存在 |
| l | text | 源語(yǔ)言和目標(biāo)語(yǔ)言 | 一定存在 |
| dict | text | 詞典deeplink | 查詢(xún)語(yǔ)種為支持語(yǔ)言時(shí)，存在 |
| webdict | text | webdeeplink | 查詢(xún)語(yǔ)種為支持語(yǔ)言時(shí)，存在 |
| tSpeakUrl | text | 翻譯結(jié)果發(fā)音地址 | 翻譯成功一定存在，需要應(yīng)用綁定語(yǔ)音合成服務(wù)才能正常播放 否則返回110錯(cuò)誤碼 |
| speakUrl | text | 源語(yǔ)言發(fā)音地址 | 翻譯成功一定存在，需要應(yīng)用綁定語(yǔ)音合成服務(wù)才能正常播放 否則返回110錯(cuò)誤碼 |
使用good單詞查詢(xún)作為示例進(jìn)行說(shuō)明：
輸出結(jié)果與FROM和TO的值有關(guān)：
1. 當(dāng)FROM和TO的值都在{zh-CHS, EN}范圍內(nèi)時(shí)
{
"errorCode":"0",
"query":"good", //查詢(xún)正確時(shí)，一定存在
"isDomainSupport":"true", //翻譯結(jié)果是否為領(lǐng)域翻譯(僅開(kāi)通領(lǐng)域翻譯時(shí)存在)
"translation": [ //查詢(xún)正確時(shí)一定存在
"好"
],
"dict":{
"url":"yddict://m.youdao.com/dict?le=eng&q=good"
},
"webdict":{
"url":"http://m.youdao.com/dict?le=eng&q=good"
},
"l":"EN2zh-CHS",
"tSpeakUrl":"XXX",//翻譯后的發(fā)音地址
"speakUrl": "XXX" //查詢(xún)文本的發(fā)音地址
}2. 當(dāng)FROM和TO的值有在{zh-CHS, EN}范圍外的時(shí)候
{
"errorCode": "0",
"translation": ["大丈夫です"], //小語(yǔ)種翻譯，一定存在
"dict":{
"url":"yddict://m.youdao.com/dict?le=jap&q=%E6%B2%A1%E5%85%B3%E7%B3%BB%E3%80%82"
},
"webdict":{
"url":"http://m.youdao.com/dict?le=jap&q=%E6%B2%A1%E5%85%B3%E7%B3%BB%E3%80%82"
},
"l":"zh-CHS2ja",
"tSpeakUrl":"XXX", //翻譯后的發(fā)音地址
"speakUrl": "XXX" //查詢(xún)文本的發(fā)音地址
}Q：如何找到網(wǎng)易有道 API
A：冪簡(jiǎn)集成是國(guó)內(nèi)領(lǐng)先的API集成管理平臺(tái)，專(zhuān)注于為開(kāi)發(fā)者提供全面、高效、易用的API集成解決方案。冪簡(jiǎn)API平臺(tái)可以通過(guò)以下兩種方式找到所需API：通過(guò)關(guān)鍵詞搜索API(例如，輸入’網(wǎng)易有道 API‘這類(lèi)品類(lèi)詞，更容易找到結(jié)果)、或者從API hub分類(lèi)頁(yè)進(jìn)入尋找。
Q：實(shí)時(shí)語(yǔ)音翻譯是否有時(shí)長(zhǎng)限制？
A：實(shí)時(shí)語(yǔ)音翻譯沒(méi)有時(shí)長(zhǎng)限制，客戶(hù)端在建立連接后傳輸數(shù)據(jù)，可以一直保持連接直至欠費(fèi)；如果建立連接后，沒(méi)有傳輸數(shù)據(jù)，15s后會(huì)被斷開(kāi)。
Q：實(shí)時(shí)語(yǔ)音翻譯可以同時(shí)連接的鏈路數(shù)是多少?
A：默認(rèn)為每位用戶(hù)配置10路，如果需要更大配置，請(qǐng)郵件聯(lián)系我們 AIcloud_Business@corp.youdao.com 。
Q：實(shí)時(shí)語(yǔ)音翻譯支持的音頻文件類(lèi)型是什么？
A：當(dāng)前支持wav音頻格式。
Q：實(shí)時(shí)語(yǔ)音翻譯支持多少種翻譯模式？各模式分別適合什么類(lèi)型應(yīng)用場(chǎng)景？
A：當(dāng)前支持兩種翻譯模式：整句翻譯（sentence）、實(shí)時(shí)翻譯（stream）。 整句翻譯是指判斷一句話講完后，返回識(shí)別和翻譯結(jié)果，更適合音頻、視頻字幕場(chǎng)景； 實(shí)時(shí)翻譯是指邊說(shuō)邊翻譯并且邊校正，實(shí)時(shí)動(dòng)態(tài)返回識(shí)別和翻譯結(jié)果，更適合會(huì)議場(chǎng)景。
Q：文檔翻譯的文檔格式有限制嗎？
A：目前文檔翻譯上傳的格式支持docx/pdf/doc/jpg/png/bmp/ppt/pptx，下載的格式支持word/ppt。
除了網(wǎng)易有道 API，還有其他替代服務(wù)商也提供類(lèi)似api服務(wù)，例如：
Publicapis API開(kāi)放平臺(tái)、賽郵 API開(kāi)放平臺(tái)、心知天氣 API開(kāi)放平臺(tái)
更多競(jìng)品可以在冪簡(jiǎn)集成開(kāi)放平臺(tái)中找到。
Q：網(wǎng)易有道 API這個(gè)密鑰還適用于哪些api？
文本翻譯、批量文本翻譯、實(shí)時(shí)語(yǔ)音翻譯
本文精心打造了一份“如何獲取網(wǎng)易有道API開(kāi)放平臺(tái)訪問(wèn)密鑰分步指南”，旨在為開(kāi)發(fā)者們提供一個(gè)全面、詳盡且實(shí)用的操作手冊(cè)。從網(wǎng)易有道API開(kāi)放平臺(tái)賬號(hào)的注冊(cè)，到開(kāi)發(fā)者身份的認(rèn)證，再到最終成功獲取API訪問(wèn)密鑰，每一步都經(jīng)過(guò)精心編排，配以詳盡的說(shuō)明和清晰的指導(dǎo)，確保每位開(kāi)發(fā)者都能輕松上手，順利完成整個(gè)流程。我們深知，獲取密鑰只是第一步，如何高效、穩(wěn)定地應(yīng)用這些API才是關(guān)鍵。因此，本文還特別強(qiáng)調(diào)了獲取密鑰后應(yīng)進(jìn)行API可用性測(cè)試的重要性，以確保API能夠順利集成到應(yīng)用中，并發(fā)揮出最佳效果。通過(guò)這份指南，我們希望能夠助力開(kāi)發(fā)者們順利獲取網(wǎng)易有道API的訪問(wèn)密鑰，并將這一強(qiáng)大的數(shù)據(jù)處理與分析能力有效地集成到應(yīng)用中，從而推動(dòng)應(yīng)用的性能提升和用戶(hù)體驗(yàn)優(yōu)化。我們期待每一位開(kāi)發(fā)者都能充分利用網(wǎng)易有道API開(kāi)放平臺(tái)的資源，共同推動(dòng)數(shù)字化轉(zhuǎn)型的浪潮。