帮助与支持

使用须知

一、 服务概述

1. 什么是百度翻译开放平台?

百度翻译开放平台是百度翻译面向广大开发者提供开放服务的平台。服务涵盖:通用翻译API、定制化翻译API、语音翻译SDK、拍照翻译SDK等,并持续更新中。

通用翻译API

通用翻译API支持28种语言互译,覆盖中、英、日、韩、西、法、泰、阿、俄、葡、德、意、荷、芬、丹等;支持28种语言的语种检测。您只需调用通用翻译API,传入待翻译的内容,并指定要翻译的源语言(支持源语言语种自动检测)和目标语言,即可得到相应的翻译结果。任何第三方应用或网站都可以通过使用通用翻译API为用户提供实时优质的多语言翻译服务,提升产品体验。

垂直领域API

垂直领域API针对特定领域的翻译展开优化,翻译结果相较于通用翻译API结果更为准确,句式更加符合该行业特点。现已开通科技电子、水利机械、生物医药等3个垂直领域,且领域在不断扩展中。

定制化翻译API

定制化翻译API是基于开发者提供的领域语料数据,在通用翻译模型基础上快速构建的定制化训练模型。定制化翻译API目前支持中英、英中方向,后续将逐步支持其他语言方向。定制化翻译API可更好地与您的应用场景相匹配,帮助您获得更好的翻译效果。

语种识别API

语种识别API可识别给出文本的语种,并返回识别结果。首批支持中文、英语、日语、韩语、泰语、越南语、俄语等七个语种的语种识别。

语音翻译SDK

语音翻译SDK结合语音识别、文本翻译、语音合成等技术,提供在线语音翻译服务的整体解决方案。语音翻译SDK目前支持中、英、日、粤四种语言的源语言识别,12种目标语言的语音输出以及28种目标语言的文本翻译结果输出,暂不支持混合语种的识别。语音翻译SDK可广泛应用于APP及各种硬件设备。

拍照翻译SDK

拍照翻译SDK将图像识别与文本翻译合二为一,轻松实现图文翻译,省去繁琐的二次接入。拍照翻译目前支持中、英、日、韩、法、德、葡、意、西、俄等10种源语言的识别,28种目标语言的输出。

在线翻译SDK

在线翻译SDK作为文本翻译的另一种解决方案,同样支持28个语种互译,支持按照license收费模式,一经购买可永久使用。广泛应用于各种智能硬件设备。如有合作意向,可联系translate_api@baidu.com了解详细信息。

离线翻译SDK

离线翻译SDK目前支持中英、中日、中韩三种语言方向的离线翻译,支持按照license收费的模式,一经购买可永久使用。广泛应用于各种智能硬件设备。如有合作意向,可联系translate_api@baidu.com了解详细信息。

2. 平台是否提供词典、TTS发音或汉语API?

目前平台暂不提供上述服务,且汉语API非百度翻译团队开发,故不在本平台开放。

3. 平台是否提供网页翻译API?

平台暂未提供网页翻译API,但您可以通过对通用翻译API的二次开发,可以在百度翻译官方网站下载翻译插件,体验截图翻译、网页翻译等功能。详见fanyi.baidu.com

二、 服务申请

1. 如何申请通用翻译API服务?

通用翻译API采用全流程自助申请的模式。点击网站上方的“登录”按钮,以百度账号登录平台;在产品服务页面点击“立即使用”,按照页面提示信息注册成为开发者,即可获得APPID和密钥信息。同一百度账号或手机号码仅能申请一组APPID和密钥信息,该APPID和密钥信息可用于多项服务调用

已注册开发者的用户,可在产品服务页面点击“立即使用”或者在管理控制台开通通用翻译API服务;

如需开通更多服务,可在管理控制台-总览页面开通其他服务。

2. 我没有IP地址,或IP地址太多无法填写该怎么办?

IP地址非必填项,可留空。填写IP地址后,API将只能通过此IP地址调用。为了更好的保护您的账户隐私和安全,百度翻译建议各位开发者填写。

3. 是否支持国外服务器请求或使用国外手机注册?

支持。

4. 申请定制化翻译API时,语料样例填写有什么要求?

每行一个中英文对照的句对,中英文间请用三条竖线分割,例如:

这是一个测试。 ||| This is a test.

百度翻译可提供基本的格式转换服务。

5. 申请定制化翻译API时,语料数量怎么选择?

