human: 如何处理七牛云的智能多媒体服务翻译狗文档翻译

gpt: [智能多媒体服务](https://developer.qiniu.com/dora) > API 文档 > Open API >翻译狗文档翻译

#  翻译狗文档翻译

最近更新时间: 2021-11-18 18:06:02

# 接口简介

翻译狗文档翻译接口提供多格式、多语种、高质量的文档翻译服务，支持pdf、doc、docx、ppt、pptx、xls、xlsx等格式，支持源语言自动检测，只需指定文档链接并指定目标语言、文档格式、需要存储至七牛kodo的bucket等参数，即可在七牛云存储kodo中获取翻译后的文档。

# 调用链路

![image.png](https://dn-odum9helk.qbox.me/FlZN-t_OiBANPysS44sm2Rd4Zpv9)

# 接口规格

## 翻译请求接口

**请求URL** : `https://ap-gate-z0.qiniuapi.com/translate/v1/document/translate`

**字符编码格式** : 请求及返回结果都使用 UTF-8 字符集进行编码

**请求方法** : POST

**建议超时时长** : 3s

**请求头部** :

字段 | 取值  
---|---  
Content-Type | application/json  
Authorization | Qiniu <AccessKey>:<Sign> 注意: 用户请根据 AccessKey 和 SuccessKey 生成鉴权，以便进行身份验证。<Sign> 的取值请参考[七牛鉴权 __](https://developer.qiniu.com/dora/kb/3702/QiniuToken)  
  
**请求参数** : 放在 HTTP Body 中，采用 json 格式，具体参数如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
url | string | Y | 需要翻译的资源的链接  
注意：  
1\. 文件格式限定为: pdf、doc、docx、ppt、pptx、xls、xlsx  
2\. 文件最大限制问50M  
3\. 不支持扫描件、图纸、纯图片文档，加密文件请先去除密码  
from | string | Y | 源语言，支持自动检测。具体见语言列表  
to | string | Y | 目标语言，不支持自动检测。具体见语言列表  
dType | int | Y | 翻译后的文件类型， 取值 2 或者 3  
2: 翻译后的pdf文件，支持格式：word、pdf、img  
3: 翻译后的word文件（支持格式：word、pdf)；ppt文件（支持格式：img、ppt）；  
excel文件（支持格式：excel）  
bucket | string | Y | 翻译后的文件，转存到kodo的哪个bucket  
callback | string | Y | 翻译完成后的回调，支持http、https  
industryId | int | N | 行业代码。具体见行业列表  
excelMode | int | N | 指定excel翻译模式   
0：只翻译当前打开sheet（默认）  
1：翻译全部sheet（页数按全部sheet字符数来计算）  
bilingualControl | int | N | 指定翻译模式   
0：译文单独为一个文档（默认）  
1：双语对照（原文和译文在一个文档）  
  
**返回参数** : 放在 HTTP Body 中，采用 json 格式，具体参数如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
code | int | Y | 结果码，100表示调用成功。具体详见状态码列表  
msg | string | Y | 结果信息的文本描述  
data | json_object | Y | 返回数据结果集  
  
其中data的具体内容如下

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
entryId | string | Y | 请求的唯一标识  
  
## 异步回调获取结果接口

**说明** ：该接口需要服务调用方实现，对应翻译请求接口中的`callback`参数。七牛服务器会在翻译完成后调用该接口

**字符编码格式：** 请求及返回结果都使用 UTF-8 字符集进行编码

**请求方法：** POST

**回调参数：** 放在 HTTP Body 中，采用 json 格式，具体参数如下：

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
code | int | Y | 结果码，200表示调用成功。具体详见状态码列表  
msg | string | Y | 结果信息的文本描述  
data | json_object | Y | 返回数据结果集  
  
其中data的具体内容如下

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
entryId | string | Y | 请求的唯一标识  
fileKey | string | Y | 翻译后的文件在kodo指定kucket中的key  
pageCount | int | Y | 翻译的有效页数  
translationDone | bool | Y | 翻译是否完成的判断字段  
  
## 查询翻译结果接口

**说明** ：除了接收回调之外，使用者还可以通过该接口主动查询翻译进度和结果

**请求URL** : `https://ap-gate-z0.qiniuapi.com/translate/v1/document/query`

**字符编码格式** : 请求及返回结果都使用 UTF-8 字符集进行编码

**请求方法** : GET

**建议超时时长** : 3s

**请求头部** :

字段 | 取值  
---|---  
Content-Type | application/json  
Authorization | Qiniu <AccessKey>:<Sign> 注意: 用户请根据 AccessKey 和 SuccessKey 生成鉴权，以便进行身份验证。<Sign> 的取值请参考[七牛鉴权 __](https://developer.qiniu.com/dora/kb/3702/QiniuToken)  
  
**请求参数** : 放在 QueryString 中，具体参数如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
entryId | string | Y | 请求的唯一标识  
  
**返回参数** : 放在 HTTP Body 中，采用 json 格式，具体参数如下:

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
code | int | Y | 结果码，100表示翻译完成。102代表正在翻译中。  
具体详见状态码列表  
msg | string | Y | 结果信息的文本描述  
data | json_object | Y | 返回数据结果集  
  
其中data的具体内容如下

参数名称 | 类型 | 是否必选 | 说明  
---|---|---|---  
entryId | string | Y | 请求的唯一标识  
fileKey | string | N | 翻译后的文件在kodo指定kucket中的key  
pageCount | int | N | 翻译的有效页数  
translationDone | bool | Y | 翻译是否完成的判断字段  
  
# 示例

## 翻译请求示例

    
    
    POST /translate/v1/document/translate HTTP/1.1
    Host: ap-gate-z0.qiniuapi.com
    Content-Type: application/json
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    
    {
        "url": "http://xx.emm/trans-min.docx",
        "dType": 2,
        "from": "auto",
        "to": "en",
        "industryId": 0,
        "excelMode": 0,
        "bilingualControl": 0,
        "bucket": "test-bucket",
        "callback": "http://test.emm/callback"
    }
    

## 翻译请求成功返回示例

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
        "code": 100,
        "msg": "请求成功",
        "data": {
            "entryId": "61446e07000000003a4b6d31703f790c"
        }
    }
    

## 查询翻译结果接口示例

    
    
    GET /translate/v1/document/query?entryId=61446e07000000003a4b6d31703f790c HTTP/1.1
    Host: ap-gate-z0.qiniuapi.com
    Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=
    

# 接口规则

## 支持的语言列表

语言代码| 语言  
---|---  
auto| 自动检测  
sq| 阿尔巴尼亚语  
ga| 爱尔兰语  
est| 爱沙尼亚语  
ara| 阿拉伯语  
am| 阿姆哈拉语  
or| 奥里亚语  
az| 阿塞拜疆语  
be| 白俄罗斯语  
bul| 保加利亚语  
ba| 巴什基尔语  
eu| 巴斯克语  
is| 冰岛语  
pl| 波兰  
bs| 波斯尼亚语  
fa| 波斯语  
af| 布尔语(南非荷兰语)  
tt| 鞑靼语  
dan| 丹麦语  
de| 德语  
ru| 俄语  
fra| 法语  
fj| 斐济语  
tl| 菲律宾语  
fin| 芬兰语  
fy| 弗里西语  
km| 高棉语  
ka| 格鲁吉亚语  
gu| 古吉拉特语  
ht| 海地克里奥尔语  
kor| 韩语  
ha| 豪萨语  
kk-kz| 哈萨克语  
kk| 哈萨克语(西里尔)  
nl| 荷兰语  
gl| 加利西亚语  
ca| 加泰罗尼亚语  
cs| 捷克语  
ky| 吉尔吉斯语  
kn| 卡纳达语  
otq| 克雷塔罗奥托米语  
tlh| 克林贡语  
hr| 克罗地亚语  
co| 科西嘉语  
ku| 库尔德语  
la| 拉丁语  
lo| 老挝语  
lv| 拉脱维亚语  
lt| 立陶宛语  
rom| 罗马尼亚语  
lb| 卢森堡语  
rw| 卢旺达语  
mg| 马尔加什语  
mt| 马耳他语  
ms| 马来语  
mr| 马拉提语  
ml| 马拉雅拉姆语  
mi| 毛利语  
mk| 马其顿语  
mo| 蒙古语  
mn| 蒙古语(西里尔)  
bn| 孟加拉语  
hmn| 苗语  
xh| 南非科萨语  
zu| 南非祖鲁语  
ne| 尼泊尔语  
no| 挪威语  
pa| 旁遮普语  
pap| 帕皮阿门托语  
ps| 普什图语  
pt| 葡萄牙语  
ny| 齐切瓦语  
jp| 日语  
swe| 瑞典语  
sr-Latn| 塞尔维亚语(拉丁文)  
sr| 塞尔维亚语(西里尔)  
st| 塞索托语  
sm| 萨摩亚语  
si| 僧加罗语  
eo| 世界语  
sk| 斯洛伐克语  
slo| 斯洛文尼亚语  
sw| 斯瓦希里语  
gd| 苏格兰盖尔语  
so| 索马里语  
ceb| 宿务语  
te| 泰卢固语  
ta| 泰米尔语  
th| 泰语  
tg| 塔吉克语  
to| 汤加语  
ty| 塔希提语  
tr| 土耳其语  
tk| 土库曼语  
cy| 威尔士语  
ug| 维吾尔语  
udm| 乌德穆尔特语  
ur| 乌尔都语  
uk| 乌克兰语  
uz| 乌兹别克语  
haw| 夏威夷语  
spa| 西班牙语  
iw| 希伯来语  
el| 希腊语  
sd| 信德语  
hu| 匈牙利语  
sn| 修纳语  
hy| 亚美尼亚语  
ig| 伊博语  
it| 意大利语  
yi| 意第绪语  
hi| 印地语  
en| 英语  
su| 印尼巽他语  
id| 印尼语  
jw| 印尼爪哇语  
ii| 彝语  
yua| 尤卡坦玛雅语  
yo| 约鲁巴语  
vie| 越南语  
zh| 中文  
cht| 中文繁体  
yue| 中文粤语(繁体)  
za| 壮语  
  
## 行业列表

行业代码| 行业  
---|---  
1| 法律  
2| 金融  
3| 农林牧渔  
4| 医药卫生  
5| 建筑建材  
6| 冶金矿产  
7| 石油化工  
8| 水利水电  
9| 交通运输  
10| 信息产业  
11| 机械机电  
12| 轻工食品  
13| 服装纺织  
14| 专业服务  
15| 安全防护  
16| 环保绿化  
17| 旅游休闲  
18| 办公文教  
19| 电子电工  
20| 玩具礼品  
21| 家居用品  
22| 物资  
23| 包装  
24| 体育  
25| 办公  
26| 其他  
  
# 状态码列表

状态码 | 状态描述  
---|---  
200 | 请求成功  
400 | 参数错误  
500 | 内部错误  
  
# 价格

0.5元/页

以上内容是否对您有帮助？