语音文件同步接口
1. 接口介绍
语音文件同步接口支持实时返回检测结果，适用于时长小于 60 秒的短音频。
QPS 限制
- 1 秒最多允许请求 50 次；
- 1 个请求最多携带 10 个文件；
如有特殊并发需求，请联系我们。
2. 请求
2.1 请求地址
- 国内:
http://api.speech.tuputech.com/v3/recognition/speech/<secretId> - 国外:
http://api-us.open.tuputech.com/v3/recognition/speech/<secretId>
提示
<secretId> 需替换为您的 secretId，请联系我们为您开通 secretId。
2.2 请求方法
POST
2.3 请求头
Content-Type: multipart/form-data
2.4 请求参数说明
| 参数名 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| speech | String 或 File | 是 | 支持传语音文件或者 URL,不过两者不能混在同一请求中；大小限制：1M 以内；允许识别的格式：amr, mp3, wmv, wav, flv, m4a |
| task | String | 否 | 指定本次调用要审核的任务，任务 ID 的形式，如：5caee6b2a76925c55a09a6d2 |
| language | String | 否 | 需要识别的语言代码。需要进行多语种语音转译审核或者多语种转译时必传。多语种语音转译类产品需联系图普进行配置使用。 对应语言代码详见：语音转译审核（多语种）语言代码列表 |
| timestamp | Number | 是 | 当前的服务器的 Unix 时间戳 |
| nonce | Number | 是 | 随机数 |
| signature | String | 是 |
|
2.5 请求示例
curl 请求示例
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'speech=@your_speech_file_path_or_url' \
-F 'timestamp=1553249299' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.speech.tuputech.com/v3/recognition/speech/your_secret_id'
指定任务的 curl 请求示例
curl -X POST --header 'Content-Type: multipart/form-data' \
-F 'speech=@your_speech_file_path_or_url' \
-F 'task=task_id' \
-F 'timestamp=1553249299' \
-F 'nonce=0.04708760756305974' \
-F 'signature=your_signature' \
'http://api.speech.tuputech.com/v3/recognition/speech/your_secret_id'
3. 返回
3.1 返回参数说明
| 参数名 | 类型 | 是否必有 | 说明 |
|---|---|---|---|
| signature | String | 是 | 响应经过 JSON 字符串转义后的签名。我们采用的数字证书签名算法是：RSA-SHA256，签名输出类型是：base64，首先下载图普科技的公钥证书，然后按如下步骤认证： 1. 接口返回的响应含两个字段：signature 和 json，signature 是数字签名，json 是真正的有效数据的字符串格式； 2. 用 signature 对 json 进行签名认证,算法：RSA-SHA256，输出类型：base64，得到认证结果； 3. 认证通过后，对 json 字符串解析，得到实际审核结果数据，详见 json 字段说明。 |
| json | String | 是 | JSON 字符串，是实际审核结果数据。含：message: 与 code 相关文本信息 timestamp：当前的服务器的 Unix 时间戳。nonce：随机数。 |
3.1.1 返回公共参数
| 参数名 | 类型 | 是否必有 | 说明 |
|---|---|---|---|
| code | Number | 是 | 请求的状态码，参见服务公共状态码解析 |
| message | String | 是 | 请求的状态信息 |
| timestamp | String | 是 | 当前的服务器的 Unix 时间戳 |
| nonce | String | 是 | 随机数(用于签名验证) |
| summary | String | 否 | 图片汇总结果，数组长度与入参对应 |
| taskId | Object | 是 | 审核任务的 ID，不同任务数据结构不同，请参看 3.1.3 各识别任务回调参数 |
3.1.2 返回公共参数示例
{
"signature": "signature_from_tupu_service",
"json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}