视频直播任务创建

一、接口描述

1. 功能描述

针对直播场景,对视频画面、音频、文字进行内容分析与审核,实现对直播场景内容的安全性及合规性的审核,可有效辅助人工全方位把控风险,减少违法违规不良信息的出现。

2. 接口数据要求:

3. 接口使用:

平台为每个API提供试用体验服务,您在AI市场选择“免费试用”规格下单后,即可开始体验业内领先的人工智能API服务。 免费试用服务具有调用量、QPS限制,如需更高性能的API服务,可以提交咨询工单,联系京东AI扩容购买。

在获得使用权限后,您可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程

二、请求说明

1. 接口地址 :

https://aiapi.jd.com/jdai/censor/live_create

2. 请求方式:

 post

3. 请求参数

(1)query请求参数

公共请求参数

名称 类型 必填 示例值 描述
appkey String 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获取
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign String 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)

(2)header请求参数

业务请求参数

名称 类型 必填 示例值 描述
Content-Type String application/json 请求头格式

(3)body请求参数

视频直播流程

由于直播视频时间较长,数据较多,故而采用异步任务的方式进行准实时审核。

  1. 创建视频直播任务(该接口),提供直播开始时间和审核结果callback接收地址,接口返回task_id。
  2. 直播开始后,审核任务同步开始,从大约每秒数据中抽取一帧数据进行综合审核,该帧的审核结果完成后,会将结果同步推送至callback接收地址。
  3. 直播结束时,需要发送停止信息至直播停止接口,审核任务将退出,不再推送结果。

业务请求参数

名称 类型 必填 示例值 描述
live_url String 'http://a.com/b.jpg' 直播拉流地址,支持rtmp,m3u8格式。
scenes Array ['porn', 'terror', 'text'...] 选择需要审核的算法场景,至少选择一个。
callback_url String 'http://yourdomain.com/receive_url' 接收审核结果的callback地址,请求方式为post。

scenes入参说明

字段 说明
porn 鉴黄
terror 暴恐
politics 涉政人物
prohibitions 违禁品
ads 广告
text 文本审核

4、请求代码示例

建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的3接口使用

三、返回说明

1、返回参数

(1)公共返回参数

名称 类型 示例值 描述
code string 1000 参见下方错误码-系统级错误码
charge boolean false 或 true false:不扣费, true:扣费
remainTimes long 1305 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1
remainSeconds long 1223456 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1
msg string 查询成功 参见下方错误码-系统级错误码
result object {...} 查询结果

(2)业务返回参数

result参数信息

字段 类型 说明
status Int 创建任务状态 200: 成功,非200为失败
message String 对状态码的信息描述
taskId String 任务ID号

2、返回示例

{
      "status": 200,
    "message": "success",
    "taskId": "fb1e065c4c40619"
}

3、审核结果推送格式

字段名 类型 释义 范例值
taskId String 任务ID号 "fb1e065c4c40619"
requestId String 请求ID "c5721b2b7cdb488fafb1e065c4c40619"
status Int 状态码 200为正常
message String 对状态码的具体描述 "success"
url String 抽取的图片url http://jdcloud.com/6494a1d1e06b1183.jpg
result Map 审核结果,根据选择的scenes,进行结果返回。错误情况下,无此字段。
+porn Map 以鉴黄举例
++riskLevel Int 风险等级,0:正常,1:低风险,2:高风险 0
++suggestion String pass:结果正常,无需进行其余操作。review:低风险,建议进行人工审核。block:结果违规,建议直接删除或者限制公开。 pass
++data Array 返回多个分类下的筛选结果
+++mainType int 一级类别 1
+++mainTypeKey String 一级类别英文名称 sexy
+++mainTypeName string 一级类别名称 涉黄
+++subType int 二级类别 105
+++subTypeKey String 二级类别英文名称 cartoon_porn
+++subTypeName string 二级类别名称 卡通涉黄
+++content string 检测出来的对应信息内容 习大大
+++score Float64 置信度, 取值范围 [0,1],分数越高可能性越大 0.95
+++location Int Array 检测框坐标,顶点宽高 [x,y,width,height]。部分算法此字段无结果,可默认为空。 [412,217,62,73]
+politics Map 敏感人物场景结果。 同鉴黄方式结果。
+terror Map 暴恐场景结果。同鉴黄方式结果。
+prohibitions Map 违禁品场景结果。同鉴黄方式结果。
+ads Map 广告场景结果。同鉴黄方式结果。
+text Map 文本场景结果
++filterText String 若有敏感词,返回替换敏感词后的文本 "政治正确"
++riskLevel Int 风险等级,0:正常,1:低风险,2:高风险 1
++suggestion String pass:结果正常,无需进行其余操作。review:低风险,建议进行人工审核。block:结果违规,建议直接删除或者限制公开。 pass
++data Map 文本具体算法场景对应的结果 ""
+++porn Map 鉴黄算法场景
++++label Int 状态,0:正常,1:低风险,2:高风险 1
++++sensitiveWords String Array 命中的所有敏感词 ["你很黄"]
++++score Float64 违规的置信度 0.95

3.1 鉴黄labels

