百度翻译 API
  1. 通用翻译
百度翻译 API
  • 服务协议
  • 未命名文档
  • SDK隐私政策
  • 快速入门
    • 平台介绍
    • 注册账号
    • 接入服务
  • 开发者文档
    • 通用翻译
      • 接入举例
      • 语种列表
      • 词典、语音合成资源
      • 自定义术语库
      • 常见问题
      • 通用翻译API接入文档
        POST
    • 垂直领域
      • 接入举例
      • 语种列表
      • 错误码列表
      • 垂直领域API接入文档
    • 文档翻译
      • 翻译服务通知回调
      • 语种列表
      • 错误码列表
      • 统计校验服务
      • 翻译服务
    • 语音识别
      • 接入示例
      • 错误码列表
      • 语种识别API接入文档
    • 图片翻译
      • 语种列表
      • 错误码列表
      • SDK接入方式
      • 图片翻译API接入文档
    • 语音翻译
      • 语种列表
      • 错误码
      • SDK接入方式
      • 语音翻译 API 接入文档
  • 常见问题
    • 账号相关
    • 财务相关
  • 特色功能
    • 同步保存网盘
  1. 通用翻译

通用翻译API接入文档

POST
https://fanyi-api.baidu.com/api/trans/vip/translate
欢迎使用通用翻译API,本文档将指导您如何快速接入。
如何使用通用翻译API?
使用您的百度账号登录百度翻译开放平台 ;
注册成为开发者,获得 APPID ;
进行开发者认证(如仅需标准版可跳过);
开通通用翻译API服务:开通链接 ;
参考技术文档和 Demo 编写代码。
接入方式
通用翻译API通过 HTTP 接口对外提供多语种互译服务。您只需要通过调用通用翻译API,传入待翻译的内容,并指定要翻译的源语言(支持源语言语种自动检测)和目标语言种类,就可以得到相应的翻译结果。
签名生成方法
签名是为了保证调用安全,使用 MD5 算法生成的一段字符串,生成的签名长度为 32 位,签名中的英文字符均为小写格式。
生成方法:
Step1. 将请求参数中的 APPID(appid), 翻译 query(q,注意为UTF-8编码),随机数(salt),以及平台分配的密钥(可在管理控制台查看) 按照 appid+q+salt+密钥的顺序拼接得到字符串 1。
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。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://fanyi-api.baidu.com/api/trans/vip/translate' \
--data-urlencode 'q=' \
--data-urlencode 'from=' \
--data-urlencode 'to=' \
--data-urlencode 'appid=' \
--data-urlencode 'salt={{SALT}}' \
--data-urlencode 'sign={{SIGN}}'
响应示例响应示例
{
  "from": "string",
  "to": "string",
  "trans_result": "string",
  "trans_result.*.src": "string",
  "trans_result.*dst": "string",
  "error_code": "string",
  "src_tts": "string",
  "dst_tts": "string",
  "dict": "string"
}

请求参数

Body 参数application/x-www-form-urlencoded
q
string 
必需
(请求翻译query)UTF-8编码
from
string 
必需
(翻译源语言)可设置为auto
to
string 
必需
(翻译目标语言)不可设置为auto
appid
string 
必需
(APPID)可在百度翻译开放平台 查看
示例值:
{{appid}}
salt
string 
必需
(随机数)可为字母或数字的字符串
示例值:
{{SALT}}
sign
string 
必需
(签名)appid+q+salt+密钥的MD5值
示例值:
{{SIGN}}
tts
integer 
可选
(是否显示语音合成资源)0-显示,1-不显示
dict
integer 
可选
(是否显示词典资源)0-显示,1-不显示
action
integer 
可选
(判断是否需要使用自定义术语干预API)1-是,0-否

返回响应

🟢200成功
application/json
Body
from
string 
源语言
必需
返回用户指定的语言,或者自动检测出的语种(源语言设为auto时)
to
string 
目标语言
必需
返回用户指定的目标语言
trans_result
string 
翻译结果
必需
返回翻译结果,包括src和dst字段
trans_result.*.src
string 
原文
必需
接入举例中的“apple”
trans_result.*dst
string 
译文
必需
接入举例中的“苹果”
error_code
string 
错误码
必需
仅当出现错误时显示
src_tts
string 
原文tts链接
可选
mp3格式,暂时无法指定发音(此字段仅开通了词典、tts用户可见)
dst_tts
string 
译文tts链接
可选
mp3格式,暂时无法指定发音(以下字段仅开通了词典、tts用户可见)
dict
string 
中英词典资源
可选
返回中文或英文词典资源,包含音标;简明释义等内容(以下字段仅开通了词典、tts用户可见)
上一页
常见问题
下一页
接入举例
Built with