智能多媒体服务

  • 智能多媒体服务 > API 文档 > Open API >翻译狗文档翻译

    翻译狗文档翻译

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

    接口简介

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

    调用链路

    image.png

    接口规格

    翻译请求接口

    请求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元/页

    以上内容是否对您有帮助?
  • Qvm free helper
    Close