翻译狗文档翻译
接口简介
翻译狗文档翻译接口提供多格式、多语种、高质量的文档翻译服务,支持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元/页