通用翻译接口调用说明

注意事项

1、字符长度限制5000,QPS限制50;如有扩展需求,请与我们联系 钉钉群号:21983957

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String TranslateGeneral

系统规定参数。取值:TranslateGeneral。

FormatType String text

翻译文本的格式,html( 网页格式。设置此参数将对待翻译文本以及翻译后文本按照html格式进行处理)、text(文本格式。设置此参数将对传入待翻译文本以及翻译后结果不做文本格式处理,统一按纯文本格式处理。

Scene String general

通用版本默认是:general

SourceLanguage String zh

原文语言参考语言code

SourceText String 你好

需要翻译的内容

TargetLanguage String en

译文语言参考语言code

返回数据

名称 类型 示例值 描述
Code Integer 200

错误码

Data Struct

返回内容

Translated String Hello

翻译结果

Message String success

返回信息

RequestId String 86D18195-D89C-4C8C-9DC4-5FCE789CE6D5

请求ID

示例

请求示例

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

正常返回示例

XML 格式

<TranslateGeneralResponse>
      <RequestId>14E447CA-B93B-4526-ACD7-42AE13CC2AF6</RequestId>
      <Data>
            <Translated>Hello</Translated>
      </Data>
      <Code>200</Code>
</TranslateGeneralResponse>

JSON 格式

{
    "TranslateGeneralResponse": {
        "RequestId": "14E447CA-B93B-4526-ACD7-42AE13CC2AF6",
        "Data": {
            "Translated": "Hello"
        },
        "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 账号服务没有开通或者欠费 账号服务没有开通或者欠费

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

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