语音翻译
更新时间:2024-12-11
接口描述
语音翻译API集成语音识别、文本翻译、语音合成三大技术能力,可以将60秒以内的语音识别成文字并翻译成目标语言,支持译文语音播报。
接口限制
-
翻译语种方向支持
- 中 -> 英
- 英 -> 中
- 中/英 -> 其他
- 其他 -> 中/英
- 需要上传完整的音频数据,不支持实时音频流,需使用base64编码,编码后的大小不能超过4MB。
-
音频参数要求
- 采样率:16kHz
- 位深: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编码,mp3格式(注:若翻译后的目标语言文本字节数超过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 |