通用翻譯API接入文檔

歡迎使用通用翻譯API，本文檔將指導您如何接入API服務

如何使用通用翻譯API？

使用您的百度賬號登錄百度翻譯開放平臺（http://api.fanyi.baidu.com）；

注冊成為開發者，獲得APPID；

進行開發者認證（如僅需標準版可跳過）；

開通通用翻譯API服務：開通鏈接

參考技術文檔和Demo編寫代碼

接入方式

通用翻譯API通過HTTP接口對外提供多語種互譯服務。您只需要通過調用通用翻譯API，傳入待翻譯的內容，并指定要翻譯的源語言（支持源語言語種自動檢測）和目標語言種類，就可以得到相應的翻譯結果。

通用翻譯API HTTP地址：

http://api.fanyi.baidu.com/api/trans/vip/translate

通用翻譯API HTTPS地址：

https://fanyi-api.baidu.com/api/trans/vip/translate

輸入參數

名稱代碼名稱代碼名稱代碼

自動檢測	auto	中文	zh	英語	en
粵語	yue	文言文	wyw	日語	jp
韓語	kor	法語	fra	西班牙語	spa
泰語	th	阿拉伯語	ara	俄語	ru
葡萄牙語	pt	德語	de	意大利語	it
希臘語	el	荷蘭語	nl	波蘭語	pl
保加利亞語	bul	愛沙尼亞語	est	丹麥語	dan
芬蘭語	fin	捷克語	cs	羅馬尼亞語	rom
斯洛文尼亞語	slo	瑞典語	swe	匈牙利語	hu
繁體中文	cht	越南語	vie	?	?

完整語種列表
中文首字母 名稱 代碼 語種檢測 名稱 代碼 語種檢測 名稱 代碼 語種檢測

A	阿拉伯語	are	是	愛爾蘭語	gle	是	奧克語	oci	是
	阿爾巴尼亞語	alb	是	阿爾及利亞阿拉伯語	arq	否	阿肯語	aka	否
	阿拉貢語	arg	否	阿姆哈拉語	amh	是	阿薩姆語	asm	是
	艾馬拉語	aym	否	阿塞拜疆語	aze	是	阿斯圖里亞斯語	ast	是
	奧塞梯語	oss	否	愛沙尼亞語	est	是	奧杰布瓦語	oji	否
	奧里亞語	ori	是	奧羅莫語	orm	否
B	波蘭語	pl	是	波斯語	per	是	布列塔尼語	bre	是
	巴什基爾語	bak	否	巴斯克語	baq	是	巴西葡萄牙語	pot	否
	白俄羅斯語	bel	是	柏柏爾語	ber	是	邦板牙語	pam	否
	保加利亞語	bul	是	北方薩米語	sme	否	北索托語	ped	否
	本巴語	bem	否	比林語	bli	否	比斯拉馬語	bis	否
	俾路支語	bal	否	冰島語	ice	是	波斯尼亞語	bos	是
	博杰普爾語	bho	否	巴西語	pt_BR	否
C	楚瓦什語	chv	否	聰加語	tso	否
D	丹麥語	dan	是	德語	de	是	韃靼語	tat	是
	撣語	sha	否	德頓語	tet	否	迪維希語	div	否
	低地德語	log	是
E	俄語	ru	是
F	法語	fra	是	菲律賓語	fil	是	芬蘭語	fin	是
	梵語	san	否	弗留利語	fri	否	富拉尼語	ful	否
	法羅語	fao	否
G	蓋爾語	gla	否	剛果語	kon	否	高地索布語	ups	否
	高棉語	hkm	是	格陵蘭語	kal	否	格魯吉亞語	geo	是
	古吉拉特語	guj	是	古希臘語	gra	否	古英語	eno	否
	瓜拉尼語	grn	否
H	韓語	kor	是	荷蘭語	nl	是	胡帕語	hup	否
	哈卡欽語	hak	否	哈薩克語	kaz	是	海地語	ht	否
	豪薩語	hau	否	黑山語	mot	否	海地克里奧爾語	ht	否
J	吉爾吉斯語	kir	否	加利西亞語	glg	是	加拿大法語	frn	否
	加泰羅尼亞語	cat	是	捷克語	cs	是
