视频识别

最近更新时间:2020-07-22 19:39:04

内容安全视频识别API文档-离线视频

目录

调用方式

请求结构

服务地址

内容安全视频识别API的服务接入地址为:http://kir.api.ksyun.com

通信协议

支持通过HTTP或HTTPS协议进行请求通信。为保证您的服务安全性,请使用HTTPS协议进行通信。

请求方式

支持GET方法发送请求,注意参数需要进行urlencode。

公共参数

公共请求header

参数名 必选 类型 说明
Authorization string 必要的请求验证信息
X-Amz-Date string 当前请求的时间戳,例如:20171129T114852Z
Host string kir.api.ksyun.com

签名参数

Region:金山云机房信息,目前仅支持cn-beijing-6

Service:固定为kir

返回结果

接口统一返回json格式数据,满足以下格式:

{
    "header":{
      "err_no":200,
      "err_msg":"success"
    },
    "cost":0.11,
    "request_id": "d679e27b-9f1b-44bf-b134-49a6d9f0adff",
    "request_time": 1234567890123,
    "body":{}
}

调用成功,err_no返回200,msg为success,否则返回对应错误码及错误信息。

cost为服务端耗时,单位秒。

每此请求会返回唯一的请求表示request_id,调用失败时提供request_id给金山云客服,方便定位问题。

request_time为每次请求时的服务器时间

签名机制

详见金山云签名机制文档

离线视频识别接口

离线视频识别任务提交

GET参数部分

参数名 必选 类型 说明
Action=AnalyzeVideo string 固定此值
Version=2018-09-03 string API版本号,固定此值

POST请求示例:

{
    "video_id": "3d6e528b8a0710986e229cd525491259",
    "guard_id": "1548746633316469125",
    "video_url": "https://test.com/364.mp4",
    "callback": "https://www.test.com",
    "origin_name": "生活区第三批",
    "media_intro": "{\"title\":\"美丽海岸\",\"tag\":\"大连,VLOG\",\"content\":\"景区介绍\"}",
    "user_id": "12345678",
    "priority": 5
}

POST参数说明

参数 必选 类型 最大长度 说明
video_id string 100 视频id, 视频唯一标识
由字母、数字、下划线、中线任意组成,必须以字母或数字开头
guard_id string 64 送审计划id
video_url string 512 视频url
支持http(s)、ftp等协议
支持mp4、m3u8、ts、avi、mkv、flv、wmv、mov、rmvb等格式
callback string 1024 回调地址,视频处理结果通过此地址回传
origin_name string 64 来源名称,用于记录来源、批次等信息
media_intro string 1024 媒体介绍,JSON格式的字符串
user_id string 128 用户id
priority Int [0,10] 处理优先级,默认0,值越高越优先处理

送审计划id获取路径:金睛内容识别 > 送审管理模块 > 送审计划列表/送审计划详情 > 复制送审计划id

视频识别

详见金睛内容识别平台操作手册

接口返回:

{
    "request_id": "d679e27b-9f1b-44bf-b134-49a6d9f0adff",
    "request_time": 1536148409363,
    "cost": 0.02,
    "header": {
        "err_no": 200,
        "err_msg": "success"
    }
}

离线视频识别结果查询

GET参数部分

参数名 必选 类型 说明
Action= GetAnalyzeVideoResult string 固定此值
Version=2018-09-03 string API版本号,固定此值

POST请求示例:

{
    "video_id": "3d6e528b8a0710986e229cd525491259"
}

POST参数说明

参数 必选 类型 最大长度 说明
video_id string 100 视频id

接口返回:

