翻译狗文档翻译
接口简介
翻译狗文档翻译接口提供多格式、多语种、高质量的文档翻译服务,支持pdf、doc、docx、ppt、pptx、xls、xlsx等格式,支持源语言自动检测,只需指定文档链接并指定目标语言、文档格式、需要存储至七牛kodo的bucket等参数,即可在七牛云存储kodo中获取翻译后的文档。
调用链路
接口规格
翻译请求接口
请求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> 的取值请参考七牛鉴权 |
请求参数: 放在 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> 的取值请参考七牛鉴权 |
请求参数: 放在 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元/页