调用Translate获取翻译结果_机器翻译(Machine Translation)-阿里云帮助中心

调用机器翻译专业版获取翻译结果。

1、调用接口QPS限制50，如有扩展需求，请与我们联系。钉钉群号：23369411

2、字符长度上限是5000字符，若超出上限，可以保存成文件，使用文档翻译

3、请确保在使用该接口前，已充分了解专业版翻译产品的收费方式和价格

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	Translate	系统规定参数。取值：Translate。
FormatType	String	是	text	翻译文本的格式，html（网页格式。设置此参数将对待翻译文本以及翻译后文本按照html格式进行处理）、text（文本格式。设置此参数将对传入待翻译文本以及翻译后结果不做文本格式处理，统一按纯文本格式处理。
Scene	String	是	title	场景可选取值：商品标题（title），商品描述（description），商品沟通（communication），医疗（medical），社交（social)，金融（finance）
SourceLanguage	String	是	zh	原文语言
SourceText	String	是	你好	待翻译内容
TargetLanguage	String	是	en	译文语言
Context	String	否	早上我在家里吃了面包	上下文信息，可选填

场景说明

我们在针对不同场景，都有不同的引擎，每个引擎都是特别优化过的，可以通过scene参数控制，以下是场景可选取值：

商品标题（title）：运用阿里电商标题数据，单独训练出来的，翻译标题特别好
商品描述（description）：运用阿里商品详描数据，单独训练出来，专门翻译商品详描比较好
商品沟通（communication）：在电商买卖家沟通场景下，翻译效果会很好
医疗（medical）：是针对医疗文献、术语、药品单独训练出来的引擎，在这个场景下翻译效果会很好
社交（social)：面向口语化的翻译，在这个场景下翻译结果会比较好
金融（finance)：面向金融领域的翻译

返回数据

名称	类型	示例值	描述
Code	Integer	200	错误码
Data	Struct		返回数据
Translated	String	Hello	翻译结果
WordCount	String	10	总单词数
DetectedLanguage	String	zh	zh源语言传入auto时，语种识别后的源语言代码
Message	String	success	错误信息
RequestId	String	86D18195-D89C-4C8C-9DC4-5FCE789CE6D5	请求ID

示例

请求示例

http(s)://[Endpoint]/?Action=Translate
&FormatType=text
&Scene=title
&SourceLanguage=zh
&SourceText=你好
&TargetLanguage=en
&<公共请求参数>

公共请求参数参见《RPC 调用机制》公共请求参数组装方案

正常返回示例

XML 格式

<TranslateResponse>
      <Data>
            <Translated>Hello</Translated>
      </Data>
      <RequestId>22A7F1D3-57AF-4F64-B2A6-5E1A180CF6B1</RequestId>
      <Code>200</Code>
</TranslateResponse>

JSON 格式

{
    "TranslateResponse": {
        "Data": {
            "Translated": "Hello"
        },
        "RequestId": "22A7F1D3-57AF-4F64-B2A6-5E1A180CF6B1",
        "Code": 200
    }
}

错误码

HttpCode	错误码	错误信息	描述
101	10001	The request has timed out.	请求超时
102	10002	A system error occurred.	系统错误
103	10003	An error occurred while decoding the URL. Verify that the specified URL is encoded.	原文解码失败，请检查原文是否UrlEncode
104	10004	Some required parameters are missing.	参数缺失
105	10005	The specified language pair is not supported.	语项不支持
106	10006	An error occurred while detecting the language.	语种识别失败
107	10007	An error occurred while translating.	翻译失败
108	10008	The specified string is too long.	字符长度过长
199	19999	An unknown error occurred.	未知异常
109	10009	子账号没有权限	子账号没有权限
110	10010	账号没有开通服务	账号没有开通服务
111	10011	子账号服务失败	子账号服务失败
112	10012	翻译服务调用失败	翻译服务调用失败
113	10013	账号服务没有开通或者欠费	账号服务没有开通或者欠费

访问错误中心查看更多错误码。