五月天综合,亚洲午夜久久久精品影院,天天做天天爱天天综合网2021,无码人妻精品一区二区蜜桃网站

幫助與文檔 > 產(chǎn)品文檔 > 自然語言翻譯服務(wù) > API文檔 > 文本翻譯
文本翻譯

文本翻譯 API 簡介

概念解釋

文本翻譯:將一段源語言文本轉(zhuǎn)換成目標(biāo)語言文本,可根據(jù)語言參數(shù)的不同實(shí)現(xiàn)多國語言之間的互譯。

智云上線了領(lǐng)域化翻譯,目前支持領(lǐng)域有計(jì)算機(jī)、金融、醫(yī)學(xué)和游戲四個領(lǐng)域;支持語種是中英雙向;

說明

Hi,您好,歡迎使用有道智云文本翻譯API接口服務(wù)。如果您想快速體驗(yàn)服務(wù),建議您前往翻譯體驗(yàn)中心 或者在體驗(yàn)中心右下側(cè)找到小程序二維碼,掃描進(jìn)行體驗(yàn)。

本文檔主要針對需要集成HTTP API的技術(shù)開發(fā)工程師,詳細(xì)描述文本翻譯能力相關(guān)的技術(shù)內(nèi)容。

如果您有與我們商務(wù)合作的需求,可以通過以下方式聯(lián)系我們:

商務(wù)郵箱: AIcloud_Business@corp.youdao.com

如果您對文檔內(nèi)容有任何疑問,可以通過以下幾種方式聯(lián)系我們:

客服QQ:1906538062

智云翻譯技術(shù)交流QQ 1群: 652880659

智云翻譯技術(shù)交流QQ 2群: 669384425

智云翻譯技術(shù)交流QQ 3群: 807539209

智云翻譯技術(shù)交流QQ 4群: 936752411

聯(lián)系郵箱: zhiyun@corp.youdao.com

溫馨提示:

  • 本文檔主要針對開發(fā)人員,接入測試前需要獲取 應(yīng)用ID應(yīng)用密鑰 ,請按照新手指南 獲取。
  • 平臺向每個賬戶贈送50元的體驗(yàn)金,供用戶集成前測試所用,具體資費(fèi)規(guī)則詳見 文本翻譯服務(wù)報價 。

接口說明

文本翻譯API接口提供有道的翻譯服務(wù),包含了中英翻譯和小語種翻譯功能。您只需要通過調(diào)用文本翻譯API,傳入待翻譯的內(nèi)容,并指定要翻譯的源語言(支持源語言語種自動檢測)和目標(biāo)語言種類,就可以得到相應(yīng)的翻譯結(jié)果。

文本翻譯API HTTPS地址:

https://openapi.youdao.com/api

協(xié)議須知

調(diào)用方在集成文本翻譯API時,請遵循以下規(guī)則。

規(guī)則描述
傳輸方式HTTPS
請求方式GET/POST
字符編碼統(tǒng)一使用UTF-8 編碼
請求格式表單
響應(yīng)格式JSON

接口調(diào)用參數(shù)

調(diào)用API需要向接口發(fā)送以下字段來訪問服務(wù)。

字段名類型含義必填備注
qtext待翻譯文本True必須是UTF-8編碼
fromtext源語言True參考下方 支持語言 (可設(shè)置為auto)
totext目標(biāo)語言True參考下方 支持語言
appKeytext應(yīng)用IDTrue可在應(yīng)用管理 查看
salttext隨機(jī)字符串,可使用UUID進(jìn)行生產(chǎn)Trueuuid (可使用uuid生成)
signtext簽名Truesha256(應(yīng)用ID+input+salt+curtime+應(yīng)用密鑰)
signTypetext簽名類型Truev3
curtimetext當(dāng)前UTC時間戳(秒)trueTimeStamp
exttext翻譯結(jié)果音頻格式,支持mp3falsemp3
voicetext翻譯結(jié)果發(fā)音選擇false0為女聲,1為男聲。默認(rèn)為女聲
stricttext是否嚴(yán)格按照指定from和to進(jìn)行翻譯:true/falsefalse如果為false,則會自動中譯英,英譯中。默認(rèn)為false
vocabIdtext用戶上傳的術(shù)語表false用戶指定的術(shù)語表ID: out_id,支持英中互譯,更多語種方向請前往控制臺查詢
domaintext領(lǐng)域化翻譯false默認(rèn)為:general。僅在控制臺開通領(lǐng)域化翻譯的情況下可傳,支持領(lǐng)域見下表
rejectFallbacktext拒絕領(lǐng)域化翻譯降級-當(dāng)領(lǐng)域化翻譯失敗時改為通用翻譯falsetrue或false,默認(rèn)為:false。僅在控制臺開通領(lǐng)域化翻譯的情況生效。