语料数量是申请必填项。为了更好地提供服务,百度翻译建议开发者根据实际情况进行选择。一般情况,语料量级达到百万级以上,定制化效果会较为显著。

6. 定制化翻译API的申请周期大概多长时间?

定制化翻译API申请流程包括线上提交申请、审核开发者资质、线下提交全量语料数据、模型优化、模型上线等环节。其中审核语料预计约3个工作日,模型优化预计约10个工作日,搭建服务预计约2个工作日,实际周期视语料量级及语料质量等因素而定。开发者可以通过管理控制台实时了解申请进度。

7. 我手头没有语料,但我想体验定制化翻译的效果,应该怎么办?

如您手头没有语料,或者希望直接体验定制化翻译的效果。请使用我们为您准备的分领域文本翻译API,这些领域的翻译引擎经过海量优质语料数据训练,相较于通用翻译API翻译效果提升明显。

8. 如何申请语音翻译SDK?

语音翻译SDK采用申请-审核-开通的模式。申请流程包括提交线上申请、审核开发者资质、等待专员联系、发送测试包、开通服务等环节。请详细填写线上申请资料以供我方审核。申请提交后,请耐心等待我方专员与您取得联系。

9. 语音翻译SDK是否支持同声传译

抱歉,暂不支持。语音翻译SDK单次可支持最长约60s的语音输入。

三、 隐私保护

1. 申请定制化翻译API,能否保证开发者语料数据的隐私性和安全性?

百度尊重您提供的语料数据,不会向第三方泄露语料数据。

2. 我的APPID和密钥可能遭到泄露,应该怎么办?

如您发现调用量有明显超过预期的增长,则可能是APPID和密钥遭到泄露,请立即进入管理控制台,自助停用相关服务。服务停用后,调用将返回58002错误,同时将停止计费。

如需注销APPID,请确保账户余额为0,未处于欠费状态。请发送您的百度用户名、APPID、注销原因等信息至translate_api@baidu.com,由我方专员为您核实注销。

四、 服务计费

1. 通用翻译API计费规则是什么?

通用翻译API标准版免费使用,不限字符量,高级版、尊享版每月提供200万字符免费额度,超出后仅收取超出部分费用。具体如下:

当月翻译字符数≤200万,当月享免费服务。

超过200万字符,需按照49元人民币/百万字符支付当月超出字符数部分费用。

注:使用字符数信息每5分钟更新一次,但计费系统有一定延迟,次日结算前一日字符数并扣除相应费用。故请随时关注字符使用量信息,以免超出免费额度,造成账户欠费。

为什么次日更新计费? 为了保护开发者的权益,若账户余额为0或免费额度用完就立即停止服务,则可能造成相关应用不可用,给开发者和企业造成损失,因此预留了一定的缓冲时间。

2. 百度翻译通用API字符数统计规则是什么?

字符数以翻译的源语言字符长度为标准计算。空格、html标签等均计入字符。一个汉字,英文字母,标点符号等,均按照一个字符计费。

3. 定制化翻译API计费规则是什么?

定制化翻译API目前处于公测期,开发者提交的语料样例评估通过后,百度翻译专员会主动与开发者联系并进行合作方式沟通,或开发者主动发送邮件至translate_api@baidu.com 了解详细合作信息。

4. 语音翻译SDK计费规则是什么?

提供了按照设备数量计费的策略,您可根据产品出货量购买license数量,购买后每个license对应一台设备,永久有效,无使用时间限制。详情请联系translate_api@baidu.com。

5. 如何对账户进行充值?

登录百度账户后,点击“管理控制台”-“充值”,即可通过百度钱包或支付宝为账户充值,充值金额可开具普通电子发票。

如需开具增值税专用发票,可与百度翻译签订合同,进行对公账户打款。在提供打款凭证后,我们将在后台为您充值。可发送邮件至translate_api@baidu.com咨询。

五、 服务调用

1. 通用翻译API是否有配额限制?

百度翻译通用API无访问频次限制,服务稳定性SLA高达99.99%。

2. 定制化翻译API是否有配额限制?

百度翻译定制化API目前处于免费公测期,支持默认配额为5qps,不保障并发。当调用频次超过默认配额时,会返回错误代码为54003的错误信息,您需降低调用频率后重新发起请求。

六、 发票相关

1. 如何开具发票?

以在线方式充值,百度提供普通电子发票。

2018年11月12日,平台上线发票自助申请功能。凡2018年11月12日之后在线充值的订单,可进入管理控制台-财务总览页面自助申请开具。电子发票效力等同于纸质发票。

