README.md•13.9 kB
# 文本翻译-通用版（Translation）
## 简介
文本翻译组件（Translation）提供多种语言互译的在线文本翻译服务。支持术语定制功能，用户可对翻译结果进行干预，快速提高翻译质量。可广泛应用于移动端、PC网站、智能硬件等不同产品形态中，满足多领域、多场景的翻译需求。
### 功能介绍
支持200+语种互译，传入待翻译内容，并指定源语言（支持语种自动检测）和目标语言，即可获得翻译结果，并支持术语干预。
支持在【创建应用】-【添加工具组件】时，对以下语言的试用：
|名称 | 代码 | 名称 | 代码 | 名称 | 代码 |
|------------|--------|------------|--------|------------|--------|
| 自动检测 | 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. 依托互联网数据资源和自然语言处理技术优势，上线全球首个互联网神经网络翻译系统，日均响应千亿字符请求
2. 2019国际机器翻译评测（WMT19）中，获得中英翻译第一，提供业界领先的机器翻译服务
3. 支持用户上传术语对翻译结果进行干预，优化翻译质量，用户可根据不同产品、不同领域创建多个术语库
4. 翻译请求可实现实时响应，服务稳定性高，在海外也可及时获取翻译结果，保障用户稳定的服务体验
### 应用场景
1. 教育学习：在外语教学及学习场景中，通过实时句子翻译、单词释义、语音合成等功能，帮助师生沟通、外教课后点评，辅助阅读和写作，全面提升学习效率与质量
2. 手机厂商：应用于手机系统中，实现手机系统取词翻译、对话文本翻译等服务。为手机应用开发者提供便捷的翻译功能
3. 跨境电商：在商业全球化背景下，针对跨国商贸服务中产品名称、详情页等网站基本信息进行翻译，助力企业开拓国际市场
4. 智能硬件：应用于翻译机、学习机、智能手表等硬件系统中，为用户提供文本翻译、词典及语音合成等能力，实现便捷准确的多语种互译功能
## 基本用法
通过如下示例代码可以快速开始使用文本翻译组件：
```python
import os
import appbuilder
# 请前往千帆AppBuilder官网创建密钥，流程详见：https://cloud.baidu.com/doc/AppBuilder/s/Olq6grrt6#1%E3%80%81%E5%88%9B%E5%BB%BA%E5%AF%86%E9%92%A5
os.environ["APPBUILDER_TOKEN"] = '...'
translate = appbuilder.Translation()
resp = translate(appbuilder.Message("你好\n中国"), from_lang="zh", to_lang="en")
# 输出{'from_lang': 'zh', 'to_lang': 'en', 'trans_result': [{'src': '你好', 'dst': 'hello'}, {'src': '中国', 'dst': 'China'}]}
print(resp.content)
```
## 参数说明
### 鉴权配置
使用组件之前，请首先申请并设置鉴权参数，可参考[组件使用流程](https://cloud.baidu.com/doc/AppBuilder/s/Olq6grrt6#1%E3%80%81%E5%88%9B%E5%BB%BA%E5%AF%86%E9%92%A5)。
```python
# 设置环境中的TOKEN，以下示例略
os.environ["APPBUILDER_TOKEN"] = "bce-YOURTOKEN"
```
### 初始化参数说明
无
### 调用参数说明
|参数名称 |参数类型 |是否必须 |描述 | 示例值 |
|--------|--------|--------|----|--------|
|message |obj:`Message` |是 |输入的请求翻译文本| Message("你好") |
|from_lang|String|否 |翻译的源语言，默认为`auto`，表示自动检测语言。| zh |
|to_lang|Integer|否 |需要翻译的目标语言，默认为`en`，表示英语。| en |
|timeout| Float | 否 | HTTP超时时间,单位：秒 |1||
|retry|Integer|否 |HTTP重试次数| 3 |
### 响应参数
|参数名称 |参数类型 |描述 |示例值|
|--------|--------|----|------|
|from_lang |String |翻译源语言| zh|
|to_lang |String |翻译目标语言|en|
|trans_result |List[Object] |返回结果|[{'src': '你好', 'dst': 'hello'}]|
|trans_result[0].src |String |源文本|你好|
|trans_result[0].dst |String |目标文本|hello|
### 响应示例
```json
{
"from_lang": "zh",
"to_lang": "en",
"trans_result": [
{
"src": "你好",
"dst": "hello"
}
]
}
```
### 错误码
|错误码|描述|
|------|---|
## 更新记录和贡献
* 文本翻译-通用版 (2024-01)
## 语种列表
|名称 |代码 |语种检测|
|----|-----|------|
| 阿拉伯语 | ara | 是 |
| 爱尔兰语 | gle | 是 |
| 奥克语 | oci | 是 |
| 阿尔巴尼亚语 | alb | 是 |
| 阿尔及利亚阿拉伯语 | arq | 否 |
| 阿肯语 | aka | 否 |
| 阿拉贡语 | arg | 否 |
| 阿姆哈拉语 | amh | 是 |
| 阿萨姆语 | asm | 是 |
| 艾马拉语 | aym | 否 |
| 阿塞拜疆语 | aze | 是 |
| 阿斯图里亚斯语 | ast | 是 |
| 奥塞梯语 | oss | 否 |
| 爱沙尼亚语 | est | 是 |
| 奥杰布瓦语 | oji | 否 |
| 奥里亚语 | ori | 是 |
| 奥罗莫语 | orm | 否 |
| 波兰语 | pl | 是 |
| 波斯语 | per | 是 |
| 布列塔尼语 | bre | 是 |
| 巴什基尔语 | bak | 否 |
| 巴斯克语 | baq | 是 |
| 巴西葡萄牙语 | pot | 否 |
| 白俄罗斯语 | bel | 是 |
| 柏柏尔语 | ber | 是 |
| 邦板牙语 | pam | 否 |
| 保加利亚语 | bul | 是 |
| 北方萨米语 | sme | 否 |
| 北索托语 | ped | 否 |
| 本巴语 | bem | 否 |
| 比林语 | bli | 否 |
| 比斯拉马语 | bis | 否 |
| 俾路支语 | bal | 否 |
| 冰岛语 | ice | 是 |
| 波斯尼亚语 | bos | 是 |
| 博杰普尔语 | bho | 否 |
| 楚瓦什语 | chv | 否 |
| 聪加语 | tso | 否 |
| 丹麦语 | dan | 是 |
| 德语 | de | 是 |
| 鞑靼语 | tat | 是 |
| 掸语 | sha | 否 |
| 德顿语 | tet | 否 |
| 迪维希语 | div | 否 |
| 低地德语 | log | 是 |
| 俄语 | ru | 是 |
| 法语 | fra | 是 |
| 菲律宾语 | fil | 是 |
| 芬兰语 | fin | 是 |
| 梵语 | san | 否 |
| 弗留利语 | fri | 否 |
| 富拉尼语 | ful | 否 |
| 法罗语 | fao | 否 |
| 盖尔语 | gla | 否 |
| 刚果语 | kon | 否 |
| 高地索布语 | ups | 否 |
| 高棉语 | hkm | 是 |
| 格陵兰语 | kal | 否 |
| 格鲁吉亚语 | geo | 是 |
| 古吉拉特语 | guj | 是 |
| 古希腊语 | gra | 否 |
| 古英语 | eno | 否 |
| 瓜拉尼语 | grn | 否 |
| 韩语 | kor | 是 |
| 荷兰语 | nl | 是 |
| 胡帕语 | hup | 否 |
| 哈卡钦语 | hak | 否 |
| 海地语 | ht | 否 |
| 豪萨语 | hau | 否 |
| 黑山语 | mot | 否 |
| 吉尔吉斯语 | kir | 否 |
| 加利西亚语 | glg | 是 |
| 加拿大法语 | frn | 否 |
| 加泰罗尼亚语 | cat | 是 |
| 捷克语 | cs | 是 |
| 卡拜尔语 | kab | 是 |
| 卡纳达语 | kan | 是 |
| 卡努里语 | kau | 否 |
| 卡舒比语 | kah | 否 |
| 康瓦尔语 | cor | 否 |
| 科萨语 | xho | 是 |
| 科西嘉语 | cos | 否 |
| 克里克语 | cre | 否 |
| 克里米亚鞑靼语 | cri | 否 |
| 克林贡语 | kli | 否 |
| 克罗地亚语 | hrv | 是 |
| 克丘亚语 | que | 否 |
| 克什米尔语 | kas | 否 |
| 孔卡尼语 | kok | 否 |
| 库尔德语 | kur | 是 |
| 拉丁语 | lat | 是 |
| 老挝语 | lao | 否 |
| 罗马尼亚语 | rom | 是 |
| 拉特加莱语 | lag | 否 |
| 拉脱维亚语 | lav | 是 |
| 林堡语 | lim | 否 |
| 林加拉语 | lin | 否 |
| 卢干达语 | lug | 否 |
| 卢森堡语 | ltz | 否 |
| 卢森尼亚语 | ruy | 否 |
| 卢旺达语 | kin | 是 |
| 立陶宛语 | lit | 是 |
| 罗曼什语 | roh | 否 |
| 罗姆语 | ro | 否 |
| 逻辑语 | loj | 否 |
| 马来语 | may | 是 |
| 缅甸语 | bur | 是 |
| 马拉地语 | mar | 否 |
| 马拉加斯语 | mg | 是 |
| 马拉雅拉姆语 | mal | 是 |
| 马其顿语 | mac | 是 |
| 马绍尔语 | mah | 否 |
| 迈蒂利语 | mai | 是 |
| 曼克斯语 | glv | 否 |
| 毛里求斯克里奥尔语 | mau | 否 |
| 毛利语 | mao | 否 |
| 孟加拉语 | ben | 是 |
| 马耳他语 | mlt | 是 |
| 苗语 | hmn | 否 |
| 挪威语 | nor | 是 |
| 那不勒斯语 | nea | 否 |
| 南恩德贝莱语 | nbl | 否 |
| 南非荷兰语 | afr | 是 |
| 南索托语 | sot | 否 |
| 尼泊尔语 | nep | 是 |
| 葡萄牙语 | pt | 是 |
| 旁遮普语 | pan | 是 |
| 帕皮阿门托语 | pap | 否 |
| 普什图语 | pus | 否 |
| 齐切瓦语 | nya | 否 |
| 契维语 | twi | 否 |
| 切罗基语 | chr | 否 |
| 日语 | jp | 是 |
| 瑞典语 | swe | 是 |
| 萨丁尼亚语 | srd | 否 |
| 萨摩亚语 | sm | 否 |
| 塞尔维亚-克罗地亚语 | sec | 否 |
| 塞尔维亚语 | srp | 是 |
| 桑海语 | sol | 否 |
| 僧伽罗语 | sin | 是 |
| 世界语 | epo | 是 |
| 书面挪威语 | nob | 是 |
| 斯洛伐克语 | sk | 是 |
| 斯洛文尼亚语 | slo | 是 |
| 斯瓦希里语 | swa | 是 |
| 索马里语 | som | 是 |
| 塞尔维亚语（西里尔） | src | 否 |
| 泰语 | th | 是 |
| 土耳其语 | tr | 是 |
| 塔吉克语 | tgk | 是 |
| 泰米尔语 | tam | 是 |
| 他加禄语 | tgl | 是 |
| 提格利尼亚语 | tir | 否 |
| 泰卢固语 | tel | 是 |
| 突尼斯阿拉伯语 | tua | 否 |
| 土库曼语 | tuk | 否 |
| 乌克兰语 | ukr | 是 |
| 瓦隆语 | wln | 是 |
| 威尔士语 | wel | 是 |
| 文达语 | ven | 否 |
| 沃洛夫语 | wol | 否 |
| 乌尔都语 | urd | 是 |
| 西班牙语 | spa | 是 |
| 希伯来语 | heb | 是 |
| 希腊语 | el | 是 |
| 匈牙利语 | hu | 是 |
| 西弗里斯语 | fry | 是 |
| 西里西亚语 | sil | 否 |
| 希利盖农语 | hil | 否 |
| 下索布语 | los | 否 |
| 夏威夷语 | haw | 否 |
| 新挪威语 | nno | 是 |
| 西非书面语 | nqo | 否 |
| 信德语 | snd | 否 |
| 修纳语 | sna | 否 |
| 宿务语 | ceb | 否 |
| 叙利亚语 | syr | 否 |
| 巽他语 | sun | 否 |
| 英语 | en | 是 |
| 印地语 | hi | 是 |
| 印尼语 | id | 是 |
| 意大利语 | it | 是 |
| 越南语 | vie | 是 |
| 意第绪语 | yid | 否 |
| 因特语 | ina | 否 |
| 亚齐语 | ach | 否 |
| 印古什语 | ing | 否 |
| 伊博语 | ibo | 否 |
| 伊多语 | ido | 否 |
| 约鲁巴语 | yor | 否 |
| 亚美尼亚语 | arm | 是 |
| 伊努克提图特语 | iku | 否 |
| 中文(简体) | zh | 是 |
| 中文(繁体) | cht | 是 |
| 中文(文言文) | wyw | 是 |
| 中文(粤语) | yue | 是 |
| 扎扎其语 | zaz | 否 |
| 中古法语 | frm | 否 |
| 祖鲁语 | zul | 否 |
| 爪哇语 | jav | 否 |