最近更新时间: 2021-11-18 16:25:43

功能描述

本功能基于先进的人工智能技术，精准识别各类场景涉政、色情、暴恐、垃圾广告、Logo水印等违规内容，帮助您提前防御内容风险，提高审核效率，净化网络环境，提升用户体验。

接口规格

提交视频流识别请求

请求URL: https://censor-open.qiniuapi.com/anti_fraud/v3/videostream

字符编码格式: 请求及返回结果都使用 UTF-8 字符集进行编码

请求方法: POST

建议超时时长: 3s

请求参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
imgType	string	Y	视频流截帧识别类型，可选值: DEFAULT:默认识别涉政、色情、广告，取值为POLITICS_PORN_AD，DEFAULT只能单独使用不能连接其他类型，否则DEFAULT失效 POLITICS:涉政识别 PERSON:涉政人物识别 VIOLENCE:暴恐识别 PORN:色情识别 AD:广告识别 LOGO:视频水印logo识别 BEHAVIOR:不良场景识别，支持吸烟、喝酒、赌博、吸毒、避孕套和无意义画面通过下划线连接，如AD_PORN_POLITICS用于广告、色情和涉政组合识别
audioType	string	Y	视频流中的音频流识别类型，可选值: DEFAULT:默认识别涉政、色情、广告，等价于POLITICAL_PORN_AD POLITICAL:涉政识别 PORN:色情识别 AD:广告识别 MOAN:娇喘识别 NONE:不识别音频如需做组合识别，通过下划线连接即可，例如 POLITICAL_PORN_MOAN用于涉政、色情和娇喘识别。
imgCallback	string	Y	图片回调地址，将视频流中截帧图片的检测结果通过该地址回调给用户。
audioCallback	string	N	音频回调地址，将视频流中音频的检测结果通过该地址回调给用户; audioType值不为NONE时必传。
data	json_object	Y	请求数据，最长1MB，详细内容参见下表

其中，data的内容如下:

参数名称	类型	是否必选	说明
url	string	Y	要检测的视频流url地址，目前仅支持rtmp协议
tokenId	string	Y	用户账号标识
returnAllImg	int	N	用户可根据需求选择返回不同审核结果的图片，可选值为0 和1，默认值为0。 0:回调reject、review结果的图片审核信息 1:回调所有结果的图片审核信息
streamName	string	N	视频流名称
returnAllText	bool	N	取值为true时返回全量的音频流片段识别结果和文本内容; 取值为false时只返回有风险(riskType为REJECT)的音频流片段识别结果和文本内容，默认是false
detectFrequency	float	N	视频流截帧频率，取值范围:1-60(秒/帧)，默认为3
room	string	N	直播间/游戏房间编号，可针对单个房间制定不同的策略;

返回参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
code	int	Y	返回码
message	string	Y	返回码详情描述
entryId	string	Y	请求唯一标识，建议保存可用于关闭视频流

异步回调识别结果

支持协议: HTTP或HTTPS

字符编码格式: 请求及返回结果都使用UTF-8字符集进行编码

请求方法: POST

建议超时时长: 5s

返回字段: 放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
code	int	Y	返回码
message	string	Y	返回码详情描述
entryId	string	Y	请求唯一标识
riskLevel	string	N	风险级别(code为1100时存在)，可能返回值: PASS:正常内容 REVIEW:疑似违规内容 REJECT:违规内容
contentType	int	Y	用来区分音频和图片回调，可能取值为1和2。 1:该回调为图片回调 2:该回调为音频回调
detail	json_object	N	视频流中截帧图片或者音频片段的风险详情(code 为 1100 时存在)

其中，在图片回调(contentType 为 1)时，detail 内容如下