簽名生成方法如下:
signType=v3;
sign=sha256(應(yīng)用ID+input+salt+curtime+應(yīng)用密鑰);
其中,input的計(jì)算方式為:input=q前10個字符 + q長度 + q后10個字符(當(dāng)q長度大于20)或 input=q字符串(當(dāng)q長度小于等于20);

注意:

  1. voice 沒有男聲的,會輸出女聲。
  2. 發(fā)音需要在控制臺創(chuàng)建tts實(shí)例,并綁定應(yīng)用才能使用,否則點(diǎn)擊發(fā)音會報110錯誤。
  3. 接口salt+curtime來防重放(即一個請求不可以被請求2次),所以salt最好為UUID。

不同語言獲取時間戳,請參看此鏈接

如果對簽名有疑問,可以參看各語言demo。

用戶術(shù)語表使用

登錄控制臺,選擇文本翻譯服務(wù),點(diǎn)擊右側(cè)的術(shù)語表,選擇新建,填寫表名稱和語言方向,添加需要的術(shù)語表,然后獲取對應(yīng)詞表id即可。

領(lǐng)域模型使用

對專業(yè)或者學(xué)術(shù)有要求的翻譯場景,開通方式如下:
登錄控制臺,選擇文本翻譯服務(wù),勾選下面的領(lǐng)域翻譯服務(wù),點(diǎn)擊保存即可開通使用。

模型支持的領(lǐng)域

取值含義
general通用(默認(rèn)取值)
computers計(jì)算機(jī)
medicine醫(yī)學(xué)
finance金融經(jīng)濟(jì)
game游戲
  • 注:目前非通用翻譯只支持中英互譯

輸出結(jié)果

返回的結(jié)果是json格式,包含字段與FROM和TO的值有關(guān),具體說明如下:

字段名類型含義備注
errorCodetext錯誤返回碼一定存在
querytext源語言查詢正確時,一定存在
translationArray翻譯結(jié)果查詢正確時,一定存在
ltext源語言和目標(biāo)語言一定存在
dicttext詞典deeplink查詢語種為支持語言時,存在
webdicttextwebdeeplink查詢語種為支持語言時,存在
tSpeakUrltext翻譯結(jié)果發(fā)音地址翻譯成功一定存在,需要應(yīng)用綁定語音合成服務(wù)才能正常播放
否則返回110錯誤碼
speakUrltext源語言發(fā)音地址翻譯成功一定存在,需要應(yīng)用綁定語音合成服務(wù)才能正常播放
否則返回110錯誤碼

示例

使用good單詞查詢作為示例進(jìn)行說明:

輸出結(jié)果與FROM和TO的值有關(guān):

1. 當(dāng)FROM和TO的值都在{zh-CHS, EN}范圍內(nèi)時

{
  "errorCode":"0",
  "query":"good", //查詢正確時,一定存在
  "isDomainSupport":"true", //翻譯結(jié)果是否為領(lǐng)域翻譯(僅開通領(lǐng)域翻譯時存在)
  "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",//翻譯后的發(fā)音地址
  "speakUrl": "XXX" //查詢文本的發(fā)音地址
}

2. 當(dāng)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", //翻譯后的發(fā)音地址
   "speakUrl": "XXX"  //查詢文本的發(fā)音地址
}

支持語言

下表為各語言對應(yīng)代碼:

英文名中文名代碼
Arabic阿拉伯語ar
German德語de
English英語en
Spanish西班牙語es
French法語fr
Hindi印地語hi
Indonesian印度尼西亞語id
Italian意大利語it
Japanese日語ja
Korean韓語ko
Dutch荷蘭語nl
Portuguese葡萄牙語pt
Russian俄語ru
hai泰語th
Vietnamese越南語vi
Chinese簡體中文zh-CHS
Chinese繁體中文zh-CHT
Afrikaans南非荷蘭語af
Amharic阿姆哈拉語am
Azeerbaijani阿塞拜疆語az
Belarusian白俄羅斯語be
Bulgarian保加利亞語bg
Bangla孟加拉語bn
Bosnian (Latin)波斯尼亞語bs
Catalan加泰隆語ca
Cebuano宿務(wù)語ceb
Corsican科西嘉語co
Czech捷克語cs
Welsh威爾士語cy
Danish丹麥語da
Greek希臘語el
Esperanto世界語eo
Estonian愛沙尼亞語et
Basque巴斯克語eu
Persian波斯語fa
Finnish芬蘭語fi
Fijian斐濟(jì)語fj
Frisian弗里西語fy
Irish愛爾蘭語ga
Scots蘇格蘭蓋爾語gd
Galician加利西亞語gl
Gujarati古吉拉特語gu
Hausa豪薩語ha
Hawaiian夏威夷語haw
Hebrew希伯來語he
Hindi印地語hi
Croatian克羅地亞語hr
Haitian海地克里奧爾語ht
Hungarian匈牙利語hu
Armenian亞美尼亞語hy
Igbo伊博語ig
Icelandic冰島語is
Javanese爪哇語jw
Georgian格魯吉亞語ka
Kazakh哈薩克語kk
Khmer高棉語km
Kannada卡納達(dá)語kn
Kurdish庫爾德語ku
Kyrgyz柯爾克孜語ky
Latin拉丁語la
Luxembourgish盧森堡語lb
Lao老撾語lo
Lithuanian立陶宛語lt
Latvian拉脫維亞語lv
Malagasy馬爾加什語mg
Maori毛利語mi
Macedonian馬其頓語mk
Malayalam馬拉雅拉姆語ml
Mongolian蒙古語mn
Marathi馬拉地語mr
Malay馬來語ms
Maltese馬耳他語mt
Hmong白苗語mww
Myanmar (Burmese)緬甸語my
Nepali尼泊爾語ne
Dutch荷蘭語nl
Norwegian挪威語no
Nyanja (Chichewa)齊切瓦語ny
Querétaro Otomi克雷塔羅奧托米語otq
Punjabi旁遮普語pa
Polish波蘭語pl
Pashto普什圖語ps
Romanian羅馬尼亞語ro
Sindhi信德語sd
Sinhala (Sinhalese)僧伽羅語si
Slovak斯洛伐克語sk
Slovenian斯洛文尼亞語sl
Samoan薩摩亞語sm
Shona修納語sn
Somali索馬里語so
Albanian阿爾巴尼亞語sq
Serbian (Cyrillic)塞爾維亞語(西里爾文)sr-Cyrl
Serbian (Latin)塞爾維亞語(拉丁文)sr-Latn
Sesotho塞索托語st
Sundanese巽他語su
Swedish瑞典語sv
Kiswahili斯瓦希里語sw
Tamil泰米爾語ta
Telugu泰盧固語te
Tajik塔吉克語tg
Filipino菲律賓語tl
Klingon克林貢語tlh
Tongan湯加語to
Turkish土耳其語tr
Tahitian塔希提語ty
Ukrainian烏克蘭語uk
Urdu烏爾都語ur
Uzbek烏茲別克語uz
Xhosa南非科薩語xh
Yiddish意第緒語yi
Yoruba約魯巴語yo
Yucatec尤卡坦瑪雅語yua
Cantonese (Traditional)粵語yue
Zulu南非祖魯語zu
自動識別auto

注意:
其中auto可以識別中文、英文、日文、韓文、法文、西班牙文、葡萄牙文、俄文、越南文、德文、阿拉伯文、印尼文、意大利文,其他語種無法識別,為提高準(zhǔn)確率,請指定語種。
若列表語言出現(xiàn)不支持的問題,請參考產(chǎn)品定價列表語種互譯的限制