K	卡拜爾語	kab	是	卡納達語	kan	是	卡努里語	kau	否
	卡舒比語	kah	否	康瓦爾語	cor	否	科薩語	xho	是
	科西嘉語	cos	否	克里克語	cre	否	克里米亞韃靼語	cri	否
	克林貢語	kli	否	克羅地亞語	hrv	是	克丘亞語	que	否
	克什米爾語	kas	否	孔卡尼語	kok	否	庫爾德語	kur	是
L	拉丁語	lat	是	老撾語	lao	否	羅馬尼亞語	rom	是
	拉特加萊語	lag	否	拉脫維亞語	lav	是	林堡語	lim	否
	林加拉語	lin	否	盧干達語	lug	否	盧森堡語	ltz	否
	盧森尼亞語	ruy	否	盧旺達語	kin	是	立陶宛語	lit	是
	羅曼什語	roh	否	羅姆語	ro	否	邏輯語	loj	否
M	馬來語	may	是	緬甸語	bur	是	馬拉地語	mar	否
	馬拉加斯語	mg	是	馬拉雅拉姆語	mal	是	馬其頓語	mac	是
	馬紹爾語	mah	否	邁蒂利語	mai	是	曼克斯語	glv	否
	毛里求斯克里奧爾語	mau	否	毛利語	mao	否	孟加拉語	ben	是
	馬耳他語	mlt	是	蒙語	mon	是	馬拉提語	mr	否
	蒙古語（西里爾）	moc	否	苗語	hmn	否
N	挪威語	nor	是	那不勒斯語	nea	否	南恩德貝萊語	nbl	否
	南非荷蘭語	afr	是	南索托語	sot	否	尼泊爾語	nep	是
P	葡萄牙語	pt	是	旁遮普語	pan	是	帕皮阿門托語	pap	否
	普什圖語	pus	否
Q	齊切瓦語	nya	否	契維語	twi	否	切羅基語	chr	否
R	日語	jp	是	瑞典語	swe	是
S	薩丁尼亞語	srd	否	薩摩亞語	sm	否	塞爾維亞-克羅地亞語	sec	否
	塞爾維亞語	srp	是	桑海語	sol	否	僧伽羅語	sin	是
	世界語	epo	是	書面挪威語	nob	是	斯洛伐克語	sk	是
	斯洛文尼亞語	slo	是	斯瓦希里語	swa	是	蘇格蘭語	sco	否
	索馬里語	som	是	塞茨瓦納語	tn	否	塞爾維亞語（西里爾）	src	否
T	泰語	th	是	土耳其語	tr	是	塔吉克語	tgk	是
	泰米爾語	tam	是	他加祿語	tgl	是	提格利尼亞語	tir	否
	泰盧固語	tel	是	突尼斯阿拉伯語	tua	否	土庫曼語	tuk	否
	塔塔爾語	tt	否
W	烏克蘭語	ukr	是	瓦隆語	wln	是	威爾士語	wel	是
	文達語	ven	否	沃洛夫語	wol	否	烏爾都語	urd	是
	烏茲別克語	uzb	是	維吾爾語	uig	是
X	西班牙語	spa	是	希伯來語	heb	是	希臘語	el	是
	匈牙利語	hu	是	西弗里斯語	fry	是	西里西亞語	sil	否
	希利蓋農語	hil	否	下索布語	los	否	夏威夷語	haw	否
	新挪威語	nno	是	西非書面語	nqo	否	信德語	snd	否
	修納語	sna	否	宿務語	ceb	否	敘利亞語	syr	否
	新增粵語	yus	否	新增普通話	zhs	否	巽他語	sun	否
Y	英語	en	是	印地語	hi	是	印尼語	id	是
	意大利語	it	是	越南語	vie	是	意第緒語	yid	否
	因特語	ina	否	亞齊語	ach	否	印古什語	ing	否
	伊博語	ibo	否	伊多語	ido	否	約魯巴語	yor	否
	亞美尼亞語	arm	是	伊努克提圖特語	iku	否	因紐特語	iu	否
	伊朗語	ir	否