{
    "request_id":"ff35f7a5-7b65-4aaf-a97f-cf63bec2218c",
    "request_time":1560240162393,
    "cost":0.24,
    "header":{
        "err_no":200,
        "err_msg":"success"
    },
    "body":{
        "video_id":"3d6e528b8a0710986e229cd525491259",
        "video_url":"http://test.com/test78116.mp4",
        "video_duration":229,
        "video_suggestion":"confirm_reject",
        "suggestSummaryCode":"350000",
        "suggestSummaryMessage":"视频图像政治敏感",
        "image_result":[
            {
                "business":"ad",
                "suggest":"confirm_reject",
                "detail":[
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/0.jpg",
                        "timestamp":0,
                        "labelId":"2",
                        "labelDesc":"水印",
                        "rate":"0.95"
                    },
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/1.jpg",
                        "timestamp":1,
                        "labelId":"2",
                        "labelDesc":"水印",
                        "rate":"0.93"
                    }
                ]
            },
            {
                "business":"terrorism",
                "suggest":"suggest_review",
                "detail":[
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/30.jpg",
                        "timestamp":30,
                        "labelId":"2",
                        "labelDesc":"暴恐",
                        "rate":"0.98",
                        "label2":"2",
                        "label2_desc":"国类军装",
                        "rate2":"0.96"
                    }
                ]
            },
            {
                "business":"ocr",
                "suggest":"confirm_reject",
                "detail":[
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/6.jpg",
                        "timestamp":6,
                        "labelId":"5",
                        "labelDesc":"涉政",
                        "rate":"0.96",
                        "keywords":[
                            {
                                "matched_item":"共军"
                            }
                        ]
                    }
                ]
            },
            {
                "business":"porn",
                "suggest":"confirm_reject",
                "detail":[
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/8.jpg",
                        "timestamp":8,
                        "labelId":"2",
                        "labelDesc":"低俗",
                        "rate":"0.98",
                        "label2":"30",
                        "label2_desc":"床上场景",
                        "rate2":"0.95"
                    },
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/9.jpg",
                        "timestamp":9,
                        "labelId":"2",
                        "labelDesc":"低俗",
                        "rate":"0.96",
                        "label2":"30",
                        "label2_desc":"床上场景",
                        "rate2":"0.96"
                    }
                ]
            },
            {
                "business":"politic",
                "suggest":"normal",
                "detail":[

                ]
            },
            {
                "business":"illegal",
                "suggest":"suggest_review",
                "detail":[
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/33.jpg",
                        "timestamp":33,
                        "labelId":"4",
                        "labelDesc":"ACG违规",
                        "rate":"0.99",
                        "label2":"13",
                        "label2_desc":"未成年",
                        "rate2":"0.98"
                    }
                ]
            },
            {
                "business":"sensitive",
                "suggest":"suggest_review",
                "detail":[
                    {
                        "imageUrl":"https://ks3-cn-beijing.ksyun.com/videodb/smarttag/2000074681/test08102/33.jpg",
                        "timestamp":33,
                        "labelId":"4",
                        "labelDesc":"涉政人物",
                        "rate":"0.97",
                        "label2":"21",
                        "label2_desc":"台独",
                        "rate2":"0.96",
                        "keywords":[
                            {
                                "matched_item":"白云"
                            }
                        ]
                    }
                ]
            }
        ],
        "audio_result":[
            {
                "business":"illegal",
                "suggest":"confirm_reject",
                "detail":[
                    {
                        "text":"共产党一定要把文革的真相告诉同学们。",
                        "label":"5",
                        "label_desc":"涉政",
                        "rate":"0.99",
                        "start_seconds":0,
                        "end_seconds":30,
                        "keywords":[
                            {
                                "matched_item":"共产党",
                                "matched_item":"文革"
                            }
                        ]
                    },
                    {
                        "text":"走资派,那些赤裸裸的反对毛主席。",
                        "label":"5",
                        "label_desc":"涉政",
                        "rate":"0.99",
                        "start_seconds":210,
                        "end_seconds":229,
                        "keywords":[
                            {
                                "matched_item":"毛主席"
                            }
                        ]
                    }
                ]
            },
            {
                "business":"porn",
                "suggest":"confirm_reject",
                "detail":[
                    {
                        "text":"",
                        "label":"2",
                        "label_desc":"色情",
                        "rate":"0.97",
                        "start_seconds":36,
                        "end_seconds":44
                    },
                    {
                        "text":"",
                        "label":"2",
                        "label_desc":"色情",
                        "rate":"0.98",
                        "start_seconds":40,
                        "end_seconds":48
                    },
                    {
                        "text":"",
                        "label":"2",
                        "label_desc":"色情",
                        "rate":"0.96",
                        "start_seconds":44,
                        "end_seconds":52
                    }
                ]
            }
        ]
    }
}

