语音翻译

更新时间：2022-11-15

接口描述

语音翻译API集成语音识别、文本翻译、语音合成三大技术能力，可以将60秒以内的语音识别成文字并翻译成目标语言，支持译文语音播报。

接口限制

翻译语种方向支持
- 中 -> 英
- 英 -> 中
- 中/英 -> 其他
- 其他 -> 中/英
需要上传完整的音频数据，不支持实时音频流，需使用base64编码，编码后的大小不能超过4MB。
音频参数要求
- 采样率：16kHz或8kHz
- 位深：16bits
- 单声道
支持的语言及音频格式：

语言	支持的音频格式
中文（普通话）、英语、粤语	pcm、wav
其他语种	pcm

在线调试

您可以在示例代码中心中调试该接口，可进行签名验证、查看在线调用的请求内容和返回结果、示例代码的自动生成。

请求说明

HTTP 方法：POST

请求 URL：https://aip.baidubce.com/rpc/2.0/mt/v2/speech-translation

URL 参数：

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

Header 如下：

参数	值	是否必须
Content-Type	application/json	是

请求参数

Body中放置请求参数，参数详情如下：

字段名	类型	是否必填	示例	描述
from	string	是	en	源语言，具体参考语言列表
to	string	是	zh	目标语言，具体考语言列表
voice	string	是	xxxx	音频文件二进制数据，需使用base64编码，编码后的大小不能超过4MB
format	string	是	pcm	音频格式：pcm、wav。并不是所有语言都支持全部的音频编码格式，支持情况请参考接口限制中的说明。

请求示例

{
    "from": "en",
    "to": "zh",
    "format":"pcm",
    "voice": "xxxx"
}

返回说明

返回参数

正常返回

参数	类型	是否必须	描述
log_id	uint64	是	唯一的log id，用于问题定位
result	object	是	结果消息体
result.source	string	是	语音识别得到的原文
result.target	string	是	翻译后的目标语言文本
result.target_tts	string	是	译文 TTS，使用base64编码（注：若翻译后的目标语言文本字节数超过400，则不返回target_tts内容）

正常返回示例

{
"result": {
        "source": "今天天气不错。",
        "target": "It's a nice day today.",
        "target_tts": "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"
},
"log_id": 1413395986911332328
}

异常返回

参数	类型	是否必须	描述
log_id	uint64	是	唯一的log id，用于问题定位
error_msg	string	是	错误消息体
error_code	uint64	是	错误码

异常返回示例

{
   "log_id": 1413409052597883633,
    "error_msg": "internal error",
    "error_code": 282000
}

错误码列表

接口流控及鉴权错误码

错误码	错误信息	描述	解决方法
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

通用及业务错误码

错误码	错误信息	解决方法
10001	必填参数为空或固定参数有误	检查参数是否误传
10004	访问频率受限	请降低您的调用频率
20000	语言方向不支持	检查源语种或目标语种是否在语言列表里
20200	语音翻译请求失败	请重试
20201	音频base64编码后数据大小超过4M限制	请上传符合大小要求的音频数据
20202	文件格式不支持	请上传符合格式要求的音频数据
216100	invalid param	用户请求中的参数不合法
216110	appid not exist	appid不存在
216202	input oversize	用户请求体过大
282003	missing required parameter(s)	请用户请求中缺少必填参数
282000	internal error	内部错误，请稍后重试或发工单反馈

语种列表

编号	名称	代码	编号	名称	代码	编号	名称	代码
1	中文	zh	21	罗马尼亚语	rom	41	塞尔维亚语	srp
2	英语	en	22	瑞典语	swe	42	斯瓦希里语(坦桑尼亚)	swa
3	粤语	yue	23	匈牙利语	hu	43	土耳其语	tr
4	日语	jp	24	越南语	vie	44	乌克兰语	ukr
5	韩语	kor	25	印度尼西亚语	id	45	亚美尼亚语	arm
6	法语	fra	26	加泰罗尼亚语	cat
7	西班牙语	spa	27	希伯来语	heb
8	泰语	th	28	印地语	hi
9	阿拉伯语(巴林)	ara	29	马来语	may
10	俄语	ru	30	挪威语	nor
11	葡萄牙语	pt	31	冰岛语	ice
12	德语	de	32	菲律宾语	fil
13	意大利语	it	33	高棉语	hkm
14	希腊语	el	34	克罗地亚语	hrv
15	荷兰语	nl	35	拉脱维亚语	lav
16	波兰语	pl	36	孟加拉语	ben
17	保加利亚语	bul	37	尼泊尔语	nep
18	丹麦语	dan	38	南非荷兰语	afr
19	芬兰语	fin	39	斯洛伐克语	sk
20	捷克语	cs	40	僧伽罗语	sin

图片翻译

实时语音翻译