文本翻译API--机器翻译-火山引擎

文档中心

立即注册

机器翻译

API参考

文本翻译API

接口描述

文本翻译是火山引擎依托领先的自然语言处理技术推出的在线文本翻译服务，支持财经、生物医药、小说网文等垂类领域翻译引擎，为客户提供精准翻译高效的文本翻译服务。

签名算法

您可在签名算法页面获得相关指引。
涉及字段：

Host = translate.volcengineapi.com
URI = /
QueryString = Action=TranslateText&Version=2020-06-01
Region = cn-north-1
Service = translate

接口限制

支持语言：可在语言支持列表中查看文本翻译支持的的源语言及目标语言。

接口说明

请求方法
POST
请求体

字段	类型	是否为必须项	说明	备注
`SourceLanguage`	`String`	否	源语言	若不配置此字段，则代表自动检测源语言
`TargetLanguage`	`String`	是	目标语言	可在语言支持中查询对应的语言代码
`TextList`	`[String]`	是	待翻译的文本列表	列表长度不超过16 总文本长度不超过5000字符

返回体

字段	类型	说明	备注
`ResponseMetadata`	`ResponseMetadata`	通用字段	无
`TranslationList`	`[Translation]`	`Translation:: String` 翻译结果 `DetectedSourceLanguage:: Maybe String` 自动检测出的源语言	`DetectedSourceLanguage` 仅在源语言未指定时会返回结果

在接口错误时，错误信息会在ResponseMetadata.Error中，包含了错误类型Code:: String和错误信息Message:: String两个字段，其中错误码列表为：

错误码	说明	解决方法
-400	请求参数错误，具体错误可参考`Message`信息	请检查请求参数是否正确
-415	不支持的翻译	请检查语言支持里是否支持该语向
-429	请求过于频繁	请降低请求频率
-500	翻译服务内部错误	请重试。若多次重试失败，请联系客服。
1000XX	接口错误信息	详见接口错误信息

样例

请求体

{
    "TargetLanguage": "zh",
    "TextList": [
        "Hello world"
    ]
}

返回体

{
    "TranslationList": [
        {
            "Translation": "你好世界",
            "DetectedSourceLanguage": "en"
        }
    ],
    "ResponseMetadata": {
        "RequestId": "202004092306480100140440781F5D7119",
        "Action": "TranslateText",
        "Version": "2020-06-01",
        "Service": "translate",
        "Region": "cn-north-1",
        "Error": null
    }
}

示例代码

Go, Java, Python

参考：SDK接入指南

最近更新时间：2026.01.14 10:57:36

这个页面对您有帮助吗？

有用

无用

机器翻译

接口描述 #

签名算法 #

接口限制 #

接口说明 #