内容审核 > API 文档 > API调用音频审核

API调用音频审核

最近更新时间: 2021-10-25 11:45:38

本文介绍了异步调用音频内容审核 /v3/audio/censor 的接口，帮助您正确使用此 API 进行音频内容审核，支持基于API URL发起HTTP/HTTPS POST请求的方式调用。

使用限制

音频大小不超过200M。
音频格式支持 MP3、WAV、AAC、WMA、OGG、M4A、AMR、AUDIO、M3U8。
接口响应时间依赖音频的下载时间。请保证被审核音频所在的存储服务稳定可靠，建议您使用七牛云存储或者CDN缓存等。

功能描述

音频内容审核 API 主要用于检测或识别音频中的不良信息，并给出审核结果管控建议。支持的审核类型包括：音频反垃圾。

审核类型 scenes 与相应的 label

在提交内容审核任务时，您需要指定审核类型 scenes ；而在返回结果中，则包含了您指定的类型对应的 label 结果分类参数。

审核类型	说明	scenes	label
音频反垃圾	识别音频中是否包含垃圾信息。	antispam	normal：正常文本 politics：涉政 porn：色情 abuse：辱骂 contraband：违禁

请求说明

请求方式：POST

请求url：http://ai.qiniuapi.com/v3/audio/censor

请求Header

字段	取值
Content-Type	application/json
Authorization	Qiniu < AccessKey> :< Sign> 注意: 用户请根据 AccessKey 和 SecretKey 后生成鉴权，以便进行身份验证， `Sign` 的取值以及 `Authorization` 签名方法请参考七牛鉴权。

请求参数

字段	类型	是否必选	说明
data.uri	string	Y	音频URL地址，目前支持http、https和qiniu协议的资源。
data.id	string	N	调用者设置的音频唯一标识，异步处理的返回结果中会带上该信息。
params.scenes	array	Y	审核类型，必填字段，当前唯一可选项： `antispam` 。
params.hook_url	string	N	音频检测结束后的回调地址。
params.hook_auth	Boolean	N	true/false，默认为false，设置回调请求中加入请求头authorization，用于回调服务器鉴权

请求示例

POST /v3/audio/censor HTTP/1.1
Host: ai.qiniuapi.com
Content-Type: application/json
Authorization: Qiniu YnxrxOSvGotRZpqkZnMzl_euuoqRzOKUd6zwbRju:r6a-o2UpBg6A4puIMnkCExH8lE8=

{
    "data": {
        "uri": "http://xxx.mp3",
        "id": "audio-censor-demo"
    },
    "params": {
        "scenes": [
            "antispam"
        ],
        "hook_url":"http://xxx.com"
    }
}

注意：请把 Authorization 换成您的账号七牛鉴权 QiniuToken

系统接受到请求后，会立即返回异步任务 id，音频审核结果通过任务 id 获得。

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": <id>
}

参数	类型	必选	说明
`id`	string	是	服务器返回的，唯一标识该音频审核任务的ID。

通过任务id获取音频审核结果

请求语法

GET /v3/jobs/audio/<id> HTTP/1.1
Host: ai.qiniuapi.com
Authorization: Qiniu <AccessKey>:<Sign>

注意： 需要在请求的 head 部分添加七牛鉴权，以进行用户身份验证。

参数	类型	必选	说明
`id`	string	是	服务器返回的，唯一标识该音频任务的ID。

返回参数说明

字段	取值	说明
id	string	服务器返回的，唯一标识该音频任务的ID。
status	string	任务状态， `WAITING/DOING/FINISHED/FAILED` 。
request	json结构体	音频审核请求中的body。
response	json结构体	音频内容审核的返回结果，详情请查看 `表. 音频内容审核的返回结果` 。
error	string	任务错误信息。
created_at	string	任务创建时间，如：2021-05-18T15:03:04.123Z。
updated_at	string	任务更新时间，如：2021-05-18T15:03:14.123Z。

表. 音频内容审核的返回结果

