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