通用翻译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。
注：

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

在生成签名拼接 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。

请求参数

Body 参数application/x-www-form-urlencoded

string

必需

（请求翻译query）UTF-8编码

from

string

必需

（翻译源语言）可设置为auto

string

必需

（翻译目标语言）不可设置为auto

appid

string

必需

（APPID）可在百度翻译开放平台查看

示例值:

salt

string

必需

（随机数）可为字母或数字的字符串

示例值:

sign

string

必需

（签名）appid+q+salt+密钥的MD5值

示例值:

tts

integer

可选

（是否显示语音合成资源）0-显示，1-不显示

dict

integer

可选

（是否显示词典资源）0-显示，1-不显示

action

integer

可选

（判断是否需要使用自定义术语干预API）1-是，0-否

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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={{appid}}' \
--data-urlencode 'salt={{SALT}}' \
--data-urlencode 'sign={{SIGN}}'

返回响应

🟢200成功

application/json

Body

from

string

源语言

必需

返回用户指定的语言，或者自动检测出的语种（源语言设为auto时）

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用户可见）

示例

{
    "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"
}

修改于 2024-07-18 18:55:47

常见问题

接入举例