任务提交接口
更新时间:
提交直播语音的URL进行语音内容检测,检测结果需自行调用直播音频结果获取接口获取。
检测接口支持的流媒体协议如下:rtp、srtp、rtmp、rtmps、mmsh、mmst、hls、http-m3u8、http-flv、tcp、 mpd等。
POSThttps://asafe.ilivedata.com/api/v1/liveaudio/check/submit
请求参数
请求头
以下请求头均为必需。
Header
值
说明
Content-Type
application/json; charset=UTF-8
请求体格式
Accept
application/json; charset=UTF-8
响应格式
X-AppId
—
控制台「服务配置」中的项目编号
X-TimeStamp
—
请求发起时的 UTC 时间,采用 W3C 格式。
格式示例:2026-09-30T02:30:00Z,实际请求需使用当前时间。
Authorization
—
签名值,计算方式见下文「请求签名」
请求体
参数
类型
必需
说明
lang
String
可选
音频语种。不传或传空时默认自动识别;可在后台配置中设置语种识别候选列表。语言支持
audio
String
必需
直播音频的url, 相同的url不会重复检测
streamId
String
可选
直播音频的id, 相同的streamId不会重复检测
strategyId
String
可选
策略编号,通过控制台配置。缺省时使用项目默认策略:DEFAULT
userId
String
可选
唯一的终端用户ID。 用户ID应当不超过32个字符。
userIP
String
可选
用户IP地址
did
String
可选
用户设备ID
dtype
String
可选
用户设备类型:1:iPhone 2:android 3: ipad
4:wphone 5: pc 6:web 7:wap
interval
Number
可选
音频流切分时长,可自定时间5s、10s、15s、20s.默认为10s,
callbackRegion
String
可选
回调区域:默认cn,可选cn,us,ap。不给或不在取值范围内默认使用cn区域发起回调
callbackUrl
String
可选
回调url:http协议
callbackSecretKey
String
可选
回调密钥,可自行定义,需要在回调验签方式使用密钥一致,否则无法验证回调数据是否被篡改
callbackStrategy
String
可选
回调策略,0(默认):只回调违规/疑似片段;1:回调所有片段
country
String
可选
国家代码 ISO 3166-1 alpha-2
extra
Object
可选
扩展字段,可以传多个key和value,透传。比如传游戏服务器和游戏版本两个参数,传入方式:“extra” : {“server”: “123”,“version”:“456”}
请求示例
{
"lang": "zh-CN",
"audio": "http://xxx.xxx.com/xxxx",
"streamId": "streamid",
"userId": "testUser",
"interval": 10
}
请求签名
按照帮助中心的请求签名计算 Authorization,使用以下接口参数。
签名参数
值
HTTPMethod
POST
HostHeaderInLowercase
asafe.ilivedata.com
HTTPRequestURI
/api/v1/liveaudio/check/submit
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
字段
类型
说明
errorCode
Number
错误码:0表示成功
errorMessage
String
错误消息
result
Array
结果信息
result
字段
类型
说明
taskId
String
任务id,用于调用直播音频结果获取接口
响应示例
{
"errorCode": 0,
"result": {
"taskId": "f67fee0890de4c118d4f672b7c8ee304"
}
}
错误码
HTTP 状态码
错误码
错误消息
200
0
此字段省略
405
1004
Method Not Allowed
411
1007
Not Content Length
400
1002
API Not Found
400
1003
Bad Request
401
1102
Unauthorized Client
401
1106
Missing Access Token
401
1107
Invalid Token
401
1108
Expired Token
401
1110
Invalid Client
401
2000
Missing Parameter
401
2001
Invalid Parameter
提交直播语音的URL进行语音内容检测,检测结果需自行调用直播音频结果获取接口获取。
检测接口支持的流媒体协议如下:rtp、srtp、rtmp、rtmps、mmsh、mmst、hls、http-m3u8、http-flv、tcp、 mpd等。
POST
https://asafe.ilivedata.com/api/v1/liveaudio/check/submit请求参数
请求头
以下请求头均为必需。
| Header | 值 | 说明 |
|---|---|---|
Content-Type |
application/json; charset=UTF-8 |
请求体格式 |
Accept |
application/json; charset=UTF-8 |
响应格式 |
X-AppId |
— | 控制台「服务配置」中的项目编号 |
X-TimeStamp |
— | 请求发起时的 UTC 时间,采用 W3C 格式。 格式示例: 2026-09-30T02:30:00Z,实际请求需使用当前时间。 |
Authorization |
— | 签名值,计算方式见下文「请求签名」 |
请求体
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
lang |
String |
可选 | 音频语种。不传或传空时默认自动识别;可在后台配置中设置语种识别候选列表。语言支持 |
audio |
String |
必需 | 直播音频的url, 相同的url不会重复检测 |
streamId |
String |
可选 | 直播音频的id, 相同的streamId不会重复检测 |
strategyId |
String |
可选 | 策略编号,通过控制台配置。缺省时使用项目默认策略:DEFAULT |
userId |
String |
可选 | 唯一的终端用户ID。 用户ID应当不超过32个字符。 |
userIP |
String |
可选 | 用户IP地址 |
did |
String |
可选 | 用户设备ID |
dtype |
String |
可选 | 用户设备类型:1:iPhone 2:android 3: ipad 4:wphone 5: pc 6:web 7:wap |
interval |
Number |
可选 | 音频流切分时长,可自定时间5s、10s、15s、20s.默认为10s, |
callbackRegion |
String |
可选 | 回调区域:默认cn,可选cn,us,ap。不给或不在取值范围内默认使用cn区域发起回调 |
callbackUrl |
String |
可选 | 回调url:http协议 |
callbackSecretKey |
String |
可选 | 回调密钥,可自行定义,需要在回调验签方式使用密钥一致,否则无法验证回调数据是否被篡改 |
callbackStrategy |
String |
可选 | 回调策略,0(默认):只回调违规/疑似片段;1:回调所有片段 |
country |
String |
可选 | 国家代码 ISO 3166-1 alpha-2 |
extra |
Object |
可选 | 扩展字段,可以传多个key和value,透传。比如传游戏服务器和游戏版本两个参数,传入方式:“extra” : {“server”: “123”,“version”:“456”} |
请求示例
{
"lang": "zh-CN",
"audio": "http://xxx.xxx.com/xxxx",
"streamId": "streamid",
"userId": "testUser",
"interval": 10
}
请求签名
按照帮助中心的请求签名计算 Authorization,使用以下接口参数。
| 签名参数 | 值 |
|---|---|
HTTPMethod |
POST |
HostHeaderInLowercase |
asafe.ilivedata.com |
HTTPRequestURI |
/api/v1/liveaudio/check/submit |
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
errorCode |
Number |
错误码:0表示成功 |
errorMessage |
String |
错误消息 |
result |
Array |
结果信息 |
result
| 字段 | 类型 | 说明 |
|---|---|---|
taskId |
String |
任务id,用于调用直播音频结果获取接口 |
响应示例
{
"errorCode": 0,
"result": {
"taskId": "f67fee0890de4c118d4f672b7c8ee304"
}
}
错误码
| HTTP 状态码 | 错误码 | 错误消息 |
|---|---|---|
| 200 | 0 | 此字段省略 |
| 405 | 1004 | Method Not Allowed |
| 411 | 1007 | Not Content Length |
| 400 | 1002 | API Not Found |
| 400 | 1003 | Bad Request |
| 401 | 1102 | Unauthorized Client |
| 401 | 1106 | Missing Access Token |
| 401 | 1107 | Invalid Token |
| 401 | 1108 | Expired Token |
| 401 | 1110 | Invalid Client |
| 401 | 2000 | Missing Parameter |
| 401 | 2001 | Invalid Parameter |