跳到主要内容

语音文件同步接口

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 请求参数说明

参数名类型是否必填说明
speechString 或 File支持传语音文件或者 URL,不过两者不能混在同一请求中;大小限制:1M 以内;允许识别的格式:amr, mp3, wmv, wav, flv, m4a
taskString指定本次调用要审核的任务,任务 ID 的形式,如:5caee6b2a76925c55a09a6d2
languageString需要识别的语言代码。需要进行多语种语音转译审核或者多语种转译时必传。多语种语音转译类产品需联系图普进行配置使用。
对应语言代码详见:语音转译审核(多语种)语言代码列表
timestampNumber当前的服务器的 Unix 时间戳
nonceNumber随机数
signatureString

RSA-SHA256 算法签名。签名步骤:

  1. 将参与签名的参数(secretIdtimestampnonce)用英文半角逗号 , 拼接,得到 SignString
  2. 使用您的私钥以 RSA-SHA256 算法对 SignString 签名,然后进行 Base64 编码,得到 signature 字符串。

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 返回参数说明

参数名类型是否必有说明
signatureString响应经过 JSON 字符串转义后的签名。我们采用的数字证书签名算法是:RSA-SHA256,签名输出类型是:base64,首先下载图普科技的公钥证书,然后按如下步骤认证:
1. 接口返回的响应含两个字段:signature 和 json,signature 是数字签名,json 是真正的有效数据的字符串格式;
2. 用 signature 对 json 进行签名认证,算法:RSA-SHA256,输出类型:base64,得到认证结果;
3. 认证通过后,对 json 字符串解析,得到实际审核结果数据,详见 json 字段说明。
jsonStringJSON 字符串,是实际审核结果数据。含:
message: 与 code 相关文本信息
timestamp:当前的服务器的 Unix 时间戳。
nonce:随机数。

3.1.1 返回公共参数

参数名类型是否必有说明
codeNumber请求的状态码,参见服务公共状态码解析
messageString请求的状态信息
timestampString当前的服务器的 Unix 时间戳
nonceString随机数(用于签名验证)
summaryString图片汇总结果,数组长度与入参对应
taskIdObject审核任务的 ID,不同任务数据结构不同,请参看 3.1.3 各识别任务回调参数

3.1.2 返回公共参数示例

{
"signature": "signature_from_tupu_service",
"json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}

3.1.3 具体任务返回结果