## 接口地址
[http://as.dun.163.com/v3/audio/submit](http://as.dun.163.com/v3/audio/submit)
## 接口描述
提交语音的URL进行语音内容检测。建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。
[查看v1.0提交接口文档](https://nos.netease.com/cloud-website-bucket/ce2789e18a69180b877cd61ce14fccde.pdf)
[查看v3.3提交接口文档](/help/documents/536339209153753088)
#### 音频文件限制
1、音频文件大小不超过550M ，时长小于5小时
2、音频文件格式支持：wav、mp3、aac、amr、3gp、m4a、wma、ogg、ape、flac、alac、wavpack、silk_v3等市场主流格式。
## 请求参数
公共参数已省略，详细见 [请求公共参数](/help/documents/191342014578741248)，其他参数如下：
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
|-----------|-------|------|------|-------|
| url | String | Y | 512 | 语音文件url |
| version | String| Y |4 |接口版本号，可选值 v3.5 |
| title | String | N | 512 | 文件标题 |
| ip | String | N | 32 | 用户IP地址 |
| account | String | N | 128 | 用户唯一标识，如果无需登录则为空 |
| deviceId | String | N | 128 |用户设备 id，与易盾设备画像库匹配，明文请转大写传入；MD5加密请明文转大写后MD5计算，再转大写传入，建议抄送|
| deviceType |Number| N | 4 |用户设备id的类型，0:其他，10:IMEI，11:AndroidID，12:IDFA，13:IDFV，14:MAC ，20:IMEI_MD5，21:AndroidID_MD5，22:IDFA_MD5，23:IDFV_MD5，24:MAC_MD5，25:HarmonyOS|
| callback | String | N | 2^16-1 |数据回调参数，调用方根据业务情况自行设计，当调用离线结果获取接口时，该接口会原样返回该字段，详细见[音频离线检测结果获取](/help/documents/191344520906067968)。作为数据处理标识，因此该字段应该设计为能唯一定位到该次请求的数据结构，如对用户的昵称进行检测，dataId可设为用户标识（用户ID），用户修改多次，每次请求数据的dataId可能一致，但是callback参数可以设计成定位该次请求的数据结构，比如callback字段设计成json，包含dataId和请求的时间戳等信息，当然如果不想做区分，也可以直接把callback设置成dataId的值。 |
|callbackUrl | String |N |256 | 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s，为了保证顺利接收数据，需保证接收接口性能稳定并且保证幂等性。 |
|uniqueKey|String|否|256|检测去重字段，填入后使用此字段去重，如果没填入则默认使用url进行去重|
| subProduct |String |N| 32 | 业务结算id(自定义),业务方传入参数，用于资源账单统计,如需开启请联系易盾客户经理。开启之后资源账单按套餐结算sheet增加subProduct维度的数据请求量、检测量、消耗金额的统计|
### 业务扩展参数
业务扩展参数，有助于通过业务维度辅助反垃圾结果判定
| 参数名称 | 类型 | 是否必选 | 最大长度 | 描述 |
|-----------|-------|------|------|-------|
| 用户信息| - | N | - | 用户信息包含账号、昵称、等级、角色等，请查看 业务扩展参数—用户信息|
| 设备信息| - | N | - | 设备信息包含设备ID、设备ID类型等，请查看 业务扩展参数—设备信息 |
| 场景信息| - | N | - | 场景信息包含私聊、群聊、直播、帖子等场景字段，请查看 业务扩展参数—场景信息 |
| extension | String | N | 30000 | 自定义扩展参数 |
## 响应结果
响应字段如下，响应通用字段已省略，详细见[响应通用字段](/help/documents/191342014578741248)：
result 数据结构
| 参数名称 | 类型 | 描述 |
|-----------|-------|------|
| taskId | String | 本次请求数据标识，可以根据该标识查询数据最新结果 |
| status | Number | 请求结果，0成功，1失败 |
| dealingCount | Number | 缓冲池排队待处理数据量 |
#### 缓冲池排队待处理量说明
为减少用户重试，优化用户体验，易盾为点播音频用户提供了缓冲池功能，点播音频正式的并发处理为30路，提交超并发后即自动进入缓冲池排队过检，您可以根据缓冲池排队积压量评估您目前的并发处理速度是否合适，如需调整处理并发请联系您的专属商务处理。
## 响应示例
```json
{
"code": 200,
"msg": "ok",
"result": {
"taskId": "*****",
"status": 0
"dealingCount":0
}
}
```
重复检测返回结构
以url做判断，如若当前有正在检测的url,重复检测按照失败返回
```json
{
"code":417,
"msg":"返回原提交taskID值"
}
```