异步结果查询接口
更新时间:
该接口用于获取音频检测结果,检测结果包含违规分类信息。
POSThttps://asafe.ilivedata.com/api/v1/audio/check/result
请求参数
请求头
以下请求头均为必需。
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
—
签名值,计算方式见下文「请求签名」
请求体
参数
类型
必需
说明
taskId
String
必需
调用音频提交接口成功后,返回的任务id
请求示例
{
"taskId": "f67fee0890de4c118d4f672b7c8ee304"
}
请求签名
按照帮助中心的请求签名计算 Authorization,使用以下接口参数。
签名参数
值
HTTPMethod
POST
HostHeaderInLowercase
asafe.ilivedata.com
HTTPRequestURI
/api/v1/audio/check/result
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
字段
类型
说明
errorCode
Number
响应码
errorMessage
String
响应信息
code
Number
状态码,定义为:0:检测成功,1:检测失败,2:检测中,3:taskId无效
taskId
String
请求时的taskId
result
Number
审核结果。0:通过,1:建议审核,2:不通过
audioSpams
Array
检测结果信息
audioText
String
整段音频转录结果
language
String
语种
durationMillis
Number
音频时长(毫秒)
extra
Object
扩展字段
businessResult
Object
业务参数属性, isNoise: “1”:噪音或静音;“0”:非噪音或静音
silence
Boolean
是否为静音音频,控制台开启
noise
Boolean
是否为噪音音频,控制台开启
voiceprint
VoicePrint
声纹信息
audioSpams[]
字段
类型
说明
startTime
Number
命中的音频段开始时间,单位秒
endTime
Number
命中的音频段结束时间,单位秒
text
String
音频段文本信息
vpr
Boolean
命中声纹检测
tags
Array
分类信息
tags[]
字段
类型
说明
tag
Number
分类信息:
100:涉政;110:暴恐;120:违禁;130:色情;150:广告;160:辱骂;
170:仇恨言论;180:未成年保护;190:敏感热点;510:少数民族语言检测;
220:私人交易;900:其他;999:用户自定义类
tagName
String
一级分类名称
tagNameEn
String
一级分类名称(英文)
level
Number
分类级别,0:正常,1:疑似,2:异常
subTags
Array
二级分类
subTags[]
字段
类型
说明
subTag
Number
二级分类详细编码请参考 分类编码对照表
subTagName
String
二级分类名称
subTagNameEn
String
二级分类名称(英文)
wordList
String[]
命中详情
voiceprint
字段
类型
说明
gender
VoicePrintResult
性别检测结果
voiceprint.gender
字段
类型
说明
label
String
male/female
score
Double
结果置信度
响应示例
{
"errorCode": 0,
"code": 0,
"result": 审核结果,
"taskId": 每条请求唯一标识,
"audioSpams": [
{
"startTime": 违规片段开始时间,
"endTime": 违规片段结束时间,
"text": 音频文本命中对应的识别结果,
"tags": [{
"tag": 违规一级分类代码,
"tagName": 违规一级分类名称,
"tagNameEn": 违规一级分类英文名称,
"level": 分类级别,
"subTags": [{
"subTag": 违规二级类别代码,
"subTagName": 违规二级类别名称,
"subTagNameEn": 违规二级类别英文名称,
"wordList": [
违规词
]
}]
}]
},
{
"startTime": 违规片段开始时间,
"endTime": 违规片段结束时间,
"vpr": 声纹命中,
"tags": [{
"tag": 违规一级分类代码,
"tagName": 违规一级分类名称,
"tagNameEn": 违规一级分类英文名称,
"level": 分类级别,
"subTags": [{
"subTag": 违规二级类别代码,
"subTagName": 违规二级类别名称,
"subTagNameEn": 违规二级类别英文名称,
}]
}]
}
],
"audioText": 整段识别文本,
"language": 音频语种,
"businessResult": {
"isNoise": "1"
}
}
错误码
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
200
1200
Downloads failed or base64 value invalid
401
2000
Missing Parameter
401
2001
Invalid Parameter
该接口用于获取音频检测结果,检测结果包含违规分类信息。
POST
https://asafe.ilivedata.com/api/v1/audio/check/result请求参数
请求头
以下请求头均为必需。
| 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 |
— | 签名值,计算方式见下文「请求签名」 |
请求体
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
taskId |
String |
必需 | 调用音频提交接口成功后,返回的任务id |
请求示例
{
"taskId": "f67fee0890de4c118d4f672b7c8ee304"
}
请求签名
按照帮助中心的请求签名计算 Authorization,使用以下接口参数。
| 签名参数 | 值 |
|---|---|
HTTPMethod |
POST |
HostHeaderInLowercase |
asafe.ilivedata.com |
HTTPRequestURI |
/api/v1/audio/check/result |
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
errorCode |
Number |
响应码 |
errorMessage |
String |
响应信息 |
code |
Number |
状态码,定义为:0:检测成功,1:检测失败,2:检测中,3:taskId无效 |
taskId |
String |
请求时的taskId |
result |
Number |
审核结果。0:通过,1:建议审核,2:不通过 |
audioSpams |
Array |
检测结果信息 |
audioText |
String |
整段音频转录结果 |
language |
String |
语种 |
durationMillis |
Number |
音频时长(毫秒) |
extra |
Object |
扩展字段 |
businessResult |
Object |
业务参数属性, isNoise: “1”:噪音或静音;“0”:非噪音或静音 |
silence |
Boolean |
是否为静音音频,控制台开启 |
noise |
Boolean |
是否为噪音音频,控制台开启 |
voiceprint |
VoicePrint |
声纹信息 |
audioSpams[]
| 字段 | 类型 | 说明 |
|---|---|---|
startTime |
Number |
命中的音频段开始时间,单位秒 |
endTime |
Number |
命中的音频段结束时间,单位秒 |
text |
String |
音频段文本信息 |
vpr |
Boolean |
命中声纹检测 |
tags |
Array |
分类信息 |
tags[]
| 字段 | 类型 | 说明 |
|---|---|---|
tag |
Number |
分类信息: 100:涉政;110:暴恐;120:违禁;130:色情;150:广告;160:辱骂; 170:仇恨言论;180:未成年保护;190:敏感热点;510:少数民族语言检测; 220:私人交易;900:其他;999:用户自定义类 |
tagName |
String |
一级分类名称 |
tagNameEn |
String |
一级分类名称(英文) |
level |
Number |
分类级别,0:正常,1:疑似,2:异常 |
subTags |
Array |
二级分类 |
subTags[]
| 字段 | 类型 | 说明 |
|---|---|---|
subTag |
Number |
二级分类详细编码请参考 分类编码对照表 |
subTagName |
String |
二级分类名称 |
subTagNameEn |
String |
二级分类名称(英文) |
wordList |
String[] |
命中详情 |
voiceprint
| 字段 | 类型 | 说明 |
|---|---|---|
gender |
VoicePrintResult |
性别检测结果 |
voiceprint.gender
| 字段 | 类型 | 说明 |
|---|---|---|
label |
String |
male/female |
score |
Double |
结果置信度 |
响应示例
{
"errorCode": 0,
"code": 0,
"result": 审核结果,
"taskId": 每条请求唯一标识,
"audioSpams": [
{
"startTime": 违规片段开始时间,
"endTime": 违规片段结束时间,
"text": 音频文本命中对应的识别结果,
"tags": [{
"tag": 违规一级分类代码,
"tagName": 违规一级分类名称,
"tagNameEn": 违规一级分类英文名称,
"level": 分类级别,
"subTags": [{
"subTag": 违规二级类别代码,
"subTagName": 违规二级类别名称,
"subTagNameEn": 违规二级类别英文名称,
"wordList": [
违规词
]
}]
}]
},
{
"startTime": 违规片段开始时间,
"endTime": 违规片段结束时间,
"vpr": 声纹命中,
"tags": [{
"tag": 违规一级分类代码,
"tagName": 违规一级分类名称,
"tagNameEn": 违规一级分类英文名称,
"level": 分类级别,
"subTags": [{
"subTag": 违规二级类别代码,
"subTagName": 违规二级类别名称,
"subTagNameEn": 违规二级类别英文名称,
}]
}]
}
],
"audioText": 整段识别文本,
"language": 音频语种,
"businessResult": {
"isNoise": "1"
}
}
错误码
| 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 |
| 200 | 1200 | Downloads failed or base64 value invalid |
| 401 | 2000 | Missing Parameter |
| 401 | 2001 | Invalid Parameter |