开放能力
开发平台
行业应用
生态合作
开发与教学
资讯 社区 控制台
技术能力
语音技术
图像技术
文字识别
人脸与人体识别
视频技术
AR与VR
自然语言处理
知识图谱
数据智能
场景方案
部署方案
行业应用
智能教育
智能医疗
智能零售
智能工业
企业服务
智能政务
智能农业
信息服务
智能园区
智能硬件
机器翻译

    文本翻译-词典版

    接口描述

    在文本翻译-通用版的基础上,提供词典资源和语音合成资源。

    词典资源

    词典分中英词典,由于每个词属性不同,词典结果不一定包含所有部分。 如源语言为中文,词典数据包括:拼音、词性、中文释义、英文释义、近义词等资源。 如源语言为英文,词典数据包括:英文释义、中文释义、音标、核心词汇类别等。 注:单个 query 需为词、词组或短语,如 query 为句子,则 dict 字段为空。

    语音合成资源:

    语音合成资源包含 query 原文、译文的发音,以 mp3 文件格式提供。 注:单个query内不支持分段,只有1段且字符数量不超过200的query才会返回tts字段。

    请求说明

    请求示例

    HTTP 方法:POST

    请求 URL:https://aip.baidubce.com/rpc/2.0/mt/texttrans-with-dict/v1

    URL 参数:

    参数
    access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取”

    Header 如下:

    参数
    Content-Type application/json;charset=utf-8

    Body中放置请求参数,参数详情如下:

    请求参数

    参数 类型 是否必须 描述 备注
    from text 翻译源语言 可设置为auto
    to text 翻译目标语言 不可设置为auto
    q text 请求翻译query

    例如body中请求参数:

    {"q":"hello","from":"en","to":"zh"}

    请求代码示例

    <?php
    /**
     * Send post request.
     *
     * @param string $url
     * @param string $q
     * @param string $from
     * @param string $to
     * @return mixed
     */
    function sendPostRequest(string $url, string $q, string $from, string $to)
    {
        $header = [];
        $formData = [
            'from' => $from,
            'to' => $to,
            'q' => $q,
        ];
        
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $formData);
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        $res = curl_exec($ch);
        curl_close($ch);
        
        return $res;
    }
    
    $token = '[调用鉴权接口获取的token]';// example: xxx
    $url = 'https://aip.baidubce.com/rpc/2.0/mt/texttrans-with-dict/v1?access_token=' . $token;
    $q = '输入query'; // example: hello
    $from = '源语种方向'; // example: zh
    $to = '目标语种方向'; // example: en
    $res = sendPostRequest($url, $q, $from, $to);
    var_dump($res);
    curl -H "Content-Type: application/json" -X POST -d '{"q":"[待翻译文字]","from":"[源语言]","to":"[目标语言]"}' "https://aip.baidubce.com/rpc/2.0/mt/texttrans-with-dict/v1?access_token=[调用鉴权接口获取的token]"

    返回说明

    返回参数

    正常返回

    参数 类型 是否必须 描述 备注
    log_id uint64 唯一的log id,用于问题定位
    result object 返回结果json串,其内包含要调用的各个模型服务的返回结果
    +from text 源语种方向
    +to text 目标语种方向
    +trans_result array 翻译结果
    ++src text 翻译原文 翻译服务会根据结果换行断句
    ++dst text 译文 翻译服务会根据结果换行断句
    ++src_tts text 原文tts
    ++dst_tts text 译文tts
    ++dict object 词典数据详情 格式参考百度翻译API词典资源-接入字段说明
    例如:
    {
    "result": {
        "trans_result": [
            {
                "dst": "你好",
                "dst_tts": "https://fanyi-api.baidu.com/api/trans/api/tts?query=%E4%BD%A0%E5%A5%BD&appid=202105250003&lang=zh&sign=4dff83efd4a0ff36e8806efd2a0421b4",
                "src": "hello",
                "dict": "{\"lang\":\"1\",\"word_result\":{\"edict\":{\"item\":[{\"tr_group\":[{\"tr\":[\"an expression of greeting\"],\"example\":[\"every morning they exchanged polite hellos\"],\"similar_word\":[\"hullo\",\"hi\",\"howdy\",\"how-do-you-do\"]}],\"pos\":\"noun\"}],\"word\":\"hello\"},\"zdict\":\"\",\"simple_means\":{\"word_name\":\"hello\",\"from\":\"original\",\"word_means\":[\"\\u54c8\\u7f57\\uff0c\\u5582\\uff0c\\u4f60\\u597d\",\"\\u563f\",\"\\u5582\\uff0c\\u563f\"],\"tags\":{\"core\":[\"\\u9ad8\\u8003\",\"CET4\",\"\\u8003\\u7814\"],\"other\":[\"\"]},\"exchange\":{\"word_pl\":[\"hellos\"]},\"symbols\":[{\"ph_en\":\"h\\u0259\\u02c8l\\u0259\\u028a\",\"ph_am\":\"h\\u0259\\u02c8lo\\u028a\",\"parts\":[{\"part\":\"int.\\/n.\",\"means\":[\"(\\u7528\\u4e8e\\u95ee\\u5019\\u3001\\u63a5\\u7535\\u8bdd\\u6216\\u5f15\\u8d77\\u6ce8\\u610f)\\u54c8\\u7f57\\uff0c\\u5582\\uff0c\\u4f60\\u597d\",\"(\\u8868\\u793a\\u60ca\\u8bb6)\\u563f\",\"(\\u8ba4\\u4e3a\\u522b\\u4eba\\u8bf4\\u4e86\\u8822\\u8bdd\\u6216\\u6ca1\\u6709\\u6ce8\\u610f\\u542c)\\u5582\\uff0c\\u563f\"]}],\"ph_other\":\"\"}]}}}",
                "src_tts": "https://fanyi-api.baidu.com/api/trans/api/tts?query=hello&appid=202105250003&lang=en&sign=7706a561affdd857a5df5cc277db63f1"
            }
        ],
        "from": "en",
        "to": "zh"
    },
    "log_id": 1413396008503877484

    异常返回

    参数 类型 是否必须 描述
    log_id uint64 唯一的log id,用于问题定位
    error_msg text 错误消息体
    error_code text 错误码
    例如:
    {
        "log_id": 1413409483863477151,
        "error_msg": "translate internal error",
        "error_code": 31102
    }

    错误码列表

    接口流控及鉴权错误码

    错误码 错误信息 描述 解决方法
    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参数 参考“Access Token重新获取”
    110 Access token invalid or no longer valid Access Token失效 token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token
    111 Access token expired Access token过期 token有效期为30天,注意需要定期更换,也可以每次请求都拉取新token

    通用及业务错误码

    错误码 错误信息 描述 解决方法
    31001 auth unknown error 其他错误 请重试
    31005 auth open api usage limit reached 用户用量超限 请检查当前可用字符/次数包额度
    31006 auth internal error 内部错误 请重试
    31101 translate request timeout 请求超时 请重试
    31102 translate internal error 系统错误 请重试
    31103 translate parameter error 必填参数为空或固定参数有误 请检查参数是否为空或误传
    31104 translate frequency limited 访问频率受限 请降低您的调用频率
    31105 translate target language not supported 译文语言方向不支持 请检查译文语言是否在语言列表里
    31106 translate query string too long query字符超过最大长度 请减少翻译译文的长度(最长不得超过6000字节)
    31201 engine-biz query string too long 请求翻译的原文太长 请减少翻译译文的长度(最长不得超过6000字节)
    31202 engine-biz query string is empty 请求翻译的原文为空 请检查翻译原文内容是否为空
    31203 engine-biz parameter invalid 请求翻译的参数有误(目前校验header/param中鉴权必要参数不能为空) 请检查参数是否为空或误传
    282000 internal error 内部错误 请重试
    282003 missing required parameter(s) 请求翻译时存在必填参数为空 请检查必填参数(比如q、from、to等)是否为空

    语种列表

    中文首字母 名称 代码 语种检测 名称 代码 语种检测 名称 代码 语种检测
    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
    伊朗语 ir





    Z 中文(简体) zh 中文(繁体) cht 中文(文言文) wyw
    中文(粤语) yue 扎扎其语 zaz 中古法语 frm
    祖鲁语 zul 爪哇语 jav






    上一篇
    文本翻译-通用版
    下一篇
    图片翻译