全部产品
Search
文档中心

机器翻译:机器翻译通用版调用指南

更新时间:Jun 26, 2023

通用翻译接口调用说明。

注意事项

1、QPS限制50,如有扩展需求,请与我们联系。钉钉群号:23369411

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

Context

String

早上我在家里吃了面包

上下文信息,可选填

返回数据

名称

类型

示例值

描述

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=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

账号服务没有开通或者欠费

账号服务没有开通或者欠费

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