结果查询接口

该接口用于获取直播音频检测结果,检测结果包含违规分类信息,通过taskId获取到检测的结果后,下次再调用,不会再次返回之前获取过的结果数据。

POSThttps://asafe.ilivedata.com/api/v1/liveaudio/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/liveaudio/check/result

HTTP 响应

Content-Type: application/json;charset=UTF-8

响应字段

字段 类型 说明
errorCode Number 错误码:0表示成功
errorMessage String 错误消息
code Number 状态码:0:检测完成,1:检测失败,2:检测中
taskId String 请求时的taskId
result Number 0:通过,1:建议审核,2:不通过
audioSpams Array 直播音频检测结果(没有结果时为空)
streamId String 直播音频的id
extra Object 扩展字段

audioSpams[]

字段 类型 说明
startTime Number 片段开始时间对应的unix时间戳
endTime Number 片段结束时间对应的unix时间戳
text String 片段识别文本
url String 片段对应音频地址
vpr Boolean 命中声纹检测
tags Array 分类信息
language String 音频语种

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[] 命中详情

响应示例

{
    "errorCode": 0,
    "code": 0,
    "result": 审核结果,
    "taskId": "审核请求唯一标识",
    "audioSpams": [
    { //命中内容
        "startTime": 片段开始时间对应时间戳,
        "endTime":片段结束时间对应时间戳,
        "text": "片段识别文本",
        "url": "片段对应音频地址",
        "tags": [{
            "tag": 一级分类编码,
            "level": 分类级别,
            "tagName": 一级分类名,
            "tagNameEn": 一级分类英文名,
            "subTags": [{
                "subTag": 二级分类,
                "wordList": [
                    "违规词"
                ]
                "subTagName": 二级分类名,
                "subTagNameEn": 二级分类英文名,
            }]
        }]
    },
    { //命中声纹
        "startTime": 片段开始时间对应时间戳,
        "endTime":片段结束时间对应时间戳,
        "vpr": true,
        "url": "片段对应音频地址",
        "tags": [{
            "tag": 一级分类编码,
            "level": 分类级别,
            "tagName": 一级分类名,
            "tagNameEn": 一级分类英文名,
            "subTags": [{
                "subTag": 二级分类,
                "subTagName": 二级分类名,
                "subTagNameEn": 二级分类英文名,
            }]
        }]
    }
    ]
}

错误码

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