服務(wù)配置

單次查詢最大字符數(shù)每小時最大查詢次數(shù)每小時最大查詢字符數(shù)支持語言
5000100萬120萬詳見語種表

錯誤代碼列表

錯誤碼含義
101缺少必填的參數(shù),首先確保必填參數(shù)齊全,然后確認(rèn)參數(shù)書寫是否正確。
102不支持的語言類型
103翻譯文本過長
104不支持的API類型
105不支持的簽名類型
106不支持的響應(yīng)類型
107不支持的傳輸加密類型
108應(yīng)用ID無效,注冊賬號,登錄后臺創(chuàng)建應(yīng)用并完成綁定,可獲得應(yīng)用ID和應(yīng)用密鑰等信息
109batchLog格式不正確
110無相關(guān)服務(wù)的有效應(yīng)用,應(yīng)用沒有綁定服務(wù)應(yīng)用,可以新建服務(wù)應(yīng)用。注:某些服務(wù)的翻譯結(jié)果發(fā)音需要tts服務(wù),需要在控制臺創(chuàng)建語音合成服務(wù)綁定應(yīng)用后方能使用。
111開發(fā)者賬號無效
112請求服務(wù)無效
113q不能為空
114不支持的圖片傳輸方式
116strict字段取值無效,請參考文檔填寫正確參數(shù)值
201解密失敗,可能為DES,BASE64,URLDecode的錯誤
202簽名檢驗(yàn)失敗,如果確認(rèn)應(yīng)用ID和應(yīng)用密鑰的正確性,仍返回202,一般是編碼問題。請確保翻譯文本 q 為UTF-8編碼.
203訪問IP地址不在可訪問IP列表
205請求的接口與應(yīng)用的平臺類型不一致,確保接入方式(Android SDK、IOS SDK、API)與創(chuàng)建的應(yīng)用平臺類型一致。如有疑問請參考入門指南
206因?yàn)闀r間戳無效導(dǎo)致簽名校驗(yàn)失敗
207重放請求
301辭典查詢失敗
302翻譯查詢失敗
303服務(wù)端的其它異常
304翻譯失敗,請聯(lián)系技術(shù)同學(xué)
308rejectFallback參數(shù)錯誤
309domain參數(shù)錯誤
310未開通領(lǐng)域翻譯服務(wù)
401賬戶已經(jīng)欠費(fèi),請進(jìn)行賬戶充值
402offlinesdk不可用
411訪問頻率受限,請稍后訪問
412長請求過于頻繁,請稍后訪問
1001無效的OCR類型
1002不支持的OCR image類型
1003不支持的OCR Language類型
1004識別圖片過大
1201圖片base64解密失敗
1301OCR段落識別失敗
1411訪問頻率受限
1412超過最大識別字節(jié)數(shù)
2003不支持的語言識別Language類型
2004合成字符過長
2005不支持的音頻文件類型
2006不支持的發(fā)音類型
2201解密失敗
2301服務(wù)的異常
2411訪問頻率受限,請稍后訪問
2412超過最大請求字符數(shù)
3001不支持的語音格式
3002不支持的語音采樣率
3003不支持的語音聲道
3004不支持的語音上傳類型
3005不支持的語言類型
3006不支持的識別類型
3007識別音頻文件過大
3008識別音頻時長過長
3009不支持的音頻文件類型
3010不支持的發(fā)音類型
3201解密失敗
3301語音識別失敗
3302語音翻譯失敗
3303服務(wù)的異常
3411訪問頻率受限,請稍后訪問
3412超過最大請求字符數(shù)
4001不支持的語音識別格式
4002不支持的語音識別采樣率
4003不支持的語音識別聲道
4004不支持的語音上傳類型
4005不支持的語言類型
4006識別音頻文件過大
4007識別音頻時長過長
4201解密失敗
4301語音識別失敗
4303服務(wù)的異常
4411訪問頻率受限,請稍后訪問
4412超過最大請求時長
5001無效的OCR類型
5002不支持的OCR image類型
5003不支持的語言類型
5004識別圖片過大
5005不支持的圖片類型
5006文件為空
5201解密錯誤,圖片base64解密失敗
5301OCR段落識別失敗
5411訪問頻率受限
5412超過最大識別流量
9001不支持的語音格式
9002不支持的語音采樣率
9003不支持的語音聲道
9004不支持的語音上傳類型
9005不支持的語音識別 Language類型
9301ASR識別失敗
9303服務(wù)器內(nèi)部錯誤
9411訪問頻率受限(超過最大調(diào)用次數(shù))
9412超過最大處理語音長度
10001無效的OCR類型
10002不支持的OCR image類型
10004識別圖片過大
10201圖片base64解密失敗
10301OCR段落識別失敗
10411訪問頻率受限
10412超過最大識別流量
11001不支持的語音識別格式
11002不支持的語音識別采樣率
11003不支持的語音識別聲道
11004不支持的語音上傳類型
11005不支持的語言類型
11006識別音頻文件過大
11007識別音頻時長過長,最大支持30s
11201解密失敗
11301語音識別失敗
11303服務(wù)的異常
11411訪問頻率受限,請稍后訪問
11412超過最大請求時長
12001圖片尺寸過大
12002圖片base64解密失敗
12003引擎服務(wù)器返回錯誤
12004圖片為空
12005不支持的識別圖片類型
12006圖片無匹配結(jié)果
13001不支持的角度類型
13002不支持的文件類型
13003表格識別圖片過大
13004文件為空
13301表格識別失敗
15001需要圖片
15002圖片過大(1M)
15003服務(wù)調(diào)用失敗
17001需要圖片
17002圖片過大(1M)
17003識別類型未找到
17004不支持的識別類型
17005服務(wù)調(diào)用失敗

