文档翻译
更新时间:2025-06-12
接口描述
文档翻译API结合高还原度的文档解析和机器翻译技术,提供多格式、多语种、高质量的文档翻译服务。支持Word、PPT、Excel、HTML、XML、TXT、PDF等格式和200+语种互译。只需上传文档并指定目标语言、文档格式等参数,即可快速获得翻译后的文档。
文档翻译API包括2个接口,创建文档翻译接口和查询文档翻译接口
- 创建文档翻译接口:传入文档的Base64编码,指定源语言与目标语言等参数,创建文档翻译任务。
- 查询文档翻译接口:查询文档翻译任务状态,若查询到文档翻译状态为成功,则可直接下载返回结果中的译文链接。
创建文档翻译接口
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求 URL:https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create
URL参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header如下:
参数 | 值 |
---|---|
Content-Type | application/json;charset=utf-8 |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
from | string | 是 | en | 源语言,具体参考语种列表,可设置为auto |
to | string | 是 | zh | 目标语言,具体参考语种列表 |
domain | string | 否 | 垂直领域,支持的领域具体参考垂直领域映射表,不传则为通用领域 | |
input | object | 是 | ||
input.content | string | 是 | SGVsbG8= | 输入的文件内容 base64 编码后的字符串。大小不超过 50M |
input.format | string | 是 | 输入的文件类型,支持的文件类型具体参考“文档输出类型映射表 - 输入类型” | |
input.filename | string | 否 | 测试文件.pdf | 输入的文件名称,不传则随机生成只用于“下载原文”功能时生成的文件名,不会用来使用后缀名进行文件格式判断 |
input.trans_image | int | 否 | 0或1 | 是否翻译文档中的图片 (设置后图片中的字符会算入计费),PDF扫描件需开启才能翻译;0-否 1-是 |
input.term_ids | string | 否 | 术语库id | 一次请求最多支持10个术语库,中间用英文逗号隔开;若相同的术语出现在多个术语库中,则排在前面的术语库生效优先级高;术语库需在控制台进行编辑 |
output | object | 否 | ||
output.filename_prefix | string | 否 | 测试文件 | 输出的文件名称,长度需≤50。不传则通过默认生成规则生成。默认生成规则:译文_前缀名(input.filename).后缀名 |
output.formats | list | 否 | ["docx"] | 输出的文件类型,具体参考下方“文档输出类型映射表-输出类型”,不传则按照默认方案,目前仅支持传一个 |
例如body中请求参数:
JSON
1{
2 "from": "en",
3 "to": "zh",
4 "domain": "general",
5 "input": {
6 "content": "SGVsbG8=",
7 "format": "pdf",
8 "filename": "测试文件.pdf"
9 },
10 "output": {
11 "formats": ["docx"],
12 "filename_prefix": "测试文件译文"
13 }
14}
请求代码示例
1<?php
2/**
3 * Send post request.
4 *
5 * @param string $url
6 * @param string $from
7 * @param string $to
8 * @param string $content
9 * @param string $formay
10 * @return mixed
11 */
12function sendPostRequest(string $url, string $from, string $to, string $content, string $format)
13{
14 $input = [
15 'content' => $content,
16 'format' => $format
17 ];
18
19 $header = [
20 'Content-Type' => 'application/json'
21 ];
22 $formData = json_encode([
23 'from' => $from,
24 'to' => $to,
25 'input' => $input
26 ]);
27
28 $ch = curl_init();
29 curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
30 curl_setopt($ch, CURLOPT_POST, 1);
31 curl_setopt($ch, CURLOPT_POSTFIELDS, $formData);
32 curl_setopt($ch, CURLOPT_URL, $url);
33 curl_setopt($ch, CURLOPT_TIMEOUT, 10);
34 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
35 $res = curl_exec($ch);
36 curl_close($ch);
37
38 return $res;
39}
40
41$token = '[调用鉴权接口获取的token]'; // example: xxx
42$url = 'https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create?access_token=' . $token;
43$from = '[源语言]'; // example: zh
44$to = '[目标语言]'; // example: en
45$content = '[待翻译文档base64编码]';
46$format = '[文档格式]';
47$res = sendPostRequest($url, $from, $to, $content, $format);
48var_dump($res);
1curl -H "Content-Type: application/json" -X POST -d '{"from":"[源语言]","to":"[目标语言]","domain":"general","input":{"content":"[待翻译文档base64编码]","format":"[文档格式]","filename":"[文档名称]"},"output":{"formats":[输出文档格式的列表],"filename_prefix":"[输出文档前缀名称]"}}' "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create?access_token=[调用鉴权接口获取的token]"
1# -*- coding: utf-8 -*-
2
3# This code shows an example of text translation from English to Simplified-Chinese.
4# This code runs on Python 2.7.x and Python 3.x.
5# You may install `requests` to run this code: pip install requests
6# Please refer to `https://api.fanyi.baidu.com/doc/21` for complete api document
7
8import requests
9import json
10
11token = '【调用鉴权接口获取的token】'
12url = 'https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create?access_token=' + token
13
14# Build request
15headers = {'Content-Type': 'application/json'}
16payload = json.dumps({
17 "from": "en",
18 "to": "zh",
19 "input": {
20 "content": "bWFjaGluZSB0cmFuc2xhdGlvbg==",
21 "format": "txt",
22 "filename": "mttest.txt"
23 },
24 "output": {
25 "filename_prefix": "mttest_after",
26 "formats": [
27 "txt"
28 ]
29 }
30})
31
32# Send request
33r = requests.post(url, data=payload, headers=headers)
34result = r.json()
35
36# Show response
37print(json.dumps(result, indent=4, ensure_ascii=False))
1package com.baidu.ai.aip;
2
3import com.baidu.ai.aip.utils.HttpUtil;
4import com.baidu.ai.aip.utils.GsonUtils;
5
6import java.util.*;
7
8
9public class Demo {
10
11 /**
12 * 重要提示代码中所需工具类
13 * FileUtil,Base64Util,HttpUtil,GsonUtils请从
14 * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72
15 * https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2
16 * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3
17 * https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3
18 * 下载
19 */
20 public static String create() {
21 // 请求url
22 String url = "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create";
23 try {
24
25 String param = "{\"from\":\"en\",\"to\":\"zh\",\"input\":{\"content\":\"SSB3YW50IHRvIHBsYXkgYmFsbA==\",\"format\":\"txt\",\"filename\":\"mttest.txt\"},\"output\":{\"filename_prefix\":\"mttest_after\",\"formats\":[\"txt\"]}}";
26
27 // 注意这里仅为了简化编码每一次请求都去获取access_token,线上环境access_token有过期时间, 客户端可自行缓存,过期后重新获取。
28 String accessToken = "[调用鉴权接口获取的token]";
29
30 String result = HttpUtil.post(url, accessToken, "application/json", param);
31 System.out.println(result);
32 return result;
33 } catch (Exception e) {
34 e.printStackTrace();
35 }
36 return null;
37 }
38
39 public static void main(String[] args) {
40 FaceDetect.faceDetect();
41 }
42}
1#include <iostream>
2#include <curl/curl.h>
3
4// libcurl库下载链接:https://curl.haxx.se/download.html
5// jsoncpp库下载链接:https://github.com/open-source-parsers/jsoncpp/
6const static std::string request_url = "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create";
7
8int create(std::string &json_result, const std::string &access_token) {
9 std::string url = request_url + "?access_token=" + access_token;
10 CURL *curl = NULL;
11 CURLcode result_code;
12 int is_success;
13 curl = curl_easy_init();
14 if (curl) {
15 curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
16 curl_easy_setopt(curl, CURLOPT_URL, url.data());
17 curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
18 curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
19 struct curl_slist *headers = NULL;
20 headers = curl_slist_append(headers, "Content-Type: application/json");
21 curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
22 const char *data = "{\"from\":\"en\",\"to\":\"zh\",\"input\":{\"content\":\"SSB3YW50IHRvIHBsYXkgYmFsbA==\",\"format\":\"txt\",\"filename\":\"mttest.txt\"},\"output\":{\"filename_prefix\":\"mttest_after\",\"formats\":[\"txt\"]}}";
23 curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
24 json_result = curl_easy_perform(curl);
25 curl_easy_cleanup(curl);
26 is_success = 0;
27 } else {
28 fprintf(stderr, "curl_easy_init() failed.");
29 is_success = 1;
30 }
31 return is_success;
32}
1using System;
2using System.IO;
3using System.Net;
4using System.Text;
5using System.Web;
6
7namespace com.baidu.ai
8{
9 public class Demo
10 {
11 public static string create()
12 {
13 string token = "[调用鉴权接口获取的token]";
14 string host = "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/create?access_token=" + token;
15 Encoding encoding = Encoding.Default;
16 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);
17 request.Method = "post";
18 request.KeepAlive = true;
19 String str = "{\"from\":\"en\",\"to\":\"zh\",\"input\":{\"content\":\"SSB3YW50IHRvIHBsYXkgYmFsbA==\",\"format\":\"txt\",\"filename\":\"mttest.txt\"},\"output\":{\"filename_prefix\":\"mttest_after\",\"formats\":[\"txt\"]}}";
20 byte[] buffer = encoding.GetBytes(str);
21 request.ContentLength = buffer.Length;
22 request.GetRequestStream().Write(buffer, 0, buffer.Length);
23 HttpWebResponse response = (HttpWebResponse)request.GetResponse();
24 StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);
25 string result = reader.ReadToEnd();
26 Console.WriteLine(result);
27 return result;
28 }
29 }
30}
返回说明
正常返回
JSON
1{
2 "result": {
3 "id": "c7apvv4ivcpv3hudhvsg" // 文档翻译任务ID
4 },
5 "log_id": 1478723275122769663
6}
异常返回
JSON
1{
2 "error_code": 10001,
3 "error_msg": "Validation failed", // 参数检验失败
4 "log_id": 1478723447121035370
5}
查询文档翻译接口
在线调试
您可以在 示例代码中心 中调试该接口,可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。
请求说明
请求示例
HTTP 方法:POST
请求 URL:https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query
URL 参数:
参数 | 值 |
---|---|
access_token | 通过API Key和Secret Key获取的access_token,参考“Access Token获取” |
Header 如下:
参数 | 值 |
---|---|
Content-Type | application/json;charset=utf-8 |
Body中放置请求参数,参数详情如下:
请求参数
参数 | 类型 | 是否必须 | 示例 | 备注 |
---|---|---|---|---|
id | string | 是 | 1a2b3c4d | 提交文档时返回的任务ID |
例如body中请求参数:
JSON
1{
2 "id": "1a2b3c4d"
3}
请求代码示例
1<?php
2/**
3 * Send post request.
4 *
5 * @param string $url
6 * @param string $id
7 * @return mixed
8 */
9function sendPostRequest(string $url, string $id)
10{
11 $header = [
12 'Content-Type' => 'application/json'
13 ];
14 $formData = json_encode([
15 'id' => $id
16 ]);
17
18 $ch = curl_init();
19 curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
20 curl_setopt($ch, CURLOPT_POST, 1);
21 curl_setopt($ch, CURLOPT_POSTFIELDS, $formData);
22 curl_setopt($ch, CURLOPT_URL, $url);
23 curl_setopt($ch, CURLOPT_TIMEOUT, 10);
24 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
25 $res = curl_exec($ch);
26 curl_close($ch);
27
28 return $res;
29}
30
31$token = '[调用鉴权接口获取的token]';// example: xxx
32$url = 'https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query?access_token=' . $token;
33$id = '[文档id]';
34$res = sendPostRequest($url, $id);
35var_dump($res);
1curl -H "Content-Type: application/json" -X POST -d '{"id": [文档id]}' "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query?access_token=[调用鉴权接口获取的token]"
1# -*- coding: utf-8 -*-
2
3# This code shows an example of text translation from English to Simplified-Chinese.
4# This code runs on Python 2.7.x and Python 3.x.
5# You may install `requests` to run this code: pip install requests
6# Please refer to `https://api.fanyi.baidu.com/doc/21` for complete api document
7
8import requests
9import json
10
11token = '【调用鉴权接口获取的token】'
12url = 'https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query?access_token=' + token
13
14# Build request
15headers = {'Content-Type': 'application/json'}
16payload = json.dumps({
17 "id": "emlN6YGyVoJg7MkOdA8o"
18})
19
20# Send request
21r = requests.post(url, data=payload, headers=headers)
22result = r.json()
23
24# Show response
25print(json.dumps(result, indent=4, ensure_ascii=False))
1package com.baidu.ai.aip;
2
3import com.baidu.ai.aip.utils.HttpUtil;
4import com.baidu.ai.aip.utils.GsonUtils;
5
6import java.util.*;
7
8
9public class Demo {
10
11 /**
12 * 重要提示代码中所需工具类
13 * FileUtil,Base64Util,HttpUtil,GsonUtils请从
14 * https://ai.baidu.com/file/658A35ABAB2D404FBF903F64D47C1F72
15 * https://ai.baidu.com/file/C8D81F3301E24D2892968F09AE1AD6E2
16 * https://ai.baidu.com/file/544D677F5D4E4F17B4122FBD60DB82B3
17 * https://ai.baidu.com/file/470B3ACCA3FE43788B5A963BF0B625F3
18 * 下载
19 */
20 public static String query() {
21 // 请求url
22 String url = "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query";
23 try {
24
25 String param = "{\"id\": \"kR7z8nOMLV7prmE194Po\"}";
26
27 // 注意这里仅为了简化编码每一次请求都去获取access_token,线上环境access_token有过期时间, 客户端可自行缓存,过期后重新获取。
28 String accessToken = "[调用鉴权接口获取的token]";
29
30 String result = HttpUtil.post(url, accessToken, "application/json", param);
31 System.out.println(result);
32 return result;
33 } catch (Exception e) {
34 e.printStackTrace();
35 }
36 return null;
37 }
38
39 public static void main(String[] args) {
40 FaceDetect.faceDetect();
41 }
42}
1#include <iostream>
2#include <curl/curl.h>
3
4// libcurl库下载链接:https://curl.haxx.se/download.html
5// jsoncpp库下载链接:https://github.com/open-source-parsers/jsoncpp/
6const static std::string request_url = "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query";
7
8int query(std::string &json_result, const std::string &access_token) {
9 std::string url = request_url + "?access_token=" + access_token;
10 CURL *curl = NULL;
11 CURLcode result_code;
12 int is_success;
13 curl = curl_easy_init();
14 if (curl) {
15 curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "POST");
16 curl_easy_setopt(curl, CURLOPT_URL, url.data());
17 curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);
18 curl_easy_setopt(curl, CURLOPT_DEFAULT_PROTOCOL, "https");
19 struct curl_slist *headers = NULL;
20 headers = curl_slist_append(headers, "Content-Type: application/json");
21 curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);
22 const char *data = "{\"id\": \"kR7z8nOMLV7prmE194Po\"}";
23 curl_easy_setopt(curl, CURLOPT_POSTFIELDS, data);
24 json_result = curl_easy_perform(curl);
25 curl_easy_cleanup(curl);
26 is_success = 0;
27 } else {
28 fprintf(stderr, "curl_easy_init() failed.");
29 is_success = 1;
30 }
31 return is_success;
32}
1using System;
2using System.IO;
3using System.Net;
4using System.Text;
5using System.Web;
6
7namespace com.baidu.ai
8{
9 public class Demo
10 {
11 public static string query()
12 {
13 string token = "[调用鉴权接口获取的token]";
14 string host = "https://aip.baidubce.com/rpc/2.0/mt/v2/doc-translation/query?access_token=" + token;
15 Encoding encoding = Encoding.Default;
16 HttpWebRequest request = (HttpWebRequest)WebRequest.Create(host);
17 request.Method = "post";
18 request.KeepAlive = true;
19 String str = "{\"id\": \"kR7z8nOMLV7prmE194Po\"}";
20 byte[] buffer = encoding.GetBytes(str);
21 request.ContentLength = buffer.Length;
22 request.GetRequestStream().Write(buffer, 0, buffer.Length);
23 HttpWebResponse response = (HttpWebResponse)request.GetResponse();
24 StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.Default);
25 string result = reader.ReadToEnd();
26 Console.WriteLine(result);
27 return result;
28 }
29 }
30}
返回说明
正常返回
参数 | 类型 | 是否必须 |
---|---|---|
log_id | uint64 | 是 |
result | object | 是 |
其中result结构为:
名称 | 类型 | 是否一定存在 | 示例 | 备注 |
---|---|---|---|---|
data | object | 否 | 请求结果数据集,当且仅当code 为 0 时存在 |
|
data.id | string | 是 | 1a2b3c4d | 任务ID |
data.from | string | 是 | en | 源语言,具体参考语种列表,若源语言设置为auto时,可自动检测出语种 |
data.to | string | 是 | zh | 目标语言,具体参考语种列表 |
data.domain | string | 否 | 垂直领域,不传则为通用领域,支持的领域具体参考“垂直领域映射表” | |
data.input | object | 是 | ||
data.input.format | string | 是 | 输入的文件类型,支持的文件类型具体参考 “文档输出类型映射表 - 输入类型” | |
data.input.filename | string | 是 | 测试文件 | 输入的文件名称,不传则随机生成 |
data.input.size | integer | 是 | 10987 | 输入的文件大小,单位为字节 |
data.input.character_count | integer | 否 | 5000 | 输入的文件字符数,具体规则参见附录 |
data.output | object | 是 | 输出信息 | |
data.output.files | object[] | 否 | 译文文件信息,当且仅当文件翻译成功时存在 | |
data.output.files[].format | string | 是 | 输出文件的格式 | |
data.output.files[].filename | string | 是 | 测试文件译文.docx | 输出的文件名称 |
data.output.files[].size | string | 否 | 输出的文件大小,当且仅当文件翻译成功时存在 | |
data.output[].url | string | 否 | 输出的文件下载地址,当且仅当文件翻译成功时存在 | |
data.status | string | 是 | Succeeded | 任务状态,参见文档翻译任务状态 |
data.reason | string | 是 | Succeeded | 对任务状态的补充说明 |
data.created_at | integer | 是 | 1626422326 | 文档上传时间,unix 时间戳(精度:秒) |
data.updated_at | integer | 是 | 1626422326 | 任务最近一次状态更新时间,unix 时间戳(精度:秒)。Expired不会更新此时间 |
data.expired_at | integer | 是 | 1777422326 | 任务过期时间。任务过期后,文件会无法下载,即不会提供url相关的参数。若无过期时间则为0 |
- 待翻译(NotStarted)
JSON
1{
2 "log_id": 1413409052597883633,
3 "result": {
4 "data": {
5 "id": "1a2b3c4d",
6 "from": "en",
7 "to": "zh",
8 "domain": "general",
9 "input": {
10 "format": "pdf",
11 "filename": "测试文件.pdf"
12 },
13 "status": "NotStarted",
14 "reason": "in queue",
15 "created_at": 1626422326,
16 "updated_at": 1626422340
17 }
18 }
19}
- 翻译中(Running,无字符数预统计):
JSON
1{
2 "log_id": 1413409052597883633,
3 "result": {
4 "data": {
5 "id": "1a2b3c4d",
6 "from": "en",
7 "to": "zh",
8 "domain": "general",
9 "input": {
10 "format": "pdf",
11 "filename": "测试文件.pdf",
12 "size": 10987
13 },
14 "status": "Running",
15 "reason": "Running",
16 "created_at": 1626422326,
17 "updated_at": 1626422340
18 }
19 }
20}
- 翻译中(Running,有字符数预统计)
JSON
1{
2 "log_id": 1413409052597883633,
3 "result": {
4 "data": {
5 "id": "1a2b3c4d",
6 "from": "en",
7 "to": "zh",
8 "domain": "general",
9 "input": {
10 "format": "pdf",
11 "filename": "测试文件.pdf",
12 "size": 10987,
13 "character_count": 5000
14 },
15 "status": "Running",
16 "reason": "Running",
17 "created_at": 1626422326,
18 "updated_at": 1626422340,
19 }
20 }
21}
- 翻译成功:
JSON
1{
2 "log_id": 1413409052597883633,
3 "result": {
4 "data": {
5 "id": "1a2b3c4d",
6 "from": "en",
7 "to": "zh",
8 "domain": "general",
9 "input": {
10 "format": "pdf",
11 "filename": "测试文件.pdf",
12 "size": 10987,
13 "character_count": 5000
14 },
15 "output": {
16 "files": [
17 {
18 "format": "docx",
19 "filename": "测试文件译文.docx",
20 "size": 14058,
21 "url": "https://xxx.com/测试文件译文.docx"
22 },
23 {
24 "format": "pdf",
25 "filename": "测试文件译文.pdf",
26 "size": 14058,
27 "url": "https://xxx.com/测试文件译文.pdf"
28 }
29 ]
30 },
31 "status": "Succeeded",
32 "reason": "Succeeded",
33 "created_at": 1626422326,
34 "updated_at": 1626422340,
35 "expired_at": 1777422340
36 }
37 }
38}
- 翻译失败:
JSON
1{
2 "log_id": 1413409052597883633,
3 "result": {
4 "data": {
5 "id": "1a2b3c4d",
6 "from": "en",
7 "to": "zh",
8 "domain": "general",
9 "input": {
10 "format": "pdf",
11 "filename": "测试文件.pdf",
12 "size": 10987,
13 "character_count": 5000
14 },
15 "status": "Failed",
16 "reason": "文档解析失败",
17 "created_at": 1626422326,
18 "updated_at": 1626422340,
19 "expired_at": 1777422340
20 }
21 }
22}
- 任务过期:
JSON
1{
2 "log_id": 1413409052597883633,
3 "result": {
4 "data": {
5 "id": "1a2b3c4d",
6 "from": "en",
7 "to": "zh",
8 "domain": "general",
9 "input": {
10 "format": "pdf",
11 "filename": "测试文件.pdf",
12 "size": 10987,
13 "character_count": 5000
14 },
15 "status": "Failed",
16 "reason": "文档解析失败",
17 "created_at": 1626422326,
18 "updated_at": 1626422340,
19 "expired_at": 1777422340
20 }
21 }
22}
异常返回
参数 | 类型 | 是否必须 | 描述 | 备注 |
---|---|---|---|---|
log_id | uint64 | 是 | 唯一的log id,用于问题定位 | |
error_msg | text | 是 | 错误消息体 | 错误描述,具体可读信息 |
error_code | uint64 | 是 | 错误码 | 错误状态码,具体错误参考 错误码。注意这个是请求query接口的状态码,不是任务的状态 |
例如:
JSON
1{
2 "log_id": 1413409052597883633,
3 "error_msg": "Internal server error",
4 "error_code": 10000
5}
JSON
1{
2 "log_id": 1413409052597883633,
3 "error_msg": "auth open api usage limit reached",
4 "error_code": 31005
5}
文档输出类型映射表
输入类型 | 输出类型 | 默认类型 |
---|---|---|
doc | docx,pdf | docx |
docx | docx,pdf | docx |
docx,pdf | docx | |
xls | xlsx | xlsx |
xlsx | xlsx | xlsx |
html | html | html |
htm | html | html |
ppt | pptx | pptx |
pptx | pptx | pptx |
txt | txt | txt |
xml | xml | xml |
垂直领域映射表
名称 | 参数值 |
---|---|
通用领域 | general |
错误码列表
接口流控及鉴权错误码
错误码 | 错误信息 | 描述 | 解决办法 |
---|---|---|---|
1 | Unknown error | 未知错误 | 请重试 |
2 | Service temporarily unavailable | 服务处理超时 | 请重试 |
4 | Open api request limit reached | 集群超限额 | 请重试 |
6 | no permission to access data | 没有接口权限 | 请确认您调用的接口已经被赋权。企业认证生效时间为1小时左右,使用需要企业认证的服务,请等待生效后重试 |
18 | Open api qps request limit reached | QPS超限额 | 请降低您的调用频率 |
19 | Open api total request limit reached | 请求总量超限额 | 请检查当前可用字符/次数包额度 |
100 | Invalid parameter | 请求参数不合法 | 请检查请求参数是否正确,可能的原因是token拉取失败,无效的access token参数等 |
110 | Access token invalid or no longer valid | Access Token失效 | token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token |
111 | Access token expired | Access token过期 | token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token |
通用及业务错误码
错误码 | 错误信息 | 描述 | 解决办法 |
---|---|---|---|
10000 | Internal server error | 服务器内部错误 | 请重试 |
10001 | Validation failed | 参数错误 | 请检查请求参数 |
10002 | Internal server error | 数据库错误 | 请重试 |
10003 | Internal server error | 缓存服务错误 | 请重试 |
10004 | Too many requests | 请求QPS超限制 | 请重试 |
20100 | Resource storage failed | 文件资源存储异常 | 请重试 |
20101 | Publish queue failed | 队列服务异常 | 请重试 |
282000 | internal error | 内部错误 | 请重试 |
282003 | missing required parameter(s) | 用户请求参数中缺少必填信息 | 检查请求参数是否包含全部必填字段 |
216100 | invalid param | 用户请求参数中的字段无效 | 检查请求参数字段格式 |
216202 | input oversize | 用户请求参数体过大 | 检查输入文档翻译大小,需小于50M |
282004 | invalid parameter(s) | 用户查询时输入的user id与创建时不一致 | 输入正确且匹配的用户id和文档id |
31001 | auth unknown error | 其他错误 | 请重试 |
31005 | auth open api usage limit reached | 用户用量超限 | 请检查当前可用字符/次数包额度 |
31006 | auth internal error | 鉴权流控内部错误 | 请重试 |
语种列表
**源语言语种不确定时可设置为 auto,目标语言语种不可设置为 auto**中文首字母 | 名称 | 代码 | 语种检测 | 名称 | 代码 | 语种检测 | 名称 | 代码 | 语种检测 |
---|---|---|---|---|---|---|---|---|---|
A | 阿拉伯语 | ara | 是 | 爱尔兰语 | gle | 是 | 奥克语 | oci | 是 |
阿尔巴尼亚语 | alb | 是 | 阿尔及利亚阿拉伯语 | arq | 否 | 阿肯语 | aka | 否 | |
阿拉贡语 | arg | 否 | 阿姆哈拉语 | amh | 是 | 阿萨姆语 | asm | 是 | |
艾马拉语 | aym | 否 | 阿塞拜疆语 | aze | 是 | 阿斯图里亚斯语 | ast | 是 | |
奥塞梯语 | oss | 否 | 爱沙尼亚语 | est | 是 | 奥杰布瓦语 | oji | 否 | |
奥里亚语 | ori | 是 | 奥罗莫语 | orm | 否 | ||||
B | 波兰语 | pl | 是 | 波斯语 | per | 是 | 布列塔尼语 | bre | 是 |
巴什基尔语 | bak | 否 | 巴斯克语 | baq | 是 | 巴西葡萄牙语 | pot | 否 | |
白俄罗斯语 | bel | 是 | 柏柏尔语 | ber | 是 | 邦板牙语 | pam | 否 | |
保加利亚语 | bul | 是 | 北方萨米语 | sme | 否 | 北索托语 | ped | 否 | |
本巴语 | bem | 否 | 比林语 | bli | 否 | 比斯拉马语 | bis | 否 | |
俾路支语 | bal | 否 | 冰岛语 | ice | 是 | 波斯尼亚语 | bos | 是 | |
博杰普尔语 | bho | 否 | |||||||
C | 楚瓦什语 | chv | 否 | 聪加语 | tso | 否 | |||
D | 丹麦语 | dan | 是 | 德语 | de | 是 | 鞑靼语 | tat | 是 |
掸语 | sha | 否 | 德顿语 | tet | 否 | 迪维希语 | div | 否 | |
低地德语 | log | 是 | |||||||
E | 俄语 | ru | 是 | ||||||
F | 法语 | fra | 是 | 菲律宾语 | fil | 是 | 芬兰语 | fin | 是 |
梵语 | san | 否 | 弗留利语 | fri | 否 | 富拉尼语 | ful | 否 | |
法罗语 | fao | 否 | |||||||
G | 盖尔语 | gla | 否 | 刚果语 | kon | 否 | 高地索布语 | ups | 否 |
高棉语 | hkm | 是 | 格陵兰语 | kal | 否 | 格鲁吉亚语 | geo | 是 | |
古吉拉特语 | guj | 是 | 古希腊语 | gra | 否 | 古英语 | eno | 否 | |
瓜拉尼语 | grn | 否 | |||||||
H | 韩语 | kor | 是 | 荷兰语 | nl | 是 | 胡帕语 | hup | 否 |
哈卡钦语 | hak | 否 | 海地语 | ht | 否 | ||||
豪萨语 | hau | 否 | 黑山语 | mot | 否 | ||||
J | 吉尔吉斯语 | kir | 否 | 加利西亚语 | glg | 是 | 加拿大法语 | frn | 否 |
加泰罗尼亚语 | cat | 是 | 捷克语 | cs | 是 | ||||
K | 卡拜尔语 | kab | 是 | 卡纳达语 | kan | 是 | 卡努里语 | kau | 否 |
卡舒比语 | kah | 否 | 康瓦尔语 | cor | 否 | 科萨语 | xho | 是 | |
科西嘉语 | cos | 否 | 克里克语 | cre | 否 | 克里米亚鞑靼语 | cri | 否 | |
克林贡语 | kli | 否 | 克罗地亚语 | hrv | 是 | 克丘亚语 | que | 否 | |
克什米尔语 | kas | 否 | 孔卡尼语 | kok | 否 | 库尔德语 | kur | 是 | |
L | 拉丁语 | lat | 是 | 老挝语 | lao | 否 | 罗马尼亚语 | rom | 是 |
拉特加莱语 | lag | 否 | 拉脱维亚语 | lav | 是 | 林堡语 | lim | 否 | |
林加拉语 | lin | 否 | 卢干达语 | lug | 否 | 卢森堡语 | ltz | 否 | |
卢森尼亚语 | ruy | 否 | 卢旺达语 | kin | 是 | 立陶宛语 | lit | 是 | |
罗曼什语 | roh | 否 | 罗姆语 | ro | 否 | 逻辑语 | loj | 否 | |
M | 马来语 | may | 是 | 缅甸语 | bur | 是 | 马拉地语 | mar | 否 |
马拉加斯语 | mg | 是 | 马拉雅拉姆语 | mal | 是 | 马其顿语 | mac | 是 | |
马绍尔语 | mah | 否 | 迈蒂利语 | mai | 是 | 曼克斯语 | glv | 否 | |
毛里求斯克里奥尔语 | mau | 否 | 毛利语 | mao | 否 | 孟加拉语 | ben | 是 | |
马耳他语 | mlt | 是 | 苗语 | hmn | 否 | ||||
N | 挪威语 | nor | 是 | 那不勒斯语 | nea | 否 | 南恩德贝莱语 | nbl | 否 |
南非荷兰语 | afr | 是 | 南索托语 | sot | 否 | 尼泊尔语 | nep | 是 | |
P | 葡萄牙语 | pt | 是 | 旁遮普语 | pan | 是 | 帕皮阿门托语 | pap | 否 |
普什图语 | pus | 否 | |||||||
Q | 齐切瓦语 | nya | 否 | 契维语 | twi | 否 | 切罗基语 | chr | 否 |
R | 日语 | jp | 是 | 瑞典语 | swe | 是 | |||
S | 萨丁尼亚语 | srd | 否 | 萨摩亚语 | sm | 否 | 塞尔维亚-克罗地亚语 | sec | 否 |
塞尔维亚语 | srp | 是 | 桑海语 | sol | 否 | 僧伽罗语 | sin | 是 | |
世界语 | epo | 是 | 书面挪威语 | nob | 是 | 斯洛伐克语 | sk | 是 | |
斯洛文尼亚语 | slo | 是 | 斯瓦希里语 | swa | 是 | ||||
索马里语 | som | 是 | 塞尔维亚语(西里尔) | src | 否 | ||||
T | 泰语 | th | 是 | 土耳其语 | tr | 是 | 塔吉克语 | tgk | 是 |
泰米尔语 | tam | 是 | 他加禄语 | tgl | 是 | 提格利尼亚语 | tir | 否 | |
泰卢固语 | tel | 是 | 突尼斯阿拉伯语 | tua | 否 | 土库曼语 | tuk | 否 | |
W | 乌克兰语 | ukr | 是 | 瓦隆语 | wln | 是 | 威尔士语 | wel | 是 |
文达语 | ven | 否 | 沃洛夫语 | wol | 否 | 乌尔都语 | urd | 是 | |
X | 西班牙语 | spa | 是 | 希伯来语 | heb | 是 | 希腊语 | el | 是 |
匈牙利语 | hu | 是 | 西弗里斯语 | fry | 是 | 西里西亚语 | sil | 否 | |
希利盖农语 | hil | 否 | 下索布语 | los | 否 | 夏威夷语 | haw | 否 | |
新挪威语 | nno | 是 | 西非书面语 | nqo | 否 | 信德语 | snd | 否 | |
修纳语 | sna | 否 | 宿务语 | ceb | 否 | 叙利亚语 | syr | 否 | |
巽他语 | sun | 否 | |||||||
Y | 英语 | en | 是 | 印地语 | hi | 是 | 印尼语 | id | 是 |
意大利语 | it | 是 | 越南语 | vie | 是 | 意第绪语 | yid | 否 | |
因特语 | ina | 否 | 亚齐语 | ach | 否 | 印古什语 | ing | 否 | |
伊博语 | ibo | 否 | 伊多语 | ido | 否 | 约鲁巴语 | yor | 否 | |
亚美尼亚语 | arm | 是 | 伊努克提图特语 | iku | 否 | ||||
Z | 中文(简体) | zh | 是 | 中文(繁体) | cht | 是 | 中文(文言文) | wyw | 是 |
中文(粤语) | yue | 是 | 扎扎其语 | zaz | 否 | 中古法语 | frm | 否 | |
祖鲁语 | zul | 否 | 爪哇语 | jav | 否 | 自动检测 | auto | 是 |