语音文件同步接口

请求地址:

http://api.open.tuputech.com/v3/recognition/speech/'your_secretId'
'your_secretId'需替换为您的secretId,请联系我们为您开通secretId。

请求方法:

POST

请求头:

Content-Type: multipart/form-data

请求及返回参数

请求参数说明:

参数名 类型 是否必填 说明
speech String或File 支持传语音文件或者URl,不过两者不能混在同一请求中;大小限制:1M以内;允许识别的格式:amr, mp3, wmv, wav, flv
task String 指定本次调用要审核的任务,任务id的形式,如:5caee6b2a76925c55a09a6d2
timestamp Number 当前的服务器的Unix时间戳
nonce Number 随机数
signature String 我们采用的数字证书签名算法是:"RSA-SHA256",签名输出类型是:"base64",具体步骤如下:
1、所有参与签名的参数为:secretId,timestamp,nonce,用英文半角逗号“,”相连,得到sign_string;
2、利用您的私钥,使用算法"RSA-SHA256"签名,输出为 "base64" 格式,得到参数signature的值。
点击管理公钥证书查看如何生成私钥,及如何上传您的公钥用于数字签名的认证;

QPS限制

  • 1秒最多允许请求10次;
  • 1个请求最多携带10个文件;

如有特殊并发需求,请联系我们。

返回参数说明

服务返回信息的公共结构

参数名 类型 是否必有 说明
signature String 我们采用的数字证书签名算法是:"RSA-SHA256",签名输出类型是:"base64",首先下载图普科技的公钥证书,然后按如下步骤认证:
1、收到的JSON数据经过JSON.parse(),得到JSON对象,记为data;
2、data含两个字段:signature、json;signature是数字签名,json是真正的有效数据的字符串格式;
3、用signature对json进行签名认证,算法:RSA-SHA256,输出类型:base64,得到认证结果;
4、认证通过后,对json进行JSON.parse(),得到JSON数据,详见"json"字段说明。
json String json 字段经过JSON.parse(json)后,得到具体的结果,含:
message:与code相关的文本信息
timestamp:当前的服务器的Unix时间戳。
nonce:随机数。
json内容解析后的结构
参数名 类型 是否必有 说明
code Number 请求的状态码,参考服务公共状态码解析
message String 请求的状态信息
timestamp Number 当前的服务器的Unix时间戳
nonce Number 随机数
[taskId] Object 识别任务的结果,不同识别任务会有特定的taskId和[taskId]信息结构
... ... 其它识别及请求响应结果信息
示例
{
    "signature": "signature_from_tupu_service", 
    "json": "{\"code\":0,\"message\":\"success\",\"nonce\":\"0.5442530125172196\",\"timestamp\":1595318082309}"
}

任务结果信息

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.open.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.open.tuputech.com/v3/recognition/speech/your_secret_id'

results matching ""

    No results matching ""