版本更新記錄

上線日期版本號更新內(nèi)容
2019.04.22v1.0.0新增中文與意大利文、英文與日文互譯;新增單詞校驗(yàn)邏輯,對于輸入單詞大小寫混合返回小寫單詞、單詞前面存在符號時返回去符號單詞、中文繁體返回純簡體內(nèi)容。
2023.05.11v2.0.0更新多語言示例 demo及下載鏈接
2024.04.22v3.0.0下線接口內(nèi)相關(guān)的詞典數(shù)據(jù)內(nèi)容

常用語言 Demo

Java 示例

文本翻譯 Java demo

Python3 示例

文本翻譯 python3 demo

C#示例

文本翻譯 c# demo

PHP 示例

文本翻譯 php demo

go 示例

文本翻譯 go demo

注:其他開發(fā)語言請參照 接口API文檔 進(jìn)行開發(fā),也歡迎企業(yè)咨詢來提出你們需要的demo。

JS demo


<!doctype html>
<head>
    <meta charset="utf-8"/>
</head>
<body>
<div>可打開瀏覽器控制臺查看結(jié)果</div>

<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
<script src="https://cdn.bootcdn.net/ajax/libs/crypto-js/4.0.0/crypto-js.js"></script>
<script type="text/javascript">
var appKey = '';
var key = '';//注意:暴露appSecret,有被盜用造成損失的風(fēng)險
var salt = (new Date).getTime();
var curtime = Math.round(new Date().getTime()/1000);
var query = '您好,歡迎再次使用有道智云文本翻譯API接口服務(wù)';
// 多個query可以用\n連接  如 query='apple\norange\nbanana\npear'
var from = 'zh-CHS';
var to = 'en';
var str1 = appKey + truncate(query) + salt + curtime + key;
var vocabId =  '您的用戶詞表ID';
//console.log('---',str1);

var sign = CryptoJS.SHA256(str1).toString(CryptoJS.enc.Hex);
$.ajax({
    url: 'https://openapi.youdao.com/api',
    type: 'post',
    dataType: 'jsonp',
    data: {
        q: query,
        appKey: appKey,
        salt: salt,
        from: from,
        to: to,
        sign: sign,
        signType: "v3",
        curtime: curtime,
        vocabId: vocabId,
    },
    success: function (data) {
        console.log(data);
    } 
});

function truncate(q){
    var len = q.length;
    if(len<=20) return q;
    return q.substring(0, 10) + len + q.substring(len-10, len);
}
</script>
</body>