语音文件同步接口
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}"
}