前言

本博文将介绍如何用 Python 调用百度翻译通用翻译 API.

欢迎使用通用翻译API，本文档将指导您如何快速接入。

原教程链接: https://fanyi-api.baidu.com/doc/21 .

操作系统：Windows 10 家庭版

参考文档

  1. 通用翻译API接入文档

如何使用通用翻译API？

  1. 使用您的百度账号登录百度翻译开放平台；

  2. 注册成为开发者，获得 APPID

  3. 进行开发者认证（如仅需标准版可跳过）；

  4. 开通通用翻译API服务：开通链接；

  5. 参考技术文档和 Demo 编写代码。

具体步骤

  1. 百度翻译地址: https://fanyi.baidu.com/ .

  2. 点击翻译API .

  3. 找到通用翻译, 点击查看详情: https://fanyi-api.baidu.com/product/11 .

  1. 点击立即使用.

  1. 按照提示填写信息, 申请. 最终会跳转到下图界面.

  1. 可以在开发者信息中, 获得你的 APP ID, 密钥.

接入方式

通用翻译 API 通过 HTTP 接口对外提供多语种互译服务。您只需要通过调用通用翻译 API，传入待翻译的内容，并指定要翻译的源语言（支持源语言语种自动检测）和目标语言种类，就可以得到相应的翻译结果。

通用翻译API HTTPS 地址：

1
https://fanyi-api.baidu.com/api/trans/vip/translate

签名生成方法

签名是为了保证调用安全，使用 MD5 算法生成的一段字符串，生成的签名长度为 32 位，签名中的英文字符均为小写格式。

生成方法：

  1. Step1. 将请求参数中的 APPID(appid)， 翻译 query(q，注意为UTF-8编码)，随机数(salt)，以及平台分配的密钥(可在管理控制台查看) 按照 appid+q+salt+密钥的顺序拼接得到字符串 1。

  2. Step2. 对字符串 1 做 MD5 ，得到 32 位小写的 sign。

注：

  1. 待翻译文本（q）需为 UTF-8 编码；

  2. 在生成签名拼接 appid+q+salt+密钥 字符串时，q 不需要做 URL encode，在生成签名之后，发送 HTTP 请求之前才需要对要发送的待翻译文本字段 q 做 URL encode；

  3. 如遇到报 54001 签名错误，请检查您的签名生成方法是否正确，在对 sign 进行拼接和加密时，q 不需要做 URL encode，很多开发者遇到签名报错均是由于拼接 sign 前就做了 URL encode；

  4. 在生成签名后，发送 HTTP 请求时，如果将 query 拼接在URL上，需要对 query 做 URL encode。

输入参数

请求方式： 可使用 GET 或 POST 方式，如使用 POST 方式，Content-Type 请指定为：application/x-www-form-urlencoded

字符编码：统一采用 UTF-8 编码格式

query 长度：为保证翻译质量，请将单次请求长度控制在 6000 bytes 以内（汉字约为输入参数 2000 个）

字段名 类型 是否必填 描述 备注
q string 是 请求翻译query UTF-8编码
from string 是 翻译源语言 可设置为auto
to string 是 翻译目标语言 不可设置为auto
appid string 是 APPID 可在管理控制台查看
salt string 是 随机数 可为字母或数字的字符串
sign string 是 签名 appid+q+salt+密钥的MD5值

输出参数

返回的结果是 json 格式，包含以下字段：

字段名 类型 描述 备注
from string 源语言 返回用户指定的语言，或者自动检测出的语种（源语言设为auto时）
to string 目标语言 返回用户指定的目标语言
trans_result array 翻译结果 返回翻译结果，包括src和dst字段
trans_result.*.src string 原文 接入举例中的“apple”
trans_result.*dst string 译文 接入举例中的“苹果”
error_code integer 错误码 仅当出现错误时显示

接入举例

例如：将英文单词 apple 翻译成中文：

请求参数：

1
2
3
4
5
6
q=apple
from=en
to=zh
appid=2015063000000001（请替换为您的appid）
salt=1435660288（随机码）
平台分配的密钥: 12345678

生成签名sign：

Step1. 拼接字符串1：

拼接appid=2015063000000001+q=apple+salt=1435660288+密钥=12345678得到字符串1：“2015063000000001apple143566028812345678”

Step2. 计算签名：（对字符串1做MD5加密）

sign=MD5(2015063000000001apple143566028812345678)，得到sign=f89f9594663708c1605f3d736d01d2d4