参数名称	类型	是否必选	说明
room	string	N	房间号，当客户传入时返回该字段
requestParams	json object	Y	返回请求参数data中的所有字段
imgUrl	string	Y	截帧图片url地址，有效时间30分钟
beginProcessTime	int	Y	截帧生成时间(13位时间戳)
finishProcessTime	int	Y	检测完成时间(13位时间戳)
imgTime	string	Y	视频流截帧图片违规发生的时间(绝对时间)
riskType	int	Y	标识风险类型，可能取值: 0: 正常 100:涉政 200:色情 210:性感 300:广告 310:二维码 320:水印 400:暴恐 500:违规 510:不良场景 700:黑名单 710:白名单 800:高危账号 900:自定义
model	string	Y	策略规则标识，用来标识命中的策略规则
descriptionV2	string	N	新版策略规则风险原因描述
matchedItem	string	N	命中的具体敏感词(该参数仅在命中敏感词时存在)
matchedList	string	N	命中敏感词所在的名单名称(该参数仅在命中敏感词时存在)
matchedDetail	string	N	命中的敏感词详请
imgText	string	N	视频中画面识别出的文字内容

其中，在音频回调(contentType 为 2)时，detail 内容如下:

参数名称	类型	是否必选	说明
audioText	string	Y	音频转译文本结果
audioTime	int	N	整段音频的音频时长，单位秒，code为1100时存在
labels	string	N	音频片段风险原因汇总
detail	json_array	N	风险详情
gender	json_object	N	性别标签与概率值
tags	json_array	N	音色标签与概率值列表
callbackParam	json_object	Y	客户传入的透传字段

detail 数组中每一项的具体参数如下:

参数名称	类型	是否必选	说明
room	string	N	房间号，当客户传入时返回该字段
requestParams	json object	Y	返回请求参数data中的所有字段
audioUrl	string	Y	视频流中音频流片段的url地址，有效时间30分钟
audioStartTime	string	Y	视频流中音频违规内容开始时间(绝对时间)
audioEndTime	string	Y	视频流中音频违规内容结束时间(绝对时间)
riskType	int	Y	风险类型，可能取值: 0:正常 100:涉政 120:国歌 200:色情 210:辱骂 250:娇喘 300:广告 700:黑名单 900:自定义
matchedItem	string	N	音频中可能出现的敏感词
descriptionV2	string	Y	风险原因描述
isSing	int	N	type取值包含SING时存在，取值0表示检测不存在唱歌片段，取值1表示检测存在唱歌片段
language	json_array	N	语种标签与概率值列表
audioText	string	Y	音频片段对应的文本内容

language 数组中每一项具体参数如下:

参数名称	类型	是否必选	说明
label	int	Y	语种识别类别标识，可能取值: 0:普通话 1:英语 2:粤语
confidence	int	Y	对应语种标签可能性大小，取值0-100，数值越高表示概率越大。

关闭视频流识别

请求URL: https://censor-open.qiniuapi.com/anti_fraud/v3/finish_videostream

字符编码格式: 请求及返回结果都使用UTF-8字符集进行编码

请求方法: POST

建议超时时长: 5s

请求参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
entryId	string	Y	音频唯一标识，用于查询识别结果

示例

请求示例

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

{
    "audioCallback": "http://xxx",
    "audioType": "PORN",
    "data":{
        "channel": "VIDEOSTREAM",
        "returnAllImg": 1,
        "returnAllText": true,
        "room": "001",
        "tokenId": "1157893895",
        "url": "rtmp://xxxx"
    },
    "imgCallback":"http://xxxxxxxxx",
    "imgType": "DEFAULT"
}

返回示例

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

{
    "code":1100,
    "message":"成功",
    "entryrid":"5564f430ee6a1adb40f06d768b40316b",
}

回调示例（图像内容)

POST /xxxx HTTP/1.1
Host: xxxx
Content-Type: application/json

