淘宝开放平台

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

阿里翻译API

alibaba.translation.cloud.translate.doc.task.submit (提交文档翻译任务)

提交文档翻译任务，将文档格式文件(支持：40+种文档类型)，从一种语言翻译成另外一种语言，并保持源文档排版格式。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_translate_d_t_o TranslateDto 可选 提交文档翻译任务
  • └ bilingual_text
  • String
  • 可选
  • null
  • 双语
  • └ callback_url
  • String
  • 可选
  • http://123.aliyuncs.com/put
  • 回调函数
  • └ delete_status
  • Number
  • 可选
  • 0
  • 删除状态
  • └ ding_drive_path
  • String
  • 可选
  • null
  • 地址
  • └ from_source
  • String
  • 可选
  • aliyun
  • 来源
  • └ read_status
  • String
  • 可选
  • noready
  • 状态
  • └ request_id
  • String
  • 可选
  • 123-456-789
  • 阿里云请求ID
  • └ scene
  • String
  • 可选
  • general
  • 翻译场景
  • └ src_lang
  • String
  • 可选
  • zh
  • 源语种
  • └ file_url
  • String
  • 可选
  • http://123.aliyuncs.com/file.docx
  • 文件地址
  • └ tgt_lang
  • String
  • 可选
  • en
  • 目标语种
  • └ user_id
  • Number
  • 可选
  • 1234567
  • 阿里云用户ID

响应参数

名称 类型 示例值 描述
result DocTranslateResultDto 提交文档翻译任务结果
  • └ err_code
  • String
  • 错误码
  • └ err_msg
  • String
  • 错误信息
  • └ id
  • Number
  • id
  • └ page_count
  • Number
  • 页数
  • └ status
  • String
  • init
  • 任务状态
  • └ task_id
  • String
  • a6s6d7d6w7s6s
  • 任务ID
  • └ translate_file_url
  • String
  • 翻译地址

请求示例

  • 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);
AlibabaTranslationCloudTranslateDocTaskSubmitRequest req = new AlibabaTranslationCloudTranslateDocTaskSubmitRequest();
AlibabaTranslationCloudTranslateDocTaskSubmitRequest.TranslateDto obj1 = new AlibabaTranslationCloudTranslateDocTaskSubmitRequest.TranslateDto();
obj1.setBilingualText("null");
obj1.setCallbackUrl("http://123.aliyuncs.com/put");
obj1.setDeleteStatus(0L);
obj1.setDingDrivePath("null");
obj1.setFromSource("aliyun");
obj1.setReadStatus("noready");
obj1.setRequestId("123-456-789");
obj1.setScene("general");
obj1.setSrcLang("zh");
obj1.setFileUrl("http://123.aliyuncs.com/file.docx");
obj1.setTgtLang("en");
obj1.setUserId(1234567L);
req.setParamTranslateDTO(obj1);
AlibabaTranslationCloudTranslateDocTaskSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
<alibaba_translation_cloud_translate_doc_task_submit_response>
    <result>
        <err_code></err_code>
        <err_msg></err_msg>
        <id></id>
        <page_count></page_count>
        <status>init</status>
        <task_id>a6s6d7d6w7s6s</task_id>
        <translate_file_url></translate_file_url>
    </result>
</alibaba_translation_cloud_translate_doc_task_submit_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>

错误码解释

错误码 错误描述 解决方案

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部