2. 是否可开具增值税专用发票?

开具增值税专用发票,需与百度签订《百度翻译API企业合作合同》,进行对公付款,提供打款凭证及一般纳税人资质相关材料《一般纳税人六要素信息表》。可联系translate_api@baidu.com获取合同。

合同签订后,可在线提交增值税专用发票申请,我方在收到您的开票信息后将为您操作开票并邮寄。

3. 发票申请提交后多久能收到发票?

我们将在1-2个工作日内处理您的发票申请,记录后我们会尽快帮您申请发票,发票申请提交后7个工作日内开出,并免费邮寄至您提供的联系地址。注:每月初1-10日不能开具发票

服务协议

使用百度翻译开放平台服务(以下简称“服务”)即表示您同意接受百度翻译开放平台服务协议(以下简称“本协议”)和相关法律法规的约束。

一、定义

百度翻译数据指通过百度翻译的开放服务获得的任何数据,包括不限于翻译结果数据、语音识别数据等。

二、API或SDK访问

1. 您可以通过使用百度翻译提供的API或SDK来开发服务或应用,以实现百度翻译服务。

2. 使用百度翻译API或SDK时,如果应用服务包括一个客户端程序,此客户端程序不能缓存百度翻译数据。

3. 使用百度翻译开放服务时,以下损害百度公司利益的行为是不被允许的

3.1 向任何第三方销售、分发、再授权、重新分配、提供或传送任何百度翻译数据。

3.2 使用包含“百度”、“百度词典”或“百度翻译”等字样来命名自己的产品。

4. 百度可能会监控您对百度翻译API或者SDK的使用,以改善服务,并确保您遵守本条款。百度公司保留随时要求删除特定或者全部百度翻译数据的权利。

5. 如果有超出以上访问规则的其他需要,请您联系我们,如双方协商一致,百度可出具相应书面许可。

三、使用限制

1. 您通过API或者SDK来使用百度翻译服务时,需保持百度翻译数据的完整性。

2. 任何技术滥用或用户滥用(如制造垃圾广告信息等)或违反国家法律规定或可能损害百度利益的行为,都会导致您的账户被百度直接地永久地封禁。

四、服务费用

1. 百度翻译开放平台服务的收费方式及价格信息以网页公布的计费方式和支付方式为准。

2. 您登录百度翻译开放平台后,可通过管理控制台查看账户信息、接入服务项目、充值及查看账单等操作。

3. 若账户余额不足,您应及时充值,否则百度公司有权暂停为您提供付费服务。

4. 百度公司有权根据需要对收费服务的收费标准、计费及支付方式进行修改及变更,亦有权对免费服务进行收费。涉及服务费用的调整,百度将提前90天通知您(百度有权选择以线下或者线上的形式进行通知)。如您不同意相关调整,应立即停止使用百度翻译开放平台服务,如您在百度调整收费标准7日内,仍继续使用服务,视为您已接受新的收费标准,并将按此标准向百度公司支付费用。

五、隐私保护

1. 百度尊重您的个人隐私,不会公开或者透露您的注册信息及保存在百度开放平台中的非公开内容,除非遇到如下情况:

1.1 事先获取您的明确授权;

1.2 根据法律、法规、法律程序的要求或政府主管部门的强制性要求;

1.3 以学术研究或公共利益为目的;

1.4 保护维持百度的知识产权和其他重要权利;

1.5 符合相关服务条款或使用协议的规定;

2. 百度尊重您提供的语料数据,不会向第三方提供语料数据。

3. 您和百度翻译开放平台因使用百度翻译开放平台服务而了解或者接触到的信息,服务条款内容及使用服务过程中产生的相关信息及往来文件均为保密文件;非经书面同意不得向第三方泄露,给予或者转让该保密信息,该保密义务不因本协议的终止而终止。

4. 您使用百度服务向第三方提供任何收费或者免费的服务时,应充分尊重第三方的隐私,不得利用百度翻译开放平台服务进行任何侵害第三方隐私的行为。

六、责任限制

1. 在适用法律允许的最大范围内,百度公司明确表示不对通过百度翻译开放平台提供翻译数据提供任何类型的保证,不论是明示的或默示的,包括但不限于适销性、适用性、可靠性、准确性、完整性、不侵权、无病毒以及无错误的任何默示保证和责任。

