淘宝开放平台

登录
文档中心 > API类目 > 阿里翻译API

阿里翻译API

alibaba.intl.translationplatform.cloud.standard.common.translate (通用翻译-标准版)

提供单次的同步机器翻译服务

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_cloud_translate CloudTranslateDto 必须 翻译对象
  • └ field_type
  • String
  • 可选
  • general
  • general
  • └ format_type
  • String
  • 必须
  • text
  • 翻译格式，文本：text，页面：html
  • └ source_language
  • String
  • 必须
  • zh
  • 原语种
  • └ source_text
  • String
  • 必须
  • 你好
  • 翻译内容
  • └ target_language
  • String
  • 必须
  • en
  • 目标语种
  • └ user_id
  • String
  • 必须
  • 12345
  • 用户ID
  • extra_params
  • PairDTO []
  • 可选
  • test
  • 干预参数
  • └ key
  • String
  • 可选
  • mykey
  • 自定义干预key
  • └ value
  • String
  • 可选
  • myvalue
  • 自定义干预value

响应参数

名称 类型 示例值 描述
translated_text String 你好 译文内容
word_count Number 100 wordCount
sp_word_count Number 100 spWordCount

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest req = new AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest();
AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest.CloudTranslateDto obj1 = new AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest.CloudTranslateDto();
obj1.setFieldType("general");
obj1.setFormatType("text");
obj1.setSourceLanguage("zh");
obj1.setSourceText("你好");
obj1.setTargetLanguage("en");
obj1.setUserId("12345");
List<AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest.PairDTO> list3 = new ArrayList<AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest.PairDTO>();
AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest.PairDTO obj4 = new AlibabaIntlTranslationplatformCloudStandardCommonTranslateRequest.PairDTO();
list3.add(obj4);
obj4.setKey("mykey");
obj4.setValue("myvalue");
obj1.setExtraParams(list3);
req.setParamCloudTranslate(obj1);
AlibabaIntlTranslationplatformCloudStandardCommonTranslateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
<alibaba_intl_translationplatform_cloud_standard_common_translate_response>
    <translated_text>你好</translated_text>
    <word_count>100</word_count>
    <sp_word_count>100</sp_word_count>
</alibaba_intl_translationplatform_cloud_standard_common_translate_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
10001 请求超时 可重试
10002 系统错误 可重试
10003 译文URL decode失败 确认是否是UTF-8编码，并且URL encode正确
10004 必传参数为空或者参数值不正确 确认api文档参数说明
10005 译文翻译语言方向不支持 检查译文是否在支持的语言对里面
10006 语种识别失败 确认传入的待识别文本是否正确
10007 翻译失败 确认译文是否是正确的文字
10008 译文长度超过限制 确认译文长度是否超过2000个字符
19999 未知错误 联系客服解决

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部