接口输出字段解释:

释:

字段 类型 是否必须 说明
video_id string 视频ID
Video_url string 视频URL
video_duration int 视频时长,单位秒
video_suggestion string 视频处理建议:
normal:通过
suggest_review:疑似
confirm_reject:拒绝
suggestSummaryCode string 识别建议原因编码
100000:正常
350000:视频图像政治敏感
234000:视频图像涉政
250000:视频图像涉黄
230000:视频图像涉暴
246000:视频OCR违规
238000:视频图像违规违法
242000:视频涉嫌推广
206000:视频音频违规
211000:视频音频涉黄
suggestSummaryMessage string 识别建议原因描述
business string 对应请求中的参数值
image_result中:
sensitive:图像政治敏感
politic:敏感人物图像识别
porn:色情图像识别
terrorism:暴恐图像识别
ocr:OCR图像识别
illegal:违规违法图像识别
ad:广告图像识别
audio_result中:
illegal:色情音频识别
porn:违规音频识别
suggest string 建议
normal:通过
suggest_review:疑似
confirm_reject:拒绝
image_result list 违规图片识别结果集
imageUrl string 图片地址
timestamp int 相对于视频起始位置的秒数
labelId string 分类标签ID(int类型)
sensitive:1-正常;2-涉政运动;3-涉政动漫;4-涉政人物;5-涉政违规
politic:1-非敏感人物;2-敏感人物;3-无人脸
porn:1-正常;2-低俗;3-色情
terrorism:1-正常;2-暴恐;3-血腥
ocr:1-正常,2-涉黄,3-广告,4-涉暴,5-涉政,6--辱骂,7-灌水
illegal:1-正常;2-违法;3-违规;4-ACG违规
ad:1-无广告;2-水印;3-二维码;4-条形码
labelDesc string 分类标签描述(string类型)
rate string 分类置信度 [0, 1.0],值越大置信度越高(double类型)
label2 string 二级标签
label2_desc string 二级标签描述
rate2 string 二级分类置信度 [0, 1.0],值越大置信度越高(double类型)
keywords list 命中关键字列表
matched_item string sensitive:图像政治敏感,对应命中face_name
politic:敏感人物图像识别,对应命中face_name
ocr:OCR图像识别,对应匹配文字
illegal:色情音频识别,对应匹配关键字
audio_result list 违规音频段识别结果集
label string 分类标签ID(int类型)
illegal:1-正常,2-涉黄,3-广告,4-涉暴,5-涉政,6--辱骂,7-灌水 porn:1-正常;2-娇喘
label_desc string 分类标签描述(string类型)
text string 音频识别出的文字
start_seconds int 音频结果开始秒数
end_seconds int 音频结果结束秒数

直播流识别接口

输入:

GET参数部分

参数名 必选 类型 说明
Action=AnalyzeVideoStream string 固定此值
Version= 2019-07-03 string API版本号,固定此值

POST请求示例

{
    "guard_id":"125211231231", 
    "stream_url":"http://xxx.com/xx.flv",
    "stream_id":"xaaw123",
    "callback_url":"http://xxxxx/xxxcallback"
}

POST参数说明

参数 必选 类型 说明
guard_id string 送审计划id
stream_url string 直播流url
stream_id string 直播流id
callback_url string 回调url