字段	取值	说明
code	int	处理状态：200 调用成功
message	string	与code对应的状态描述信息
audio_text	string	音频文本
result.suggestion	string	音频的审核结果管控建议说明根据内容审核中各种审核类型的返回结果，系统会将审核结果转换成对应的管控建议，取值包括：[“block”, ”review”, ”pass”]。 suggestion=block：表示系统确认审核内容违规，建议您将其删除。 suggestion=review：表示系统无法确认审核内容是否违规，建议您进行人工复核。 suggestion=pass：表示系统确认审核内容正常，建议您忽略该文件。
result.scenes. `<type>`	json结构体	审核类型, 目前仅支持 `antispam`
result.scenes. `<type>` .suggestion	string	该审核类型的结果管控建议，参见result.suggestion
result.scenes. `<type>` .cuts[]	array	该审核类型的音频段审核结果数组
result.scenes. `<type>` .cuts[].suggestion	string	该审核类型的音频段审核结果管控建议，参见result.suggestion
result.scenes. `<type>` .cuts[].start_time	int	该审核类型的音频段在原始音频中的起始位移，单位s
result.scenes. `<type>` .cuts[].end_time	int	该审核类型的音频段在原始音频中的结束位移，单位s
result.scenes. `<type>` .cuts[].audio_text	string	该审核类型的音频段文本
result.scenes. `<type>` .cuts[].details[]	array	该审核类型的音频段审核详细信息数组
result.scenes. `<type>` .cuts[].details[].suggestion	string	该审核类型的音频段审核结果详细的结果管控建议，参见result.suggestion
result.scenes. `<type>` .cuts[].details[].label	string	该审核类型的音频段审核结果标签
result.scenes. `<type>` .cuts[].details[].score	string	该审核类型的音频段审核结果置信度

返回示例

{
    "id":"5c416b7afb09fe00089e37be",
    "request":{
        "data":{
            "uri":"http://xxx.mp3",
             "id":"audio-censor-demo"
        },
        "params":{
            "scenes":[
                "antispam"
            ],
            "hook_url":"http://xxx.com"
        }
    },
    "status":"FINISHED",
    "result":{
        "code":200,
        "message":"OK",
        "audio_text":"当地时间八月二十八号...当务之急是...",
        "result":{
            "suggestion":"block",
            "scenes":{
                "antispam":{
                    "suggestion":"block",
                    "cuts":[
                        {
                            "suggestion":"block",
                            "start_time":0,
                            "end_time":20,
                            "audio_text":"当地时间八月二十八号...",
                            "details":[
                                {
                                    "suggestion":"block",
                                    "label":"politics",
                                    "score":0.9991
                                }
                            ]
                        },
                        {
                            "suggestion":"block",
                            "start_time":20,
                            "end_time":42,
                            "audio_text":"当务之急是...",
                            "details":[
                                {
                                    "suggestion":"block",
                                    "label":"politics",
                                    "score":0.982
                                }
                            ]
                        }
                    ]
                }
            }
        }
    },
    "created_at":"2021-05-18T15:03:04.123Z",
    "updated_at":"2021-05-18T15:03:14.123Z"
}

音频审核结果回调

使用限制须知

API调用音频审核支持不设置回调
若设置了回调，进行了一次API调用音频审核，则触发一次回调
若回调失败，会重试三次

API调用音频审核回调格式

字段	取值	说明
id	string	服务器返回的，唯一标识该音频审核任务的ID。
request	json结构体	音频审核请求中的body。
status	string	任务状态， `WAITING/DOING/FINISHED/FAILED` 。
response	json结构体	音频审核返回结果，详情请查看表. 音频内容审核的返回结果
error	string	任务错误信息。
created_at	string	任务创建时间，如：2021-05-18T15:03:04。
updated_at	string	任务更新时间，如：2021-05-18T15:03:14。

返回示例

{
    "id":"5c416b7afb09fe00089e37bf",
    "request":{
        "data":{
            "uri":"http://xxx.mp3",
            "id":"audio-censor-demo"
        },
        "params":{
            "scenes":[
                "antispam"
            ],
            "hook_url":"http://xxx.com"
        }
    },
    "status":"FINISHED",
    "response":{
        "code":200,
        "message":"OK",
        "audio_text":"当地时间八月二十八号...当务之急是...",
        "result":{
            "suggestion":"block",
            "scenes":{
                "antispam":{
                    "suggestion":"block",
                    "cuts":[
                        {
                            "suggestion":"block",
                            "start_time":0,
                            "end_time":20,
                            "audio_text":"当地时间八月二十八号...",
                            "details":[
                                {
                                    "suggestion":"block",
                                    "label":"politics",
                                    "score":0.9991
                                }
                            ]
                        },
                        {
                            "suggestion":"block",
                            "start_time":20,
                            "end_time":42,
                            "audio_text":"当务之急是...",
                            "details":[
                                {
                                    "suggestion":"block",
                                    "label":"politics",
                                    "score":0.982
                                }
                            ]
                        }
                    ]
                }
            }
        }
    },
    "created_at":"2021-05-18T15:03:04",
    "updated_at":"2021-05-18T15:03:14"
}

以上内容是否对您有帮助？