Z	中文(簡體)	zh	是	中文(繁體)	cht	是	中文(文言文)	wyw	是
	中文(粵語)	yue	是	扎扎其語	zaz	否	中古法語	frm	否
	祖魯語	zul	否	爪哇語	jav	否	藏語	tib	否
	宗喀語/不丹語	dzo	是

錯誤碼列表

當翻譯結果無法正常返回時，請參考下表處理：

錯誤碼含義解決方法

52000	成功	?
52001	請求超時	重試
52002	系統錯誤	重試
52003	未授權用戶	請檢查您的appid是否正確，或者服務是否開通
54000	必填參數為空	請檢查是否少傳參數
54001	簽名錯誤	請檢查您的簽名生成方法
54003	訪問頻率受限	請降低您的調用頻率，或進行身份認證后切換為高級版/尊享版
54004	賬戶余額不足	請前往管理控制臺為賬戶充值
54005	長query請求頻繁	請降低長query的發送頻率，3s后再試
58000	客戶端IP非法	檢查個人資料里填寫的IP地址是否正確，可前往開發者信息-基本信息修改，可前往開發者信息-基本信息修改
58001	譯文語言方向不支持	檢查譯文語言是否在語言列表里
58002	服務當前已關閉	請前往管理控制臺開啟服務
90107	認證未通過或未生效	請前往我的認證查看認證進度

詞典、語音合成資源

通用翻譯API默認不提供詞典、語音合成資源。如需使用請先進行企業認證，之后發送郵件至translate_api@baidu.com申請開通詞典或語音合成資源，請注明您的使用場景。
資源開通后，API翻譯結果中將默認附帶dict（詞典）和tts（語音合成）字段，僅對中英、英中互譯有效。
請點擊下載詞典資源接入說明文檔

詞典資源：

詞典分中英詞典，由于每個詞屬性不同，詞典結果不一定包含所有部分。
如源語言為中文，詞典數據包括：拼音、詞性、中文釋義、英文釋義、近義詞等資源。
如源語言為英文，詞典數據包括：英文釋義、中文釋義、音標、核心詞匯類別等。
注：單個query需為詞、詞組或短語，如query為句子，則dict字段為空。

語音合成資源：

語音合成資源包含query原文、譯文的發音，以mp3文件格式提供。
注：單個query內分段數超過3段，或字數超過500字，則tts字段為空。

自定義術語庫

自定義術語庫是百度翻譯最新推出的API增值服務，如果您認為通用翻譯API對于某些術語翻譯不準確，可在“管理控制臺-我的術語庫”頁面填寫您認為正確的原文和譯文，啟用術語庫，并在接口URL增加“&action=1”，即可在翻譯結果中看到干預效果（提交后需等待10分鐘方可生效）。

需要提醒您的是：因翻譯模型并非對術語的一一替換，而是將您填寫的術語翻譯與原翻譯進行對比和計算。如您填寫的翻譯與原譯文差異過大，則可能導致干預后結果有錯亂。此外，術語干預僅適用于專有名詞、術語的自定義，目前暫不支持針對HTML代碼（如<p> <div>）原樣輸出，即：您暫時無法在原文和譯文都填寫英文單詞“text”。

各語言DEMO

PHP 版（點擊下載）
JS 版（點擊下載）
Python2 版（點擊下載）
Python3 版（點擊下載）
C 版（點擊下載）
Java 版（點擊下載）
C# 版（點擊下載）

常見問題：

1.如何在一次請求中翻譯多個單詞或者多段文本?

您可以在發送的字段q中用換行符（在多數編程語言中為轉義符號 \n。其中\n是需要能被程序解析出來的換行符而不是字符串\n），您可以用換行符來分隔要翻譯的多個單詞或者多段文本，這樣您就能得到多段文本獨立的翻譯結果了。注意在發送請求之前需對q字段做URL encode！

2.?什么是URL encode？

網絡標準RFC 1738規定了URL中只能使用英文字母、阿拉伯數字和某些標點符號，不能使用其他文字和符號。如果您需要翻譯的文本里面出現了不在該規定范圍內的字符（比如中文），需要通過URL encode將需要翻譯的文本做URL編碼才能發送HTTP請求。大部分編程語言都有現成的URL encode函數，具體使用方法可以針對您使用的編程語言自行搜索。

