视频直播任务创建
一、接口描述
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) |
业务请求参数
名称 |
类型 |
必填 |
示例值 |
描述 |
Content-Type |
String |
是 |
application/json |
请求头格式 |
(3)body请求参数
视频直播流程
由于直播视频时间较长,数据较多,故而采用异步任务的方式进行准实时审核。
- 创建视频直播任务(该接口),提供直播开始时间和审核结果callback接收地址,接口返回task_id。
- 直播开始后,审核任务同步开始,从大约每秒数据中抽取一帧数据进行综合审核,该帧的审核结果完成后,会将结果同步推送至callback接收地址。
- 直播结束时,需要发送停止信息至直播停止接口,审核任务将退出,不再推送结果。
业务请求参数
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 |
内部错误 |