送审计划id获取路径:金睛内容识别 > 送审管理模块 > 送审计划列表/送审计划详情 > 复制送审计划id

视频识别

详见金睛内容识别平台操作手册

接口返回:

{
    "header":{
      "err_no":200,
      "err_msg":"success"
    },
    "cost":0.11,
    "request_id": "d679e27b-9f1b-44bf-b134-49a6d9f0adff",
    "request_time": 1234567890123,
    "body":{}
}

违规直播流抽帧的图片回调结构:

{
    "data_id": "31a43e1d08ee1023c2daa99c9d159628",
    "guard_id": "1559203003873916078",
    "image_url": "http://ks3-cn-beijing.ksyun.com/videodb/31a43e1d08ee1023c2daa99c9d159628.jpg",
    "results": [{
        "business": "illegal",
        "label": "1",
        "label_desc": "正常",
        "rate": 0.929911196231842,
        "suggest": "normal"
    }, {
        "business": "ad",
        "label": "2",
        "label_desc": "水印",
        "label_details": [{
            "rate": 0.9767667055130005,
            "type": "watermark"
        }],
        "rate": 0.9767667055130005,
        "suggest": "confirm_reject"
    }, {
        "business": "ocr",
        "label": "1",
        "label_desc": "正常",
        "label_details": {
            "text_filter": {
                "conclusion": "正常",
                "risk_type": "正常"
            },
            "word_list": ["15635", "#精##特r1、1物1#,精#", "##的B#.n、##人#,1#", "#43((0)#。人##歌分", "L##.10.3###,#0", "队福持你榜#####看0#的#", "、#.a有MB银#", "##4#####速###),####,", "加#技有#,间有机50t", "#毒级##自#春####", "a##行###,####人#数了#[#。", "3d/.00r", "###位aa#t4", "2:人", "本丸B#8", "####民", "#:我#播使##后#########人", "####人6##", "言#:2给.2"]
        },
        "rate": 0.99,
        "suggest": "normal"
    }, {
        "business": "terrorism",
        "label": "1",
        "label_desc": "正常",
        "rate": 0.8627758026123047,
        "suggest": "normal"
    }, {
        "business": "politic",
        "label": "3",
        "label_desc": "无人脸",
        "rate": 0.99,
        "suggest": "normal"
    }, {
        "business": "porn",
        "label": "1",
        "label_desc": "正常",
        "rate": 0.9583984375,
        "suggest": "normal"
    }],
    "stream_id": "1234452231122345-23333",
    "suggest_summary": "confirm_reject",
    "suggest_summary_code": "244000",
    "suggest_summary_message": "直播涉嫌推广"
}

违规直播流抽帧的音频回调结构:

{
    "body": {
        "data_id": "4a75a3be104ec296058047941c261a21",
        "audio_url": "https://ks3-cn-beijing.ksyun.com/airesearch/datasets/test_mp3_20190311/lover_30s.mp3",
        "suggest_summary": "confirm_reject",
        "suggest_summary_code": "210000",
        "suggest_summary_message": "直播音频违规",
        "stream_id": "1111111",
        "start_time":1556266149000,
        "end_time":15562661491000,
        "results": [
            {
                "business": "illegal",
                "text": "XXXXXXXXXXXXXXXXXX",
                "label": "5",
                "label_desc": "涉政",
                "label_details": [
                    {
                        "word": "XXX"
                    },
                    {
                        "word": "XX"
                    }
                ],
                "suggest": "confirm_reject"
            },
            {
                "business": "porn",
                "label": "2",
                "label_desc": "娇喘",
                "label_details": [
                    {
                        "start_time": 1556266149000,
                        "end_time": 1556266149000
                    },
                    {
                        "start_time": 155626614900,
                        "end_time": 1556266149000
                    }
                ],
                "rate":0.99,
                "suggest": "confirm_reject"
            }
        ]
    },
    "header": {
        "err_no": 200,
        "err_msg": "success"
    },
    "request_id": "7e106d4a-25f1-4a9a-98fc-ba9b9a4fd74d",
    "request_time":"1557906136463"
}

