异步单张请求#

用于异步上传单张图片并进行检测,通过查询接口查询图片审核结果。可协助您识别图片中的涉政、色情、广告、暴恐等风险;同时可结合您的业务场景,识别人脸、LOGO、动植物等内容。

接口说明#

单张检测接口,调用审核后,可通过查询的方式得到审核结果。

接口要求#

通信协议:http或https协议 请求方法:POST方法 字符编码:utf-8 参数格式:所有请求参数和返回参数都是采用json格式

图片要求#

图片类型:URL、BASE64 图片格式:jpg,jpeg,png,webp,gif,tiff,tif,heif 图片像素:建议图片像素不小于`256*256`,目前支持`20*20`~`6000*6000`范围的分辨率图片 图片大小:图片大小限制30M。 截帧说明:长图默认不切分,开通可联系数美,计费会增多。gif图按照传入参数决定切分张数

审核时间#

建议超时时间:5秒。 内部检测逻辑:图片检测接口的响应时间依赖图片的下载时间,请保证被检测图片所在的存储服务稳定可靠。数美下载图片时的连接超时时间是2秒,读取超时时间是3秒(如失败会重试一次)。批量图片服务内部分两次并行处理,内部平均处理时间在500毫秒左右,具体时长和请求type、图片大小相关。

历史版本#

历史版本

请求#

请求地址#

集群请求地址支持产品列表
北京图像集群http://api-img-bj.fengkongcloud.com/v4/saas/async/img中文图片
上海图像集群http://api-img-sh.fengkongcloud.com/v4/saas/async/img中文图片

请求参数#

参数名称类型是否必传最大长度参数说明
accessKeystring20公司密钥。用于权限认证,开通服务时由数美提供
eventIdstring64事件标识。需要与数美约定好取值。
appIdstring64应用标识。此字段强校验,需要提前与数美约定好取值。
typestring64需要识别的风险类型。type与businessType至少传一个, 可选值: POLITY :涉政识别 EROTIC :色情&性感违规识别 VIOLENT :暴恐&违禁识别 QRCODE :二维码识别 ADVERT :广告识别 IMGTEXTRISK :图片文字违规识别(如需要识别图片里文字的违规内容,务必传入图片文字违规识别功能) 如果需要识别多个功能,通过下划线连接,如 POLITY_QRCODE_ADVERT 用于涉政、二维码和广告组合识别
businessTypestring128需要识别的业务类型。businessType与type至少传一个,可选值见业务标签类型
dataobject-请求的数据内容
imgstring1024要检测的图片,可使用图片的base64编码或者图片的url链接
tokenIdstring64用户账号标识。建议传入用户ID,可用于灌水、广告等行为维度的风险识别。
dataIdstring64客户自定义数据Id。可以用于数美saas后台检索
deviceIdstring128数美设备指纹标识。由数美SDK生成,用于用户行为分析。
imgCompareBasestring1024要检测比对的基准图片。请求参数businessType字段包含标签`FACECOMPARE`时存在 可使用base64编码的图片数据或者图片的url链接 支持格式: jpg,jpeg,png,webp,gif,tiff,tif,heif 建议图片像素不小于256*256,图片大小最大10MB 基准图暂时不支持长图和动图格式
intervalint32-动图截帧频率。动图检测专用,默认值为1。每interval张图片抽取一张进行检测。 当interval*maxFrame小于该图片所包含的图片数量时,截帧间隔会自动修改为该图片所包含的图片数/maxFrame,以提高整体检测效果。
ipstring64客户端公网IP地址。该参数用于IP维度的用户行为分析。
langstring-语言类型。当type中包含`IMGTEXTRISK`时,可指定对应检测语种类型(默认为中文),可选值:: zh:中文 en:英文 ar:阿拉伯语
maxFrameint32-动图的最大截帧数量。截取gif等动图帧数,最大为20帧,默认为3帧,计费按照实际截帧数量计费,如默认为截取3帧时按照3帧进行计费
receiveTokenIdstring64消息接收者的tokenId 由数字、字母、下划线、短杠组成的长度小于等于64位的字符串
extraobject-辅助参数。用于辅助检测的相关信息
isIgnoreTlsboolean-辅助参数,来控制是否要忽略ca证书的验证 可选值(默认为false): true:忽略证书信任 false:校验证书
roomstring64直播间/游戏房间编号,可针对单个房间制定不同的策略
passThroughobject1024客户传入透传字段。数美内部不会对该字段进行识别处理,随结果返回给用户。

响应#

返回参数#

参数名称类型是否必返参数说明
requestIdstring数美请求唯一标识
messagestring和code对应: 1100:成功 1901:QPS超限 1902:参数不合法 1903:服务失败 1911:图片下载失败 9101:无权限操作
codeint321100:成功 1901:QPS超限 1902:参数不合法 1903:服务失败 1911:图片下载失败 9101:无权限操作