{
    "code":1100,
    "message":"成功",
    "entryId":"b891cf2d82e214de45df33fc2bea4875",
    "riskLevel":"REJECT",
    "contentType":1,
    "detail":{
        "descriptionV2":"正常",
        "imgText":"ocr123 你好",
        "imgTime":"2019-09-20 14:53:25",
        "imgUrl":"http://yyyyyyyyyyyyyyyyy.jpg",
        "matchedDetail":"[{"listId":"0b5d2ed695d40c0aa51e2b35fb51763d","matchedFiled":["text"],"name":"涉政测试","organization":"RlokQwRlVjUrTUlkIqOg","words":[" 你好"]}]",
        "matchedItem":"你好",
        "matchedList":"涉政测试",
        "model":"M02601",
        "polityName":"你好",
        "requestParams":{
            "channel":"VIDEOSTREAM",
            "returnAllImg":1,
            "returnAllText":true,
            "room":"001",
            "tokenId":"1157893895",
            "url":"rtmp://xxxxxxx"
        },
        "riskType":100,
        "room":"001"
    }
}

回调示例（音频内容)

POST /xxxx HTTP/1.1
Host: xxxx
Content-Type: application/json

{
    "code":1100,
    "message":"成功",
    "entryId":"b891cf2d82e214de45df33fc2bea4875",
    "riskLevel":"REJECT",
    "contentType":2,
    "detail":{
        "audioEndTime":"2019-09-20 15:27:35",
        "audioStartTime":"2019-09-20 15:27:25",
        "audioText":"老婆",
        "audioUrl":"http://xxxxxxxxxxx.mp3",
        "model":"M02101",
        "requestParams":{
            "channel":"VIDEOSTREAM",
            "returnAllImg":1,
            "returnAllText":true,
            "room":"001",
            "tokenId":"1157893895",
            "url":"rtmp://xxxxxxx"
        },
        "riskType":200,
        "room":"001"
    }
}

错误码

Code	Message
1100	成功
1901	QPS受限
1902	参数不合法
1903	服务失败
1911	下载超时
91xx	内部错误

最近更新时间: 2021-11-18 16:25:43

功能描述

接口规格

提交视频流识别请求

请求URL: https://censor-open.qiniuapi.com/anti_fraud/v3/videostream

字符编码格式: 请求及返回结果都使用 UTF-8 字符集进行编码

请求方法: POST

建议超时时长: 3s

请求参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
imgType	string	Y	视频流截帧识别类型，可选值: DEFAULT:默认识别涉政、色情、广告，取值为POLITICS_PORN_AD，DEFAULT只能单独使用不能连接其他类型，否则DEFAULT失效 POLITICS:涉政识别 PERSON:涉政人物识别 VIOLENCE:暴恐识别 PORN:色情识别 AD:广告识别 LOGO:视频水印logo识别 BEHAVIOR:不良场景识别，支持吸烟、喝酒、赌博、吸毒、避孕套和无意义画面通过下划线连接，如AD_PORN_POLITICS用于广告、色情和涉政组合识别
audioType	string	Y	视频流中的音频流识别类型，可选值: DEFAULT:默认识别涉政、色情、广告，等价于POLITICAL_PORN_AD POLITICAL:涉政识别 PORN:色情识别 AD:广告识别 MOAN:娇喘识别 NONE:不识别音频如需做组合识别，通过下划线连接即可，例如 POLITICAL_PORN_MOAN用于涉政、色情和娇喘识别。
imgCallback	string	Y	图片回调地址，将视频流中截帧图片的检测结果通过该地址回调给用户。
audioCallback	string	N	音频回调地址，将视频流中音频的检测结果通过该地址回调给用户; audioType值不为NONE时必传。
data	json_object	Y	请求数据，最长1MB，详细内容参见下表

其中，data的内容如下:

参数名称	类型	是否必选	说明
url	string	Y	要检测的视频流url地址，目前仅支持rtmp协议
tokenId	string	Y	用户账号标识
returnAllImg	int	N	用户可根据需求选择返回不同审核结果的图片，可选值为0 和1，默认值为0。 0:回调reject、review结果的图片审核信息 1:回调所有结果的图片审核信息
streamName	string	N	视频流名称
returnAllText	bool	N	取值为true时返回全量的音频流片段识别结果和文本内容; 取值为false时只返回有风险(riskType为REJECT)的音频流片段识别结果和文本内容，默认是false
detectFrequency	float	N	视频流截帧频率，取值范围:1-60(秒/帧)，默认为3
room	string	N	直播间/游戏房间编号，可针对单个房间制定不同的策略;