违规直播流回调期望返回:

{
    "code":0
}

回调字段说明

字段 类型 是否必须 说明
body.data_id string 视频段唯一id
body.image_url string 直播流抽帧的图片url
body.audio_url string 视频抽帧的音频url
body.suggest_summary string confirm_reject:拒绝;
suggest_review:疑似;
normal:通过
body.suggest_summary_code string 236000:直播图像涉政;
205000:直播图像涉黄;
232000:直播图像涉暴;
294000:直播图像OCR违规;
240000:直播图像违规违法;
244000:直播涉嫌推广;
210000:直播音频违规;
215000:直播音频涉黄;
100000:正常
body.suggest_summary_message string 236000:直播图像涉政;
205000:直播图像涉黄;
232000:直播图像涉暴;
294000:直播图像OCR违规;
240000:直播图像违规违法;
244000:直播涉嫌推广;
210000:直播音频违规;
215000:直播音频涉黄;
100000:正常
labelId int 直播视频图片
porn: 1正常;2低俗;3色情
terrorism: 1正常;2暴恐;3血腥
politic: 1非敏感人物;2敏感人物;3无人脸
ocr:1正常,2涉黄,3广告,4涉暴,5涉政,6辱骂,7灌水,0其他
illegal: 1正常;2违法;3违规;4ACG违规
ad:1无广告;2水印;3二维码;4条形码
直播视频音频
porn: 1正常,2娇喘
illegal: 1正常,2涉黄,3广告,4涉暴,5涉政,6辱骂,7灌水,0其他
body.stream_id string 直播流id
body.start_time long 直播流段开始时间单位毫秒

错误码说明

调用接口失败时,返回的HTTP消息体将中包含具体的错误信息,下表为错误码的具体说明,找不到错误原因时,可以联系我们,并提供Response中的request_id/video_id,以便尽快解决问题。

其他说明

接口regionId仅支持cn-beijing-6;

业务层级错误码

err_msg err_no 说明
下载失败 -10 视频下载失败/连接超时
获取媒体信息失败 -20 获取视频时长等信息失败
图片抽帧失败 -30 视频抽取图片失败
音频抽取失败 -40 视频抽取音频失败
调用图片服务失败 -50 调用图片识别服务失败
调用音频服务失败 -60 调用音频识别服务失败
媒体汇总失败 -70 视频汇总决策审核信息失败
媒体审核失败 -80 视频审核策略失败
媒体处理失败 -5 视频处理过程中出现异常
请传入必须参数 410 按照接口文档传入必须参数
媒体ID已经存在 411 视频ID是全局唯一标识
参数媒体ID不合法 412 视频ID必须由字母、数字、下划线、中线任意组成,必须以字母或数字开头
参数媒体ID长度不能大于100字节 413 参数视频ID长度不能大于100字节
参数媒体URL长度不能大于512字节 414 参数视频URL长度不能大于512字节
参数回调地址长度不能大于1024字节 415 参数回调地址长度不能大于1024字节
参数来源名称长度不能大于64字节 416 参数来源名称长度不能大于64字节
参数媒体介绍长度不能大于1024字节 417 参数媒体介绍长度不能大于1024字节
参数用户ID长度不能大于128字节 418 参数用户ID长度不能大于128字节
参数媒体URL格式有误 419 参数视频URL格式有误,支持http(s)、ftp等协议
系统异常 500 服务内部错误
媒体记录不存在 504 查询视频记录不存在
媒体检测中,请稍后 505 视频正在检测/排队中
送审计划有误 1001 送审计划有误
账号未开通服务 1003 账号未开通服务
查询数据已过期 1010 查询数据已过期

金山云,开启您的云计算之旅

免费注册