
如何快速實(shí)現(xiàn)REST API集成以優(yōu)化業(yè)務(wù)流程
填寫應(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ǔ)言種類,就可以得到相應(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ù)。
字段名 | 類型 | 含義 | 必填 | 備注 |
---|---|---|---|---|
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 | 簽名類型 | 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 | 用戶上傳的術(shù)語(yǔ)表 | false | 用戶指定的術(shù)語(yǔ)表ID: out_id,支持英中互譯,更多語(yǔ)種方向請(qǐng)前往控制臺(tái)查詢 |
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ǔ)表,選擇新建,填寫表名稱和語(yǔ)言方向,添加需要的術(shù)語(yǔ)表,然后獲取對(duì)應(yīng)詞表id即可。
對(duì)專業(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ō)明如下:
字段名 | 類型 | 含義 | 備注 |
---|---|---|---|
errorCode | text | 錯(cuò)誤返回碼 | 一定存在 |
query | text | 源語(yǔ)言 | 查詢正確時(shí),一定存在 |
translation | Array | 翻譯結(jié)果 | 查詢正確時(shí),一定存在 |
l | text | 源語(yǔ)言和目標(biāo)語(yǔ)言 | 一定存在 |
dict | text | 詞典deeplink | 查詢語(yǔ)種為支持語(yǔ)言時(shí),存在 |
webdict | text | webdeeplink | 查詢語(yǔ)種為支持語(yǔ)言時(shí),存在 |
tSpeakUrl | text | 翻譯結(jié)果發(fā)音地址 | 翻譯成功一定存在,需要應(yīng)用綁定語(yǔ)音合成服務(wù)才能正常播放 否則返回110錯(cuò)誤碼 |
speakUrl | text | 源語(yǔ)言發(fā)音地址 | 翻譯成功一定存在,需要應(yīng)用綁定語(yǔ)音合成服務(wù)才能正常播放 否則返回110錯(cuò)誤碼 |
使用good單詞查詢作為示例進(jìn)行說(shuō)明:
輸出結(jié)果與FROM和TO的值有關(guān):
1. 當(dāng)FROM和TO的值都在{zh-CHS, EN}范圍內(nèi)時(shí)
{
"errorCode":"0",
"query":"good", //查詢正確時(shí),一定存在
"isDomainSupport":"true", //翻譯結(jié)果是否為領(lǐng)域翻譯(僅開(kāi)通領(lǐng)域翻譯時(shí)存在)
"translation": [ //查詢正確時(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" //查詢文本的發(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" //查詢文本的發(fā)音地址
}
Q:如何找到網(wǎng)易有道 API
A:冪簡(jiǎn)集成是國(guó)內(nèi)領(lǐng)先的API集成管理平臺(tái),專注于為開(kāi)發(fā)者提供全面、高效、易用的API集成解決方案。冪簡(jiǎn)API平臺(tái)可以通過(guò)以下兩種方式找到所需API:通過(guò)關(guān)鍵詞搜索API(例如,輸入’網(wǎng)易有道 API‘這類品類詞,更容易找到結(jié)果)、或者從API hub分類頁(yè)進(jìn)入尋找。
Q:實(shí)時(shí)語(yǔ)音翻譯是否有時(shí)長(zhǎng)限制?
A:實(shí)時(shí)語(yǔ)音翻譯沒(méi)有時(shí)長(zhǎng)限制,客戶端在建立連接后傳輸數(shù)據(jù),可以一直保持連接直至欠費(fèi);如果建立連接后,沒(méi)有傳輸數(shù)據(jù),15s后會(huì)被斷開(kāi)。
Q:實(shí)時(shí)語(yǔ)音翻譯可以同時(shí)連接的鏈路數(shù)是多少?
A:默認(rèn)為每位用戶配置10路,如果需要更大配置,請(qǐng)郵件聯(lián)系我們 AIcloud_Business@corp.youdao.com 。
Q:實(shí)時(shí)語(yǔ)音翻譯支持的音頻文件類型是什么?
A:當(dāng)前支持wav音頻格式。
Q:實(shí)時(shí)語(yǔ)音翻譯支持多少種翻譯模式?各模式分別適合什么類型應(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ù)商也提供類似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)用的性能提升和用戶體驗(yàn)優(yōu)化。我們期待每一位開(kāi)發(fā)者都能充分利用網(wǎng)易有道API開(kāi)放平臺(tái)的資源,共同推動(dòng)數(shù)字化轉(zhuǎn)型的浪潮。
對(duì)比大模型API的內(nèi)容創(chuàng)意新穎性、情感共鳴力、商業(yè)轉(zhuǎn)化潛力
一鍵對(duì)比試用API 限時(shí)免費(fèi)