同步审核接口

音频审核同步接口，信息提交后，会对音频进行检测，检测结果会在返回结果中展示。

POSThttps://asafe.ilivedata.com/api/v1/audio/check

支持格式

音频文件格式支持：wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flv、flac 等市场主流格式
音频时长需小于1分钟

请求参数

请求头

以下请求头均为必需。

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`	—	签名值，计算方式见下文「请求签名」

请求体

参数	类型	必需	说明
`type`	`Number`	必需	1：音频URL 2: 音频文件BASE64值
`lang`	`String`	可选	音频语种。不传或传空时默认自动识别；可在后台配置中设置语种识别候选列表。语言支持
`audio`	`String`	必需	音频内容，如type=1，则该值为音频URL，如type=2，则该值为音频BASE64值。type为2时，音频必须小于10m
`strategyId`	`String`	可选	策略编号，通过控制台配置。缺省时使用项目默认策略:DEFAULT
`returnAllSeg`	`String`	可选	0-只返回风险片段的结果，1-返回所有片段的结果
`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
`country`	`String`	可选	国家代码 ISO 3166-1 alpha-2
`extra`	`Object`	可选	扩展字段，可以传多个key和value，透传。比如传游戏服务器和游戏版本两个参数，传入方式：“extra” : {“server”: “123”,“version”:“456”}

请求示例

{
  "type": 1,
  "lang": "zh-CN",
  "audio": "http://xxx.xxx.com/xxxx",
  "userId": "testUser"
}

请求签名

按照帮助中心的请求签名计算 Authorization，使用以下接口参数。

签名参数	值
`HTTPMethod`	`POST`
`HostHeaderInLowercase`	`asafe.ilivedata.com`
`HTTPRequestURI`	`/api/v1/audio/check`

HTTP 响应

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

响应字段

字段	类型	说明
`errorCode`	`Number`	错误码，其中0表示成功
`errorMessage`	`String`	错误消息
`code`	`Number`	状态码，0:检测成功，1:检测失败
`taskId`	`String`	系统分配的taskId
`result`	`Number`	0:通过，1:建议审核，2:不通过
`audioSpams`	`Array`	命中信息
`audioText`	`String`	整段音频转录结果
`language`	`String`	语种
`durationMillis`	`Number`	音频时长(毫秒)
`extra`	`Object`	扩展字段
`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
400	2000	Missing Parameter
400	2001	Invalid Parameter