语音文件异步接口

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

http请求方法:POST

http Content-type: application/json

并发限制:测试期允许最多同时处理3个文件,正式使用请与我们沟通协商

请求示例:

{
    "recording": {
        "url": "http://www.tupu.com/test.mp3",
        "callbackUrl": "http://your_cb.com",
        "roomId": "your_room_id",
        "userId": "your_user_id",
        "forumId": "your_forum_id"
    },
    "timestamp": 1541499770,
    "nonce": 0.8469537531104208,
    "signature": "your_signature"
}

请求参数说明:

参数名 类型 是否必填 说明
recording Object 录音文件信息,详见下面说明
timestamp Number 当前的服务器的Unix时间戳
nonce Number 随机数
signature String 我们采用的数字证书签名算法是:"RSA-SHA256",签名输出类型是:"base64",具体步骤如下:
1、所有参与签名的参数为:secretId,timestamp,nonce,用英文半角逗号“,”相连,得到sign_string;
2、利用您的私钥,使用算法"RSA-SHA256"签名,输出为 "base64" 格式,得到参数signature的值。
点击管理公钥证书查看如何生成私钥,及如何上传您的公钥用于数字签名的认证;

文件限制

大小限制:100M以内;
允许识别的格式:amr, mp3, wmv, wav, flv;

recording参数说明:

参数名 类型 是否必填 说明
url String 音频文件地址;大小限制:100M以内;允许识别的格式:amr, mp3, wmv, wav, flv
callbackUrl String 检测结果的回调地址,失败重试2次,需自行保证回调地址正常
roomId String 房间ID
userId String 用户ID
forumId String 板块ID ,数据ID


curl请求示例

curl -X POST --header 'Content-Type: application/json' \
-d '{
    "recording": [
        {
        "url": "rtmp://pili-Room-4daedc9c7a5db36c325f6609000c0201",
        "callbackUrl": "http://www.tupu.com/callback",
        "roomId": "111111",
        "userId": "23231",
        "forumId": "321313"
        }
    ],
    "timestamp": 1541499770,
    "nonce": 0.8469537531104208,
    "signature": "CsIMcHuWqn/QFEnHWcFEhrB7ydcg5xTKawpRpNqA9Nw2WlCVIDR5jDcyUF85"
}' \
'http://api.open.tuputech.com/v3/recognition/speech/recording/async/your_secretId'

返回参数说明

返回的公共信息

参考服务公共响应结果结构

注意:同步请求及异步回调结果都是此结构,不同的是json里的信息

请求的同步响应

json字段数据示例:

{     
    "result": {
        "requestId": "tupu_request_id",
        "url": "http://www.tupu.com/test.mp3",
        "callbackUrl": "http://your_cb.com",
        "roomId": "your_room_id",
        "userId": "your_user_id",
        "forumId": "your_forum_id"
    },
    "code": 0,
    "message": "success",
    "nonce": "0.01627771095362096",
    "timestamp": 1552391372490
}

结果的数据结构

参数名 类型 是否必有 说明
result Array 详见以下result数据结构

result数据结构

参数名 类型 是否必有 说明
requestId String 客户提交的音频的唯一请求id,后续可以通过该id查到音频的相关信息
url String 音频文件地址
callbackUrl String 检测结果的回调地址
roomId String 房间ID
userId String 用户ID
forumId String 板块ID ,数据ID

回调结果

回调请求

http请求地址:request callbackUrl参数值里的地址

http请求方法:POST

http Content-type: application/json

发送端判断回调是否成功

http状态为 200 则表示回调成功,所以客户端成功收到回调后,需尽快响应并携带200状态码,防止回调重复发送

回调结果json里的公共结构

结果的数据结构

参数名 类型 是否必有 说明
requestId String 客户提交的音频的唯一请求id
roomId String 房间ID
userId String 用户ID
forumId String 板块ID ,数据ID
任务id Object 审核任务的id,结构详见以下描述

results matching ""

    No results matching ""