语音翻译
更新时间：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 |