一级类别 一级类别中文名 一级类别英文名 二级类别 二级类别中文名 二级类别英文名
1 涉黄 porn 101 女胸 f_breasts
1 涉黄 porn 102 女下体 f_pussy
1 涉黄 porn 103 男下体 penis
1 涉黄 porn 104 臀部 ass
1 涉黄 porn 105 卡通色情 cartoon_porn
1 涉黄 porn 106 其他色情 other_porn
2 低俗 vulgar 201 臀部低俗 hip
2 低俗 vulgar 202 裆部低俗 crotch
2 低俗 vulgar 203 胸部低俗 f_exposed
2 低俗 vulgar 204 高仿真情趣用品 sex_toy_organs
2 低俗 vulgar 205 喂奶 breast_feeding
2 低俗 vulgar 206 其他低俗 other_vulgar
3 性感 sexy 301 女性普通内衣 f_underwear
3 性感 sexy 302 女性性感 f_sexy
3 性感 sexy 303 男性内衣 m_sexy
3 性感 sexy 304 亲吻 kiss
3 性感 sexy 305 其他性感 sexy
4 普通 normal 401 普通 normal
4 普通 normal 402 普通情趣用品 artwork

3.2 敏感人物labels

一级类别 一级类别中文名 一级类别英文名 二级类别 二级类别中文名 二级类别英文名
1 涉政 politics 101 在任领导人 incumbent_leaders
1 涉政 politics 102 往届领导人 past_leaders
1 涉政 politics 103 省市区领导人 provincial_and_municipal_leaders
1 涉政 politics 104 香港官员 HK_officials
1 涉政 politics 105 民族、英烈、爱国人士 nationality_heroes_and_patriots
1 涉政 politics 106 敏感领导人 sensitive_leaders
1 涉政 politics 107 落马官员 dismissed_officials
1 涉政 politics 108 反动人物 reactionary_figures
1 涉政 politics 109 国外政要 foreign_politicians
2 六四反动 6-4_reactionary_group 201 六四民运分子 6-4_reactionary_group
3 分裂组织 separatist_group 301 港独 HK_independence
3 分裂组织 separatist_group 302 藏独 Tibetan_independence
3 分裂组织 separatist_group 303 疆独 Xinjiang_independence
3 分裂组织 separatist_group 304 蒙独 Mongolian_independence
3 分裂组织 separatist_group 305 台独 Taiwan_independence
3 分裂组织 separatist_group 306 沪独 Shanghai_independence
4 邪教组织 cult_group 401 国内邪教 domestic_cult_group
4 邪教组织 cult_group 402 国外邪教 foreign_cults_group
5 反动媒体 reactionary_media 501 反动媒体 reactionary_media
6 暴恐组织 terrorist 601 恐怖组织 terrorist_group
6 暴恐组织 terrorist 602 独裁 dictator
7 明星网红 star 701 劣迹明星网红 stat_with_problems
7 明星网红 star 702 体育明星 athletic_star
7 明星网红 star 703 艺人 actor
8 科学家学者 scientist 801 科学家学者 scientist
9 其他 other 901 正面人物 decent_personage
9 其他 other 902 反面人物 villain
10 白名单 whitelist 1001 白名单人物 whitelist

3.3 暴恐labels

一级类别 一级类别中文名 一级类别英文名 二级类别 二级类别中文名 二级类别英文名
1 暴乱 riot 101 游行示威 demonstration
1 暴乱 riot 102 聚众 crowd
1 暴乱 riot 103 群众暴乱 rioters
1 暴乱 riot 104 民警冲突 conflict
2 武装部队 forces 201 警察部队 police_force
2 武装部队 forces 202 武装人员 armed_people
3 爆炸火光 flame 301 真实爆炸火光 flame_real
3 爆炸火光 flame 302 艺术火 flame_art
3 爆炸火光 flame 303 烟花 fireworks
4 血腥 bloodiness 401 人体皮肤血腥 bloodiness_skin
4 血腥 bloodiness 402 人体尸体含血 bloodiness_corpse
4 血腥 bloodiness 403 人体尸体不含血 bloodiness_corpse_no
4 血腥 bloodiness 404 动物血腥 bloodiness_animal
4 血腥 bloodiness 405 动物尸体 bloodiness_carcass
4 血腥 bloodiness 406 服饰血迹 bloodiness_clothes
4 血腥 bloodiness 407 场景血迹 bloodiness_bloodstain
4 血腥 bloodiness 408 卡通血腥 bloodiness_carton
4 血腥 bloodiness 409 游戏场景 bloodiness_games
5 武器弹药 weapon 501 子弹特写 bullet
5 武器弹药 weapon 502 装甲车 tank
5 武器弹药 weapon 504 飞机 airplane
5 武器弹药 weapon 505 战舰 warship
6 纹身 tattoo 601 皮肤纹身特写 tattoo_skin

3.4 违禁品labels

一级类别 一级类别中文名 一级类别英文名 二级类别 二级类别中文名 二级类别英文名
1 刀具 knife 101 静置刀具 static_knife
1 刀具 knife 102 手持刀具 knife_in_hand
2 枪支 gun 201 静置枪支 static_gun
2 枪支 gun 202 手持枪支 gun_in_hand
3 吸烟 smoking 301 吸烟动作 smoking
4 喝酒 drinking 401 喝酒动作 drinking

3.5 广告labels

一级类别 一级类别中文名 一级类别英文名 二级类别 二级类别中文名 二级类别英文名称
1 条码类 code 101 二维码 qr_code
1 条码类 code 102 条形码 bar_code
1 条码类 code 103 小程序码 mini_prog_code
2 logo logo 201 品牌logo brand_logo
3 广告 advertisement 301 广告词 advertising_words
3 广告 advertisement 302 联系方式 contact

3.6 文本分类

一级类别 一级类别中文名 一级类别英文名
1 鉴黄 porn
2 涉政 politics
3 暴恐 terror
4 辱骂 abuse
5 广告 ads
6 违法违规 illegal
7 灌水 unuse

四、错误码

1.系统级错误码

详见返回码

2.业务错误码

status状态码

错误号 错误信息 说明
200 success 成功
400 Bad request 参数缺失或创建任务失败或不合法的json入参
500 Internal error 内部错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""