示例#

请求示例#

{
"accessKey": "xxxx",
"appId": "default",
"data": {
"img": "xxxx",
"tokenId": "username123"
},
"eventId": "xxxx",
"type": "xxxx"
}

返回示例#

{
"code": 1100,
"message": "成功",
"requestId": "9l25odfa5280c50f49f7c40988a1e400"
}

附录#

业务标签类型#

业务标签识别类型类型说明备注
AGE人脸-年龄可识别未成年人
GENDER人脸-性别
BEAUTY人脸-颜值
RACE人脸-人种如黑种人、白种人、黄种人
FACEDETECTION人脸-人脸检测如识别无人脸、真人、口罩人脸、正脸、侧脸等
FAKEFACE人脸-伪造人脸
FACECOMPARE人脸-人脸对比
PUBLICFIGURE人物-公众人物如识别知名明星、网红等
TAINTEDSTAR人物-劣迹人物
POSTURE人像-人像姿态如识别坐姿、跪姿等
DRESS人像-人像穿着如识别jk、汉服等
TEMPERAMENT人像-人像气质如成熟大叔、靓丽女神等
BODY人体如识别头发、眼睛、鼻子等
PICTUREFORM画面属性-画面类型如识别动漫、表情包等
PICTURESTRUCT画面属性-画面结构如识别宫格图、桥段图等
LOWVISION画面属性-画面低质如识别模糊、涂抹、马赛克等
LOWCONTNET画面属性-内容低质如识别点线密集、虫类密集等
LIVEPICTURE画面属性-直播画面如识别床上直播、开车直播等
SCREENSHOT画面属性-APP截图(内容搬运)如识别朋友圈截图、聊天截图等
FITNESS场景主题-健身
CATE场景主题-美食
MUSIC场景主题-音乐
SPORTS场景主题-体育
SCENERY场景主题-自然风光如识别天空、大海、草原等
CITYVIEW场景主题-城市风光如识别街景
3CPRODUCTSLOGOLOGO-3C电子类品牌如识别华为、小米、OPPO等LOGO
SHOPPINGAPPSLOGOLOGO-购物比价类应用如识别拼多多等LOGO
RETOUCHAPPSLOGOLOGO-拍摄美化类应用如识别快剪辑、秒拍等LOGO
SOCIALAPPSLOGOLOGO-社交通讯类应用如识别微博、小红书等LOGO
PHOTOMATERIALLOGOLOGO-素材版权类应用如识别CFP等LOGO
NEWSAPPSLOGOLOGO-新闻阅读类应用如识别新浪、视觉中国等LOGO
ENTERTAINMENTAPPSLOGOLOGO-影音娱乐类应用如识别抖音、快手等LOGO
SPORTSLOGOLOGO-体育赛事如识别奥运会等LOGO
APPARELLOGOLOGO-鞋帽服饰类品牌如识别VANS、H&M等LOGO
ACCESSORIESLOGOLOGO-饰品首饰类品牌如识别AudemarsPiguet、Nomos等LOGO
COSMETICSLOGOLOGO-化妆品类品牌如识别LOTTE、EyesLipsFace等LOGO
FOODLOGOLOGO-食品类品牌如识别Starbucks、LOTTE等LOGO
AUTOTRADEAPPSLOGOLOGO-汽车交易平台类如识别懂车帝、易车、太平洋汽车、爱卡等LOGO
VEHICLE物品-交通工具
BUILDING物品-建筑
TABLEWARE物品-餐具
FOOD物品-食物
HOMEAPPLICATION物品-家用电器
OFFICESUPPLIES物品-办公用品
FASHION物品-穿着用品
SPORTEQUIPMENT物品-运动器材
TOY物品-玩具
MAKEUP物品-化妆品
DRUGS物品-药品
PAINTING物品-绘画作品
ELECTRONIC物品-电子产品
MEDICALIMAGE物品-医疗影像
FURNITURE物品-家居用品
DAILYSUPPLIES物品-生活用品
CONSTELLATION物品-星座占卜
KITCHENWARE物品-厨房用品
KEEPSAKE物品-纪念品
MAMMAL动物-哺乳动物
BIRDS动物-鸟类
REPTILE动物-爬行动物
FISH动物-鱼
ARTHROPOD动物-节肢动物
COELENTERATE动物-腔肠动物
MOLLUSKS动物-软体动物
CRUSTACEAN动物-甲壳动物
PLANT植物
SETTING场所如识别卫生间、酒店、厨房等
EXTREMEWEATHER极端天气识别如水灾、暴雨、沙尘暴、冰等
LICENCEPLATE车牌识别

在线咨询