五月天综合,欧美一区二区三区在线观看视频,久久中文字幕乱码久久午夜加勒比 ,亚洲一区 视频 在线

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

文本翻譯 API 簡介

概念解釋

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

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

說明

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

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

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

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

如果您對(duì)文檔內(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

溫馨提示：

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

接口說明

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

文本翻譯API HTTPS地址：

https://openapi.youdao.com/api

協(xié)議須知

調(diào)用方在集成文本翻譯API時(shí)，請(qǐng)遵循以下規(guī)則。

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

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

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

字段名 類型 含義 必填 備注
q text 待翻譯文本 True 必須是UTF-8編碼
from text 源語言 True 參考下方 支持語言 (可設(shè)置為auto)
to text 目標(biāo)語言 True 參考下方 支持語言
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ù)語表 false 用戶指定的術(shù)語表ID： out_id，支持英中互譯，更多語種方向請(qǐng)前往控制臺(tái)查詢
domain text 領(lǐng)域化翻譯 false 默認(rèn)為：general。僅在控制臺(tái)開通領(lǐng)域化翻譯的情況下可傳，支持領(lǐng)域見下表
rejectFallback text 拒絕領(lǐng)域化翻譯降級(jí)-當(dāng)領(lǐng)域化翻譯失敗時(shí)改為通用翻譯 false true或false，默認(rèn)為：false。僅在控制臺(tái)開通領(lǐng)域化翻譯的情況生效。

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

注意：

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

不同語言獲取時(shí)間戳，請(qǐng)參看此鏈接

如果對(duì)簽名有疑問，可以參看各語言demo。

用戶術(shù)語表使用

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

領(lǐng)域模型使用

對(duì)專業(yè)或者學(xué)術(shù)有要求的翻譯場景，開通方式如下： 登錄控制臺(tái)，選擇文本翻譯服務(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)，具體說明如下：

字段名 類型 含義 備注
errorCode text 錯(cuò)誤返回碼 一定存在
query text 源語言 查詢正確時(shí)，一定存在
translation Array 翻譯結(jié)果 查詢正確時(shí)，一定存在
l text 源語言和目標(biāo)語言 一定存在
dict text 詞典deeplink 查詢語種為支持語言時(shí)，存在
webdict text webdeeplink 查詢語種為支持語言時(shí)，存在
tSpeakUrl text 翻譯結(jié)果發(fā)音地址 翻譯成功一定存在，需要應(yīng)用綁定語音合成服務(wù)才能正常播放
否則返回110錯(cuò)誤碼
speakUrl text 源語言發(fā)音地址 翻譯成功一定存在，需要應(yīng)用綁定語音合成服務(wù)才能正常播放
否則返回110錯(cuò)誤碼

示例

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

輸出結(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)域翻譯(僅開通領(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": ["大丈夫です"], //小語種翻譯，一定存在
   "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ā)音地址
}

支持語言

下表為各語言對(duì)應(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
自動(dòng)識(shí)別 auto

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

服務(wù)配置

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

錯(cuò)誤代碼列表

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

版本更新記錄

上線日期 版本號(hào) 更新內(nèi)容
2019.04.22 v1.0.0 新增中文與意大利文、英文與日文互譯；新增單詞校驗(yàn)邏輯，對(duì)于輸入單詞大小寫混合返回小寫單詞、單詞前面存在符號(hào)時(shí)返回去符號(hào)單詞、中文繁體返回純簡體內(nèi)容。
2023.05.11 v2.0.0 更新多語言示例 demo及下載鏈接
2024.04.22 v3.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ā)語言請(qǐng)參照 接口API文檔 進(jìn)行開發(fā)，也歡迎企業(yè)咨詢來提出你們需要的demo。

JS demo


<!doctype html>
<head>
    <meta charset="utf-8"/>
</head>
<body>
<div>可打開瀏覽器控制臺(tái)查看結(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)險(xiǎn)
var salt = (new Date).getTime();
var curtime = Math.round(new Date().getTime()/1000);
var query = '您好，歡迎再次使用有道智云文本翻譯API接口服務(wù)';
// 多個(gè)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>