2. 您对百度翻译API或SDK的使用是根据您自己的判断作出的,并自己承担所带来的风险,对于因使用百度翻译API或者SDK服务而产生的一切损失将由个人承担。

七、知识产权

1. 您承认百度公司拥有对百度翻译API或者SDK服务的所有权利,包括但不限于所有知识产权。“知识产权”指在专利法、版权法、商业机密法、商标法、反不正当竞争法等法中规定的所有权利以及其中的所有应用、更新、扩展和恢复,无论在现在还是以后在全球范围内实施和生效。

2. 您不能储存、更改、反编译、反向工程或者反汇编百度翻译API或者SDK。

八、服务终止

1. 百度有权在任意时间以任何理由终止API或SDK服务。当您出现对本协议的任何违反,或者百度向您发出了终止服务的通知,您将无权使用百度翻译API或者SDK服务。

2. 百度公司可随时对本协议作出变更并通过适当方式向您提示变更内容。您理解并同意,如果您在本协议作出变更后继续使用服务,则视为接受该变更。

上述条款将受中华人民共和国法律的约束并依据其解释。如出现纠纷,您和百度公司一致同意将纠纷交由北京市海淀区人民法院管辖。

如您对本协议内容有任何疑问,可发邮件至百度公司客服邮箱:

translate_api@baidu.com

在法律允许的范围内,本协议的最终解释权归百度公司所有。

垂直领域翻译API技术文档

接口地址
参数说明
字段名 类型 必填参数 描述 备注
q TEXT Y 请求翻译query UTF-8编码
appid INT Y APP ID 可在管理控制台查看
salt INT Y 随机数
domain TEXT Y 翻译领域类型 具体查看描述
sign TEXT Y 签名 appid+q+salt+domain+密钥 的MD5值

domain领域支持范围:

支持传入值 描述 支持语言方向
electronics 电子科技领域 中文-->英语
mechanics 水利机械领域 中文-->英语
medicine 生物医药领域 中文-->英语
英语-->中文

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


为保证检测质量,请将单次请求长度控制在 2000 bytes以内。


签名生成方法如下:

1、将请求参数中的 APPID(appid), 检测query(q, 注意为UTF-8编码), 随机数(salt), 支持翻译领域(domain),以及平台分配的密钥(可在管理控制台查看)

按照 appid+q+salt+domain+密钥 的顺序拼接得到字符串1。

2、对字符串1做md5,得到32位小写的sign。


注意:

1、请先将需要翻译的文本转换为UTF-8编码

2、在发送HTTP请求之前需要对各字段做URL encode

3、在生成签名拼接 appid+q+salt+domain+密钥 字符串时,q不需要做URL encode,在生成签名之后,发送HTTP请求之前才需要对要发送的待检测文本字段q做URL encode。

4、支持post、get方式传输,post传输时Content-Type指定application/x-www-form-urlencoded。

5、科技电子、水利机械两个领域仅支持中到英,如设置语言方向为英到中,则默认输出通用翻译结果;生物医药领域可支持中到英和英到中两种语言方向。

返回结果

返回结果是json格式,包含以下字段:

字段名 类型 描述
from TEXT 翻译源语言
to TEXT 译文语言
trans_result MIXED LIST 翻译结果
src TEXT 原文
dst TEXT 译文
语种列表

源语言语种不确定时可设置为 auto,目标语言语种不可设置为 auto。

语言简写 名称
auto 自动检测
zh 中文
en 英语
错误码列表

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

错误码 含义 解决方法
52001 请求超时 重试
52002 系统错误 重试
52003 未授权用户 检查您的 appid 是否正确,或者服务是否开通
54000 必填参数为空 检查是否少传参数
54001 签名错误 请检查您的签名生成方法
54003 访问频率受限 请降低您的调用频率
54004 账户余额不足 请前往管理控制台为账户充值
54005 长query请求频繁 请降低长query的发送频率,3s后再试
58000 客户端IP非法 检查个人资料里填写的 IP地址 是否正确
可前往管理控制平台修改
IP限制,IP可留空
58001 译文语言方向不支持 检查译文语言是否在语言列表里
58002 服务当前已关闭 请前往管理控制台开启服务

定制化翻译API技术文档

接入方式

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


定制化翻译API HTTP地址:

http://api.fanyi.baidu.com/api/trans/private/translate

定制化翻译API HTTPS地址:

https://fanyi-api.baidu.com/api/trans/private/translate


您需要向该地址通过POST或GET方法发送下列字段来访问服务

