异步结果查询接口

该接口用于获取音频检测结果,检测结果包含违规分类信息。

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