短视频鉴黄服务（tupu-video）

描述

短视频鉴黄服务(tupu-video)能够帮您有效判断保存在七牛云的视频是属于色情、性感还是正常。

本服务由广州图普网络科技有限公司（以下简称图普科技）提供。启用服务后，您存储在七牛云空间的文件将在您主动请求的情况下被提供给图普科技以供其计算使用。七牛不能保证鉴别结果的正确性，请您自行评估后选择是否启用。服务价格请您参考具体的价格表及计费举例，您使用本服务产生的费用由七牛代收。启用服务则表示您知晓并同意以上内容。

如何开启

进入https://portal.qiniu.com/service/market, 找到短视频鉴黄服务点击开始使用。

请求

这里只介绍了实时请求的规格，但是考虑到如果鉴别10分钟以上的视频，转换时间会比较久，用http实时转换很容易出现超时，为达到更好的显示效果，需要使用异步处理。

请求报文格式

GET <VideoDownloadURI>?tupu-video/nrop/<Params> HTTP/1.1
Host: <VideoDownloadHost> 资源URL
Params: /f/<FrameNumber>  视频截图数量上限
        /s/<FrameRate>    截图频率（x秒/张）

注 同时指定<FrameNumber> 和 <FrameRate> 时，最终截图数量为：MIN(视频时长 / <FrameRate>, <FrameNumber>)

若未指定截图数量，则依照以下规则截图

视频时长（分钟）	默认截图数量（张）
< 1	10
[1, 2)	20
[2, 3)	30
[3, 4)	40
[4, 5)	50
[5, 6)	60
[6, 7)	70
[7, 8)	80
[8, 9)	90
>=9	100

注意：当您下载私有空间的资源时，VideoDownloadURI的生成方法请参考七牛的下载凭证。

示例： 资源为http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4，处理样式为tupu-video/nrop。

#构造下载URL
DownloadUrl = 'http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4?tupu-video/nrop'
……
#最后得到
RealDownloadUrl = 'http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4?tupu-video/nrop&e=×××&token=MY_ACCESS_KEY:×××'

请求头部

头部名称	必填	说明
Host	是	下载服务器域名，可为七牛三级域名或自定义二级域名，参考域名绑定

响应

响应报文格式

HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

{
    // ...tupu-video data...
}

响应头部

头部名称	必填	说明
Content-Type	是	MIME类型，固定为application/json
Cache-Control	是	缓存控制，固定为no-store，不缓存

响应内容

■ 如果请求成功，返回包含如下内容的JSON字符串（已格式化，便于阅读）：

{
    // 平均分反映一组图片的整体，示例这组图片：50.0%可能性是正常；25.53%可能性是色情；24.46%可能性是性感。
    avgScores: [
        {score: 0.5000619335640717, label: 2},   // "label:2 -> 正常"
        {score: 0.25529559658062695, label: 0},  // "label:0 -> 色情"
        {score: 0.24464247275246542, label: 1}], // "label:1 -> 性感"
 
    // 最高分反映的是某一分类图片出现时的最高分，max等于0说明没有判为该分类的图片
    // 主要用于对某一分类是否出现做监控判定，例如要监控是否是“色情视频”，那么就看：{max: n, label: 0}，
    // 假设n大于0，就说明这组视频截图出现了疑似色情图片（max越大，越确定），否则就是没有出现过色情图片
    maximums: [
        {max: 0.9999999220340654, label: 0},  // 判为色情的图片中，最高分是0.999999922，说明非常肯定出现了色情图片
        {max: 0.9999772906303406, label: 2},  // 判为正常的图片中，最高分是0.9999772906303406
        {max: 0.9784060716629028, label: 1}], // 判为性感的图片中，最高分是0.9784060716629028
 
    // 各分类出现图片数量的情况
    statistics: [
        {count: 2, label: 2},  // 判为正常的图片有2张
        {count: 1, label: 1},  // 判为性感的图片有1张
        {count: 1, label: 0}], // 判为色情的图片有1张
 
    // 最终整个视频被定性判为“色情”，因为出现了色情图片
    label: 0,
    // 对于上述label判定，是否需要人工review
    review: false,
    topN: 3,
 
    nonce: '0.809460110263899',
    timestamp: 1442636213,
    code: 0,
    message: 'success'
}

判定的最后结果在label、review两个字段中体现，想要更详细的分析，可以使用其他字段完成。视频鉴黄会在视频的每分钟选取10张截图来做鉴别。

■ 如果请求失败，请参考以上code和message字段的说明。

示例

在Web浏览器中输入以下视频地址：

http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4?tupu-video/nrop

指定截图数量上限为5张：

http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4?tupu-video/nrop/f/5

指定截图频率为10秒/张：

http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4?tupu-video/nrop/s/10

同时指定截图上限为5和截图频率为10秒/张：

http://78re52.com1.z0.glb.clouddn.com/resource/sintel_trailer.mp4?tupu-video/nrop/f/5/s/10

服务价格

0.01元/10张视频截图，单个视频最低收费0.01元

计费示例

请求一个5分10秒（310秒）的视频，按照默认截图规则（60张截图） 价格= 60 * 0.01/10 = 0.06(元)

若用户指定截图上限为5 张，则截图数不满10 价格= 0.01(元)

若用户指定截图上限为100 张，同时指定截图频率为10秒/张，则指定频率下最多只能截310(秒)/10(秒每张)=31(张) 则 价格＝31 * 0.01/10 = 0.04(元)