翻译文本

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

Tip: 单租户限流：20QPS，同租户下的应用没有限流，共享本租户的 20QPS 限流。免费版不支持调用。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/translation/v1/text/translate
HTTP Method	POST
接口频率限制	特殊频控
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	translation:text 文本翻译

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

请求体

名称	类型	必填	描述
source_language	string	是	源语言 示例值："zh"
text	string	是	源文本，字符上限为 1,000。 示例值："尝试使用一下飞书吧"
target_language	string	是	目标语言 示例值："en"
glossary	term\[\]	否	请求级术语表，携带术语，仅在本次翻译中生效（最多能携带 128个术语词）
└ from	string	是	原文 示例值："飞书"
└ to	string	是	译文 示例值："Lark"

请求体示例

{
    "source_language": "zh",
    "text": "尝试使用一下飞书吧",
    "target_language": "en",
    "glossary": [
        {
            "from": "飞书",
            "to": "Lark"
        }
    ]
}

响应

响应体

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

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "text": "Try to use Lark"
    }
}

错误码

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