3. 通用翻譯API中，字符數量如何統計？

字符數量的統計以翻譯的源語言字符長度為標準。一個漢字、一個英文字母、一個標點符號等均記為一個字符。空格、html標簽等均計入在內。

4. 單次翻譯請求是否有字符數限制？

為保證您的使用體驗，請將單次翻譯文本長度限定為6000字節以內（漢字約為2000個字符）。此外，高峰時期單次請求文本過長或將導致翻譯超時。您可將query分多次請求。

5.?為什么我的請求總是返回簽名錯誤（錯誤碼54001）？

54001表示簽名錯誤，請檢查按照如下步驟檢查您的簽名生成方法是否正確：
1、appid+q+salt+密鑰 拼接成的字符串做MD5得到32位小寫的sign，確保要翻譯的文本q為UTF8格式。
2、在生成簽名拼接 appid+q+salt+密鑰 字符串時，q不需要做URL encode，在生成簽名之后，發送HTTP請求之前才需要對要發送的待翻譯文本字段q做URL encode。
3、如果您無法確認自己生成簽名的結果是否正確，可以將您生成的簽名結果和在https://md5jiami.51240.com/中生成的常規md5加密-32位小寫簽名結果對比。
4、如您使用POST方式傳送，Content-Type請指定為：application/x-www-form-urlencoded。
5、如您使用報“簽名錯誤”，請參考上方各語言Demo代碼文檔仔細檢查。

6. 為什么我的請求會返回54003？

54003表示請求頻率超限，請降低您的請求頻率。
對于標準版服務，您的QPS（每秒請求量）=1，如需更大頻率，請先進行身份認證，認證通過后可切換為高級版（適用于個人，QPS=10）或尊享版（適用于企業，QPS=100）

7. 為什么我的請求會返回52001？

52001表示請求超時，請檢查按照如下步驟檢查您的簽名生成方法是否正確：
1、您傳入的query長度是否超長？建議將原文采用"\n"分段請求
2、如間隔一段時間再次請求，是否可正常返回結果？如果可以。則請檢查您所填寫的原文或譯文語言代碼是否支持？

8. 為什么我的請求會返回58003？

因黑產采用不正當手段收集用戶APPID及密鑰，由此產生的盜刷字符量現象日益猖獗，系統風控增加了IP校驗規則，如同一IP當日使用多個APPID發送翻譯請求，則該IP將被封禁當日請求權限，次日解封。
但由于IP多變，應用場景復雜，難免出現誤傷正常使用的情況。如您屬正常使用，但出現58003的提示，請發送郵件至 translate_api@baidu.com，同時提供如下信息。我方在收到郵件后將與您取得聯系，核實后將解除封禁。
公司名稱：
產品名稱：
聯系人：
聯系方式：
服務器IP：
APPID：
注：如提供信息不全，將影響審核通過率。

9. 如果我需要翻譯整個網頁，尖括號內的標簽無法原樣輸出，怎么辦？

翻譯API會將傳入的所有字符串當做可翻譯字符，目前暫時無法區分哪些部分需原樣保留，因此API不適合直接處理html文件。您可將html文件進行譯前處理，抽取出待翻譯文本，傳入API翻譯后再回填。

10. 是否支持對譯文中的術語結果進行修改？

已認證用戶可進入“管理控制臺→ 我的術語庫”維護術語列表，同時開通“干預通用翻譯API結果”。開通后，您將可對譯文中的術語翻譯結果進行優化和修正。請注意：干預通用翻譯API結果將可能導致翻譯延時增長。因此在無需干預結果時可將開關關閉。
如術語干預功能無法滿足您的需要，或有更多意見或建議，可聯系translate_api@baidu.com

11.?我應該如何獲取詞典、語音合成資源結果？

接入文檔與通用翻譯API一致，接入流程上無變化。與未開通詞典、語音合成服務相比，僅在返回結果處增加tts、dict字段，請注意辨別字段名稱。
舉例：
（1）query=apple，語言方向為英到中
未接入資源時，返回結果為：