返回参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
code	int	Y	返回码
message	string	Y	返回码详情描述
entryId	string	Y	请求唯一标识，建议保存可用于关闭视频流

异步回调识别结果

支持协议: HTTP或HTTPS

字符编码格式: 请求及返回结果都使用UTF-8字符集进行编码

请求方法: POST

建议超时时长: 5s

返回字段: 放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
code	int	Y	返回码
message	string	Y	返回码详情描述
entryId	string	Y	请求唯一标识
riskLevel	string	N	风险级别(code为1100时存在)，可能返回值: PASS:正常内容 REVIEW:疑似违规内容 REJECT:违规内容
contentType	int	Y	用来区分音频和图片回调，可能取值为1和2。 1:该回调为图片回调 2:该回调为音频回调
detail	json_object	N	视频流中截帧图片或者音频片段的风险详情(code 为 1100 时存在)

其中，在图片回调(contentType 为 1)时，detail 内容如下

参数名称	类型	是否必选	说明
room	string	N	房间号，当客户传入时返回该字段
requestParams	json object	Y	返回请求参数data中的所有字段
imgUrl	string	Y	截帧图片url地址，有效时间30分钟
beginProcessTime	int	Y	截帧生成时间(13位时间戳)
finishProcessTime	int	Y	检测完成时间(13位时间戳)
imgTime	string	Y	视频流截帧图片违规发生的时间(绝对时间)
riskType	int	Y	标识风险类型，可能取值: 0: 正常 100:涉政 200:色情 210:性感 300:广告 310:二维码 320:水印 400:暴恐 500:违规 510:不良场景 700:黑名单 710:白名单 800:高危账号 900:自定义
model	string	Y	策略规则标识，用来标识命中的策略规则
descriptionV2	string	N	新版策略规则风险原因描述
matchedItem	string	N	命中的具体敏感词(该参数仅在命中敏感词时存在)
matchedList	string	N	命中敏感词所在的名单名称(该参数仅在命中敏感词时存在)
matchedDetail	string	N	命中的敏感词详请
imgText	string	N	视频中画面识别出的文字内容

其中，在音频回调(contentType 为 2)时，detail 内容如下:

参数名称	类型	是否必选	说明
audioText	string	Y	音频转译文本结果
audioTime	int	N	整段音频的音频时长，单位秒，code为1100时存在
labels	string	N	音频片段风险原因汇总
detail	json_array	N	风险详情
gender	json_object	N	性别标签与概率值
tags	json_array	N	音色标签与概率值列表
callbackParam	json_object	Y	客户传入的透传字段

detail 数组中每一项的具体参数如下:

参数名称	类型	是否必选	说明
room	string	N	房间号，当客户传入时返回该字段
requestParams	json object	Y	返回请求参数data中的所有字段
audioUrl	string	Y	视频流中音频流片段的url地址，有效时间30分钟
audioStartTime	string	Y	视频流中音频违规内容开始时间(绝对时间)
audioEndTime	string	Y	视频流中音频违规内容结束时间(绝对时间)
riskType	int	Y	风险类型，可能取值: 0:正常 100:涉政 120:国歌 200:色情 210:辱骂 250:娇喘 300:广告 700:黑名单 900:自定义
matchedItem	string	N	音频中可能出现的敏感词
descriptionV2	string	Y	风险原因描述
isSing	int	N	type取值包含SING时存在，取值0表示检测不存在唱歌片段，取值1表示检测存在唱歌片段
language	json_array	N	语种标签与概率值列表
audioText	string	Y	音频片段对应的文本内容

language 数组中每一项具体参数如下:

参数名称	类型	是否必选	说明
label	int	Y	语种识别类别标识，可能取值: 0:普通话 1:英语 2:粤语
confidence	int	Y	对应语种标签可能性大小，取值0-100，数值越高表示概率越大。

关闭视频流识别

请求URL: https://censor-open.qiniuapi.com/anti_fraud/v3/finish_videostream

字符编码格式: 请求及返回结果都使用UTF-8字符集进行编码

请求方法: POST

建议超时时长: 5s

请求参数

放在 HTTP Body 中，采用 Json 格式，具体参数如下:

参数名称	类型	是否必选	说明
entryId	string	Y	音频唯一标识，用于查询识别结果

示例

请求示例

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

{
    "audioCallback": "http://xxx",
    "audioType": "PORN",
    "data":{
        "channel": "VIDEOSTREAM",
        "returnAllImg": 1,
        "returnAllText": true,
        "room": "001",
        "tokenId": "1157893895",
        "url": "rtmp://xxxx"
    },
    "imgCallback":"http://xxxxxxxxx",
    "imgType": "DEFAULT"
}

返回示例

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

{
    "code":1100,
    "message":"成功",
    "entryrid":"5564f430ee6a1adb40f06d768b40316b",
}

回调示例（图像内容)

POST /xxxx HTTP/1.1
Host: xxxx
Content-Type: application/json

{
    "code":1100,
    "message":"成功",
    "entryId":"b891cf2d82e214de45df33fc2bea4875",
    "riskLevel":"REJECT",
    "contentType":1,
    "detail":{
        "descriptionV2":"正常",
        "imgText":"ocr123 你好",
        "imgTime":"2019-09-20 14:53:25",
        "imgUrl":"http://yyyyyyyyyyyyyyyyy.jpg",
        "matchedDetail":"[{"listId":"0b5d2ed695d40c0aa51e2b35fb51763d","matchedFiled":["text"],"name":"涉政测试","organization":"RlokQwRlVjUrTUlkIqOg","words":[" 你好"]}]",
        "matchedItem":"你好",
        "matchedList":"涉政测试",
        "model":"M02601",
        "polityName":"你好",
        "requestParams":{
            "channel":"VIDEOSTREAM",
            "returnAllImg":1,
            "returnAllText":true,
            "room":"001",
            "tokenId":"1157893895",
            "url":"rtmp://xxxxxxx"
        },
        "riskType":100,
        "room":"001"
    }
}

回调示例（音频内容)

POST /xxxx HTTP/1.1
Host: xxxx
Content-Type: application/json

{
    "code":1100,
    "message":"成功",
    "entryId":"b891cf2d82e214de45df33fc2bea4875",
    "riskLevel":"REJECT",
    "contentType":2,
    "detail":{
        "audioEndTime":"2019-09-20 15:27:35",
        "audioStartTime":"2019-09-20 15:27:25",
        "audioText":"老婆",
        "audioUrl":"http://xxxxxxxxxxx.mp3",
        "model":"M02101",
        "requestParams":{
            "channel":"VIDEOSTREAM",
            "returnAllImg":1,
            "returnAllText":true,
            "room":"001",
            "tokenId":"1157893895",
            "url":"rtmp://xxxxxxx"
        },
        "riskType":200,
        "room":"001"
    }
}

错误码

Code	Message
1100	成功
1901	QPS受限
1902	参数不合法
1903	服务失败
1911	下载超时
91xx	内部错误

数美视频流审核

功能描述

接口规格

提交视频流识别请求

请求参数

返回参数

异步回调识别结果

关闭视频流识别

请求参数

示例

请求示例

返回示例

回调示例（图像内容)

回调示例（音频内容)

错误码

本页内容

数美视频流审核

功能描述

接口规格

提交视频流识别请求

请求参数

返回参数

异步回调识别结果

关闭视频流识别

请求参数

示例

请求示例

返回示例

回调示例（图像内容)

回调示例（音频内容)

错误码

本页内容