异步任务提交接口

更新时间:

提交音频信息接口，信息提交后，会对音频进行检测，检测结果需自行调用音频结果获取接口获取。

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

支持格式

音频文件格式支持：wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flv、flac 等市场主流格式。

大小限制

音频文件大小不超过550M ，时长小于5小时

请求参数

请求头

以下请求头均为必需。

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，文件大小上限500M，超过500M联系运营人员调整，如type=2，则该值为音频BASE64值。type为2时，音频必须小于10m
audioName String 可选 音频文件名字，当type=2，音频为BASE64值时，此参数为必需，且能表示音频格式
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
callbackRegion String 可选 回调区域：默认cn，可选cn，us，ap。不给或不在取值范围内默认使用cn区域发起回调
callbackUrl String 可选 回调url：http(s)协议
callbackSecretKey String 可选 回调密钥，可自行定义，需要在回调验签方式使用密钥一致，否则无法验证回调数据是否被篡改
country String 可选 国家代码 ISO 3166-1 alpha-2
extra Object 可选 扩展字段，可以传多个key和value，透传。比如传游戏服务器和游戏版本两个参数，传入方式：“extra” : {“server”: “123”,“version”:“456”}
businessParams String 可选 业务类型：噪音：NOISE

请求示例

{
  "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/submit

HTTP 响应

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

响应字段

字段 类型 说明
errorCode Number 错误码：0表示成功
errorMessage String 错误消息
result Object 结果信息

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
400 2000 Missing Parameter
400 2001 Invalid Parameter