服务端 API/AI 能力/机器翻译（MT）/文本/文本翻译
# 文本翻译

机器翻译 (MT)，支持以下语种互译：
"zh": 汉语；
"zh-Hant": 繁体汉语；
"en": 英语；
"ja": 日语；
"ru": 俄语；
"de": 德语；
"fr": 法语；
"it": 意大利语；
"pl": 波兰语；
"th": 泰语；
"hi": 印地语；
"id": 印尼语；
"es": 西班牙语；
"pt": 葡萄牙语；
"ko": 朝鲜语；
"vi": 越南语；

**注意事项**：单租户限流：20QPS，同租户下的应用没有限流，共享本租户的 20QPS 限流。免费版不支持调用。

## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/translation/v1/text/translate
HTTP Method | POST
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 文本翻译(translation:text)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
source_language | string | 是 | 源语言<br>**示例值**："zh"
text | string | 是 | 源文本<br>**示例值**："尝试使用一下Lark吧"
target_language | string | 是 | 目标语言<br>**示例值**："en"
glossary | term\[\] | 否 | 请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词）
from | string | 是 | 原文<br>**示例值**："Lark"
to | string | 是 | 译文<br>**示例值**："Lark"

### 请求体示例
```json
{
    "source_language": "zh",
    "text": "尝试使用一下Lark吧",
    "target_language": "en",
    "glossary": [
        {
            "from": "Lark",
            "to": "Lark"
        }
    ]
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
text | string | 翻译后的文本

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "text": "Try to use Lark"
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 1140101 | invalid param | 参数错误，参考文档检查输入参数
500 | 1140102 | network anomaly | 后端服务异常或网络异常，可重新请求