字段名 类型 必填参数 描述 备注
q TEXT Y 请求翻译query UTF-8编码
from TEXT Y 翻译源语言 语言列表
to TEXT Y 译文语言 语言列表
appid INT Y APP ID 可在管理控制台查看
salt INT Y 随机数
sign TEXT Y 签名 appid+q+salt+密钥 的MD5值

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


为保证翻译质量,请控制请求频次,并将单次请求长度控制在 6000 bytes以内。(汉字约为2000个)


签名生成方法如下:

1、将请求参数中的 APPID(appid), 翻译query(q, 注意为UTF-8编码), 随机数(salt), 以及平台分配的密钥(可在管理控制台查看)

按照 appid+q+salt+密钥 的顺序拼接得到字符串1。

2、对字符串1做md5,得到32位小写的sign。


注意:

1、请先将需要翻译的文本转换为UTF-8编码

2、在发送HTTP请求之前需要对各字段做URL encode

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

返回结果是json格式,包含以下字段:

字段名 类型 描述
from TEXT 翻译源语言
to TEXT 译文语言
trans_result MIXED LIST 翻译结果
src TEXT 原文
dst TEXT 译文

其中 trans_result 包含了 src 和 dst 字段。


例:将apple从英文翻译成中文:

请求参数:

q=apple

from=en

to=zh

appid=2015063000000001

salt=1435660288

平台分配的密钥: 12345678

生成sign:

>拼接字符串1

拼接appid=2015063000000001+q=apple+salt=1435660288+密钥=12345678

得到字符串1 =2015063000000001apple143566028812345678

>计算签名sign(对字符串1做md5加密,注意计算md5之前,串1必须为UTF-8编码)

sign=md5(2015063000000001apple143566028812345678)

sign=f89f9594663708c1605f3d736d01d2d4

完整请求为:

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

也可以使用POST方法传送需要的参数。

语言列表

定制化翻译API语言方向目前只支持中文和英文。

语言简写 名称
zh 中文
en 英语
错误码列表

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

错误码 含义 解决方法
52000 成功
52001 请求超时 重试
52002 系统错误 重试
52003 未授权用户 检查您的 appid 是否正确,或者服务是否开通
54000 必填参数为空 检查是否少传参数
54001 签名错误 请检查您的签名生成方法
54003 访问频率受限 请降低您的调用频率
54004 账户余额不足 请前往管理控制平台为账户充值
54005 长query请求频繁 请降低长query的发送频率,3s后再试
58000 客户端IP非法 检查个人资料里填写的 IP地址 是否正确
可前往管理控制平台修改
IP限制,IP可留空
58001 译文语言方向不支持 检查译文语言是否在语言列表里
各语言DEMO