{"from": "en", "to": "zh", "trans_result": [{"src": "apple", "dst": "蘋果"}] }

接入詞典、語音合成資源后，返回結果為：

{"from": "en","to": "zh","trans_result": [{"src": "apple","dst": "蘋果","src_tts": "https:\/\/fanyiapp.cdn.bcebos.com\/api\/tts\/95e906875b87d342d7325a36a4e1ab42.mp3","dst_tts": "https:\/\/fanyiapp.cdn.bcebos.com\/api\/tts\/62f4ff87617655bc1f65e24cf4ed4963.mp3","dict": "{\"lang\":\"1\",\"word_result\":{\"simple_means\":{\"word_name\":\"apple\",\"from\":\"original\",\"word_means\":[\"蘋果\"],\"exchange\":{\"word_pl\":[\"apples\"]},\"tags\":{\"core\":[\"高考\",\"考研\"],\"other\":[\"\"]},\"symbols\":[{\"ph_en\":\"??pl\",\"ph_am\":\"??pl\",\"parts\":[{\"part\":\"n.\",\"means\":[\"蘋果\"]}],\"ph_other\":\"\"}]}}}"}] }

（2）query=中國，語言方向為中到英
未接入資源時，返回結果為：

{"from": "zh", "to": "en", "trans_result": [{"src": "中國", "dst": "China"}] }

接入詞典、語音合成資源后，返回結果為：

{"from": "zh","to": "en","trans_result": [{"src": "中國","dst": "China","src_tts": "https:\/\/fanyiapp.cdn.bcebos.com\/api\/tts\/d943b8e0e31e8d0ea8879dde5d41f016.mp3","dst_tts": "https:\/\/fanyiapp.cdn.bcebos.com\/api\/tts\/2e2312a1d33e2ff453f92d5d95277e13.mp3","dict": "{\"lang\":\"0\",\"word_result\":{\"simple_means\":{\"symbols\":[{\"word_symbol\":\"zhōng guó\",\"parts\":[{\"part_name\":\"\",\"means\":[{\"text\":\"China\",\"part\":\"n.\",\"word_mean\":\"China\",\"means\":[\"中國\"]},{\"text\":\"Sino-\",\"part\":\"comb.\",\"word_mean\":\"Sino-\",\"means\":[\"中國的\",\"中國人(的)\"]}]}]}],\"word_name\":\"中國\",\"from\":\"CEDict\",\"word_means\":[\"China\",\"Sino-\"]}}}"}] }

12. 我已開通詞典、語音合成資源，但不想在結果中呈現，應該怎么辦？

如需隱藏詞典、語音合成信息，可在拼接請求參數時附加"&dict=1&tts=1"，例如，如僅需隱藏tts字段，完整請求為：
http://api.fanyi.baidu.com/api/trans/vip/translate?q=apple&from=en&to=zh&appid=2015063000000001&salt=1435660288&sign=f89f9594663708c1605f3d736d01d2d4&tts=1

13. 我怎樣開通“我的術語庫”功能？

“我的術語庫”功能面向個人及企業認證用戶開放，您需首先前往“開發者信息”處完成身份認證，認證后即可在管理控制臺看到“我的術語庫”入口。目前自定義術語功能已開通“中文”和“英語”兩個語種，更多語種需求，請發送郵件至translate_api@baidu.com告訴我們。

14. 為什么我添加了術語卻看不出效果？

添加術語卻看不出效果，可能出于以下幾個原因：
a. 添加或修改術語后，需要大約10分鐘的生效時間，如果您是剛剛修改過術語，請您耐心等候生效；
b. 翻譯系統判斷您定義的翻譯與原翻譯差異過大。由于神經網絡翻譯模型中，術語的定制化干預功能并非對翻譯結果的生硬替換，而是類似于“調優”。如果您對術語的定義與原釋義含義差距過大，會導致經計算過后的出現不可控的翻譯結果。如您對術語干預效果不滿意，請與我們聯系。translate_api@baidu.com

總結

以上是生活随笔為你收集整理的微信公众号-百度通用翻译API接入文档的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。