拼接完整请求：

1
http://api.fanyi.baidu.com/api/trans/vip/translate?q=apple&from=en&to=zh&appid=2015063000000001&salt=1435660288&sign=f89f9594663708c1605f3d736d01d2d4

注：也可使用 POST 方式，如 POST 方式传送，Content-Type 请指定为：application/x-www-form-urlencoded

输出举例

正确情况：

1
2
3
4
5
6
7
8
9
10
{
    "from": "en",
    "to": "zh",
    "trans_result": [
        {
            "src": "apple",
            "dst": "苹果"
        }
    ]
}

异常情况：

1
2
3
4
{
    "error_code": "54001",
    "error_msg": "Invalid Sign"
}

语种列表

通用翻译API支持语种数已达 201 种，完整列表如下。其中，对于常见语种列表内的语种，所有用户均可调用。对于非常见语种，仅企业已认证的尊享版用户可调用，未认证的非尊享版用户调用将返回错误。

源语言语种不确定时可设置为 auto，目标语言语种不可设置为 auto。但对于非常用语种，语种自动检测可能存在误差。

常见语种列表

名称 代码 名称 代码 名称 代码
自动检测 auto 中文 zh 英语 en
粤语 yue 文言文 wyw 日语 jp
韩语 kor 法语 fra 西班牙语 spa
泰语 th 阿拉伯语 ara 俄语 ru
葡萄牙语 pt 德语 de 意大利语 it
希腊语 el 荷兰语 nl 波兰语 pl
保加利亚语 bul 爱沙尼亚语 est 丹麦语 dan
芬兰语 fin 捷克语 cs 罗马尼亚语 rom
斯洛文尼亚语 slo 瑞典语 swe 匈牙利语 hu
繁体中文 cht 越南语 vie

错误码列表

当翻译结果无法正常返回时，请参考下表处理：

错误码 含义 解决方案
52000 成功
52001 请求超时 请重试
52002 系统错误 请重试
52003 未授权用户 请检查appid是否正确或者服务是否开通
54000 必填参数为空 请检查是否少传参数
54001 签名错误 请检查您的签名生成方法
54003 访问频率受限 请降低您的调用频率，或进行身份认证后切换为高级版/尊享版
54004 账户余额不足 请前往管理控制台为账户充值
54005 长query请求频繁 请降低长query的发送频率，3s后再试
58000 客户端IP非法 检查个人资料里填写的IP地址是否正确，可前往开发者信息-基本信息修改
58001 译文语言方向不支持 检查译文语言是否在语言列表里
58002 服务当前已关闭 请前往管理控制台开启服务
90107 认证未通过或未生效 请前往我的认证查看认证进度

各语言 DEMO

原教程链接: https://fanyi-api.baidu.com/doc/21 , 包含 PHP, JS, Python, C, Java, C# 的 DEMO.

Python DEMO

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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# -*- coding: utf-8 -*-

# This code shows an example of text translation from English to Simplified-Chinese.
# This code runs on Python 2.7.x and Python 3.x.
# You may install `requests` to run this code: pip install requests
# Please refer to `https://api.fanyi.baidu.com/doc/21` for complete api document

import requests
import random
import json
from hashlib import md5

# Set your own appid/appkey.
appid = 'INPUT_YOUR_APPID'
appkey = 'INPUT_YOUR_APPKEY'

# For list of language codes, please refer to `https://api.fanyi.baidu.com/doc/21`
from_lang = 'en'
to_lang =  'zh'

endpoint = 'http://api.fanyi.baidu.com'
path = '/api/trans/vip/translate'
url = endpoint + path

query = 'Hello World! This is 1st paragraph.\nThis is 2nd paragraph.'

# Generate salt and sign
def make_md5(s, encoding='utf-8'):
    return md5(s.encode(encoding)).hexdigest()

salt = random.randint(32768, 65536)
sign = make_md5(appid + query + str(salt) + appkey)

# Build request
headers = {'Content-Type': 'application/x-www-form-urlencoded'}
payload = {'appid': appid, 'q': query, 'from': from_lang, 'to': to_lang, 'salt': salt, 'sign': sign}

# Send request
r = requests.post(url, params=payload, headers=headers)
result = r.json()

# Show response
print(json.dumps(result, indent=4, ensure_ascii=False))

结语

第四十四篇博文写完，开心！！！！

今天，也是充满希望的一天。