PHP 版(点击下载

JS 版(点击下载

Python 版(点击下载

C 版(点击下载

Java 版(点击下载

常见问题

1. 如何在一次请求中翻译多个单词或者多段文本?

您可以在发送的字段q中用换行符(在多数编程语言中为转义符号 \n )来分隔要翻译的多个单词或者多段文本,这样您就能得到多个单词或多段文本独立的翻译结果了。注意在发送请求之前对q字段做URL encode!


2. 什么是URL encode?

网络标准RFC 1738规定了URL中只能使用英文字母、阿拉伯数字和某些标点符号,不能使用其他文字和符号。如果您需要翻译的文本里面出现了不在该规定范围内的字符(比如中文),需要通过URL encode将需要翻译的文本做URL编码才能发送HTTP请求。大部分编程语言都有现成的URL encode函数,具体使用方法可以针对您使用的编程语言自行搜索。


3. 为什么我的请求总是返回错误码54001?

54001表示签名错误,请检查您的签名生成方法是否正确。
应该对 appid+q+salt+密钥 拼接成的字符串做MD5得到32位小写的sign。确保要翻译的文本q为UTF-8编码。
注意在生成签名拼接 appid+q+salt+密钥 字符串时,q不需要做URL encode,在生成签名之后,发送HTTP请求之前才需要对要发送的待翻译文本字段q做URL encode。
如果您无法确认自己生成签名的结果是否正确,可以将您生成的签名结果和在https://md5jiami.51240.com/中生成的常规md5加密-32位小写签名结果对比。

语种检测API技术文档

接口地址
参数说明
字段名 类型 必填参数 描述 备注
q TEXT Y 请求翻译query UTF-8编码
appid INT Y APP ID 可在管理控制台查看
salt INT Y 随机数
sign TEXT Y 签名 appid+q+salt+密钥 的MD5值

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


为保证检测质量,请将单次请求长度控制在 2000 bytes以内。


签名生成方法如下:

1、将请求参数中的 APPID(appid), 翻译query(q, 注意为UTF-8编码), 随机数(salt), 以及平台分配的密钥(可在管理控制台查看)

按照 appid+q+salt+密钥 的顺序拼接得到字符串1。

2、对字符串1做md5,得到32位小写的sign。


注意:

1、请先将需要翻译的文本转换为UTF-8编码

2、在发送HTTP请求之前需要对各字段做URL encode

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

4、支持post、get方式传输,post传输时Content-Type指定application/x-www-form-urlencoded。

返回结果

返回结果是json格式,包含以下字段:

字段名 类型 描述
error_code STRING 返回错误码
error_msg STRING 返回错误信息
data OBJECT 返回数据集
data.src STRING 检测语种结果
支持检测语种列表
语言简写 名称
zh 中文
en 英语
jp 日语
kor 韩语
th 泰语
vie 越南语
vie 越南语
ru 俄语
错误码列表

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

错误码 含义 解决方法
0 成功
52001 请求超时 重试
52002 系统错误 重试
52003 未授权用户 检查您的 appid 是否正确,或者服务是否开通
54000 必填参数为空 检查是否少传参数
54001 签名错误 请检查您的签名生成方法
54003 访问频率受限 请降低您的调用频率
54004 账户余额不足 请前往管理控制台为账户充值
54009 语种检测失败 不在支持检测语种范围内
58000 客户端IP非法 检查个人资料里填写的 IP地址 是否正确
可前往管理控制平台修改
IP限制,IP可留空
58002 服务当前已关闭 请前往管理控制台开启服务

语音翻译Android端SDK技术文档

接入方式

一、 简介

本文档是百度翻译开放平台语音翻译SDK(Andriod版)的用户指南,描述了语音翻译、语音播报等相关接口的说明。


二、 兼容性

类别 兼容范围
系统 支持Android 4.0.3(API 15)及以上版本
机型 手机和平板均可
硬件要求 设备要有麦克风
CPU 兼容armeabi、armeabi-v7a、arm64-v8a、x86及x86_64 架构的CPU

三、 集成指南

1. 复制语音翻译SDK库文件

复制 trans-asr-sdk_version.aar 到项目的libs目录下,然后在项目的build.gradle文件中,增加如下配置:

2. 配置权限

在项目的AndroidManifest.xml中增加如下权限(如果应用的targetSdkVersion>=23,请确保在调用SDK之前,应用已经获得以下权限,SDK不会主动动态申请权限)

四、 接口使用及调用流程

1. 初始化 TransAsrClient 类

2. 注册语音翻译回调

3. 开始语音翻译

4. 停止语音翻译,并且获得翻译结果

5. 取消语音识别

五、 其他常用接口

1. 其他配置接口

TransAsrConfig类定义了调用语音翻译SDK时的各种配置项,详情如下

2. 语种接口

Language类定义了目前百度翻译支持的语种列表以及是否支持语音识别、是否支持TTS播报相关接口

错误码列表
错误码 含义 解决方法
1000 DNS连接超时 出现原因可能为网络已经连接但质量比较差,建议检测网络状态
1001 网络连接超时
1002 网络读取超时
1003 上行网络连接超时
1004 上行网络读取超时
1005 下行网络连接超时
1006 下行网络读取超时
2000 网络连接失败 出现原因可能是网络权限被禁用,或网络确实未连接,需要开启网络或检测无法联网的原因
2001 网络读取失败
2002 上行网络连接失败
2003 上行网络读取失败
2004 下行网络连接失败
2005 下行网络读取失败
2006 下行数据异常
2100 本地网络不可用
3001 录音机打开失败 出现原因可能为:未声明录音权限,或 被安全软件限制,或 录音设备被占用,需要开发者检测权限声明。
3002 录音机参数错误
3003 录音机不可用
3006 录音机读取失败
3007 录音机关闭失败
3008 文件打开失败
3009 文件读取失败
3010 文件关闭失败
3100 VAD异常,通常是VAD资源设置不正确
3101 长时间未检测到人说话,请重新识别
3102 检测到人说话,但语音过短
6001 未开启长语音时,当输入语音超过60s时,会报此错误 语音过长,请配合语音识别的使用场景,如避开嘈杂的环境等。
7001 没有匹配的识别结果。当检测到语音结束,或手动结束时,服务端收到的音频数据质量有问题,导致没有识别结果 信噪比差,请配合语音识别的使用场景,如避开嘈杂的环境等
9001 没有录音权限 通常是没有配置录音权限:android.permission.RECORD_AUDIO 检查录音权限
52001 请求超时 重试
52002 系统错误 重试
52003 未授权用户 检查您的 appid 是否正确,或者服务是否开通
52010 已激活设备数量超过最大限制 请联系管理员
54000 必填参数为空 检查是否少传参数
54001 签名错误 请检查您的签名生成方法
54003 访问频率受限 请降低您的调用频率
54004 账户余额不足 请前往管理控制平台为账户充值
54005 长query请求频繁 请降低长query的发送频率,3s后再试
58000 客户端IP非法 检查个人资料里填写的 IP地址 是否正确
可前往管理控制平台修改
IP限制,IP可留空
58001 译文语言方向不支持 检查译文语言是否在语言列表里
常见问题

1. 项目中使用了proguard,混淆后app无法正常运行

请在项目的proguard-rules.pro文件中增加如下配置:

2. 语音翻译SDK集成了5种CPU架构的so库,导致安装包过大,如何配置才能减小项目文件大小?

请在项目的build.gradle文件中增加如下配置

3. 集成语音SDK后,运行报错,提示 java.lang.UnsatisfiedLinkError

项目中的其他SDK,支持的CPU架构种类跟语音翻译不一致,可以只集成所有SDK共有的CPU架构类型,也可以按需选择需要的CPU架构类型,配置方式如下:


4. 是否可以控制翻译结果的播放次数?

可以。语音翻译SDK支持回调播放功能。

更详细的说明请见文档:javadoc.zip


5. 是否支持语音转文本(不翻译)?

不可以。SDK集成了语音识别、翻译和语音播报,单次query最长不超过60s。如仅需语音转文本的服务,请考虑接入语音识别API。

SDK更新记录
更新日期 版本号 版本名 更新内容
2018.06.01 1 1.0.0 首次发版
2018.08.10 2 1.0.1 语音识别新增日语
2018.12.27 3、4、5 1.0.2-1.0.4 修复若干已知问题
2019.01.29 6 1.0.5 增加语音翻译结果回调

语音翻译IOS端SDK技术文档

接入方式

一、 简介

本文档是百度翻译开放平台语音翻译SDK(IOS端)的用户指南,描述了语音翻译、语音播报等相关接口的说明。


二、 兼容性

类别 兼容范围
系统 Ios8.0及以上版本
机型 手机和平板均可
硬件要求 设备要有麦克风
CPU 兼容armv7、arm64、i386、x86_64架构的CPU

三、 集成指南

1. 复制语音翻译SDK库文件

复制 BDTVoiceLib和third_party到项目的libs目录下。

将third_party开发包中的BDSpeechClientSDK_ASR_v3.0.8.0/BDSClientResource/ASR/BDSClientResources目录以“create folder references”方式添加到工程的资源Group中,注意使用"create groups"方式添加不能生效。

2. 配置权限

在项目的Info.plist中增加如下语音权限。Privacy - Microphone Usage Description

3. 添加如下Framework


四、 接口使用及调用流程

1. 添加头文件

2. 初始化语音翻译sdk

3. 开始语音翻译

4. 停止语音翻译,并且获得翻译结果

5. 取消语音识别

6. 停止TTS 发音

五、 其他配置接口

BDTVoiceTrans类定义了调用语音翻译SDK时的各种配置项,详情如下:

六、 语种支持

源语音识别支持中、英、日、粤四个语种,TTS发音支持中、英、日、韩、俄、粤、葡、德、法、西、泰、阿等12个语种,译文文字输出支持全部28个语种。详情如下:

错误码列表

一、翻译SDK错误码


错误码 含义
300 cuid 缺失
301 imei 缺失
302 mac 缺失
303 file 缺失
304 缺失数据
305 语种不支持语音识别
306 缺失appid...
307 缺失secretkey...
400 请求超时
401 请求失败
402 返回数据为空
403 数据格式错误

二、语音识别端错误


错误码 含义
3001 录音设备异常
3002 无录音权限
3003 录音不可用
3004 录音中断
3099 录音出错
3101 前端库异常
3102 用户未说话
3103 用户说话声音太短
3199 语音数据处理过程出错
3201 在线识别引擎异常
3202 网络不可用
3203 获取token失败
3204 解析url失败
3205 请求超时
3299 本地网络联接出错
3301 协议参数错误
3302 识别过程出错
3303 没有找到匹配结果
3304 PID错误
3305 声音不符合识别要求
3306 语音过长(单次query请勿超过60s)
3399 服务器错误
3499 HTTP协议错误
3599 离线引擎返回错误
3601 识别器忙
3602 垂类设置有误
3603 语音数据enqueue失败

三、翻译服务端相关错误


错误码 含义 解决方法
52001 请求超时 重试
52002 系统错误 重试
52003 未授权用户 检查您的appid是否正确,或者服务是否开通
52010 开放设备授权容量不足 联系管理员扩增容量
54000 必填参数为空或固定参数有误 检查参数是否误传
54001 签名错误 请检查您的签名生成方法
54003 访问频率受限 请降低您的调用频率
54004 账户余额不足 请前往管理控制平台为账户充值
54005 长query请求频繁 请降低长query的发送频率,3s后再试
58000 客户端IP非法 检查个人资料里填写的IP地址是否正确可前往管理控制平台修改,IP限制,IP可留空
58001 译文语言方向不支持 检查译文语言是否在语言列表里
69008 设备号为空 检查cuid参数
SDK更新记录
更新日期 版本号 版本名 更新内容
2019.05.07 1 1.0.0 首次发版

拍照翻译SDK技术文档

接入方式

一、 简介

本文档是百度翻译开放平台拍照翻译SDK的用户指南,描述了拍照翻译相关接口的说明。


二、 集成指南

1. 复制拍照翻译SDK

复制 trans-ocr-sdk_version.aar 到项目的libs目录下,然后在项目的build.gradle文件中,增加如下配置:

2. 配置权限

在项目的AndroidManifest.xml中增加如下权限(如果应用的targetSdkVersion>=23,请确保在调用SDK之前,应用已经获得以下权限,SDK不会主动动态申请权限)

三、 接口使用及调用流程

1. 创建OcrClient实例

2. 开始拍照翻译

我们提供了同步接口和异步接口,其中同步接口请求如下:

同步请求请在子线程中执行。

异步接口请求如下:

异步请求回调方法onOcrResult(OcrResult result)是在主线程中的。

四、 相关数据类解释

1. 语种类Language

语种简写 对应语种
Language.ZH 中文
Language.EN 英文
Language.JP 日语
Language.KOR 韩语
Language.PT 葡萄牙语
Language.FRA 法语
Language.DE 德语
Language.IT 意大利语
Language.SPA 西班牙语
Language.RU 俄语

2. 识别结果OcrResult类

属性 对应含义
error 错误码
errorMsg 错误码对应的错误信息
from 源语言方向
to 目标语言方向
contents 图中识别的每块结果
sumSrc 全部的识别原文
sumDst 全部的识别翻译结果

3. 识别结果OcrContent类

属性 对应含义
src 该块识别的原文结果
dst 该块识别对应的译文结果
rect 该块在图中对应的区域(依次顺序表示left, top, right, bottom)
lineCount 该块中识别的原文行数
错误码列表
错误码 含义
0 成功
52001 请求超时,请重试
52002 服务端系统错误,请重试
52003 未授权用户,请检查appid是否正确或者服务是否开通
52010 开放设备授权容量不足
54000 固定参数有误
54001 签名错误
54003 访问频率受限
54004 账户余额不足
54005 长query请求频繁
58000 客户端IP非法
58001 译文语言方向不支持
69001 上传图片数据有误
69002 图片识别超时
69003 内容识别失败
69004 识别内容为空
69005 图片大小超限(超过4M)
69006 图片尺寸不符合标准(最短边至少30px,最长边最大4096px)
69007 图片格式不支持(png/jpg)
69008 设备号为空
-1001 sdk内部错误
-1002 本地图片文件无效
-1003 识别的bitmap无效
-1004 图片大小超过最大支持50M
-1005 保存文件失败
-1006 网络请求超时失败
-1007 服务器返回为空
-1008 返回数据不合法,解析失败
-1009 发送请求时遇到异常(errorMsg中会有异常信息)
-1010 HTTP请求失败(errorMsg中会有statusCode)
SDK更新记录
更新日期 版本号 版本名 更新内容
2019.01.25 1 1.0.0 首次发版
2019.03.06 2 1.0.1 修复OcrContent中rect的right和bottom不正确问题