文本翻译api接口以及接口文档

说明:

该接口仅供个人案例练习使用,不可在生产环境使用。

接口文档

1.1 基本信息

请求地址:http://api.byboy.cn (支持https)

请求路径:/translate

请求方式:POST

接口描述:该接口用于文本翻译

1.2 请求参数

参数格式:application/json

参数说明:

字段名 类型 是否必填 描述 备注
q string 请求翻译query UTF-8编码
from string 翻译源语言 可设置为auto
to string 翻译目标语言 不可设置为auto

注意:为保证翻译质量,单次请求长度控制在 6000 bytes以内(汉字约为输入参数 2000 个)

请求参数样例:

{
    "q": "good luck to you!",
    "from": "en",
    "to": "zh"
}

1.3 响应数据

参数格式:application/json

参数说明:

参数名 类型 是否必须 备注
from string 非必须 翻译源语言
to string 非必须 翻译目标语言
trans_result array 非必须 返回翻译结果,包括 src 和 dst 字段
trans_result.*.src string 非必须 原文
trans_result.*dst string 非必须 译文
error_code integer 非必须 错误码,仅当出现错误时显示

正常响应数据样例:

{
    "from": "en",
    "to": "zh",
    "trans_result": [
        {
            "src": "good luck to you!",
            "dst": "祝你好运!"
        }
    ]
}

错误响应数据样例:

{
    "error_code": "58001",
    "error_msg": "INVALID_TO_PARAM"
}

1.4 语种列表

1.4.1 常见语种

名称 代码 名称 代码 名称 代码
自动检测 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

1.4.1 完整语种

中文首字母 名称 代码 语种检测 名称 代码 语种检测 名称 代码 语种检测
A 阿拉伯语 ara 爱尔兰语 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
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 海地语 ht 黑山语 mot
豪萨语 hau
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 苗语 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 塞尔维亚语(西里尔) src
索马里语 som
T 泰语 th 土耳其语 tr 塔吉克语 tgk
泰米尔语 tam 他加禄语 tgl 提格利尼亚语 tir
泰卢固语 tel 突尼斯阿拉伯语 tua 土库曼语 tuk
W 乌克兰语 ukr 瓦隆语 wln 威尔士语 wel
文达语 ven 沃洛夫语 wol 乌尔都语 urd
X 西班牙语 spa 希伯来语 heb 希腊语 el
匈牙利语 hu 西弗里斯语 fry 西里西亚语 sil
希利盖农语 hil 下索布语 los 夏威夷语 haw
新挪威语 nno 西非书面语 nqo 信德语 snd
修纳语 sna 宿务语 ceb 叙利亚语 syr
巽他语 sun
Y 英语 en 印地语 hi 印尼语 id
意大利语 it 越南语 vie 意第绪语 yid
因特语 ina 亚齐语 ach 印古什语 ing
伊博语 ibo 伊多语 ido 约鲁巴语 yor
亚美尼亚语 arm 伊努克提图特语 iku 伊朗语 ir
Z 中文(简体) zh 中文(繁体) cht 中文(文言文) wyw
中文(粤语) yue 扎扎其语 zaz 中古法语 frm
祖鲁语 zul 爪哇语 jav

1.5 错误码列表

当翻译结果无法正常返回时,请参考下表处理:

错误码 含义 解决方案
52000 成功
52001 请求超时 请重试
52002 系统错误 请重试
54000 必填参数为空 请检查是否少传参数
54003 访问频率受限 请降低您的调用频率
54005 长query请求频繁 请降低长query的发送频率,3s后再试
58001 译文语言方向不支持 检查译文语言是否在语言列表里
58002 服务当前已关闭 停止服务
阅读剩余
THE END