查询接口#

查询图片审核结果

查询说明#

用于客户主动查询图片识别结果,支持近十五天结果的查询。

接口要求#

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

审核时间#

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

历史版本#

历史版本

请求#

请求地址#

集群请求地址支持产品列表
北京集群http://api-img-active-query.fengkongcloud.com/v4/image/query中文图片

请求参数#

参数名称类型是否必传最大长度参数说明
accessKeystring20公司密钥。用于权限认证,开通服务时由数美提供
requestIdsarray-查询列表,最多支持10个流水号
requestIdstring32查询的requestId
btIdstring30如果存在btId,则返回requestId+btId的批量查询中的单张结果;如果不存在btId,则分为两种情况: 第一种情况,返回单张请求的结果; 第二种情况,模糊匹配返回批量请求的结果

响应#

返回参数#

以下参数,除code、message、contents,和contents下面的code,message,requestId以外,其他必返参数均为在三个code返回1100时为必返。

参数名称类型是否必返参数说明
messagestring和code对应: 1100:成功 1901:QPS超限 1902:参数不合法 1903:服务失败 9101:无权限操作
codeint321100:成功 1901:QPS超限 1902:参数不合法 1903:服务失败 9101:无权限操作
contentsarray查询结果
codeint321100:成功 1102:正在处理 1910:失败 1912:处理超时(默认24h)
messagestring1100:成功 1102:正在处理 1910:失败 1912:处理超时(默认24h)
requestIdstring数美请求唯一标识
btIdstring客户侧请求唯一标识
Resultobject下面必返参数均为在result下面的code返回1100时为必返。
codeint321100:成功 1903:服务失败 1911:图片下载失败
finalResultint32是否为最终审核结果(如仅接入机审,则默认返回1)。 0:非最终结果。说明该结果为数美风控的机审结果,还需要经过数美人审再次审核后回传贵司。 1:最终结果。贵司可直接拿返回结果进行处置、分发等下游场景的使用。
messagestring1100:成功 1903:服务失败 1911:图片下载失败
requestIdstring数美请求唯一标识
resultTypeint32当前结果类型 0:机审 1:人审
riskDescriptionstring当riskLevel为PASS时返回正常; 其他情况展现形式为:"一级标签:二级标签:三级标签"的中文名 仅供人了解风险原因时作为参考,程序请勿依赖该参数的值做逻辑处理
riskLabel1string一级风险标签,当riskLevel为PASS时返回normal
riskLabel2string二级风险标签,当riskLevel为PASS时为空
riskLabel3string三级风险标签, 当riskLevel为PASS时为空
riskLevelstring识别结果,可能返回值: PASS:正常,建议直接放行 REVIEW:可疑,建议人工审核 REJECT:违规,建议直接拦截
allLabelsarray全部的风险标签列表
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
riskDescriptionstring当riskLevel为PASS时返回正常; 其他情况展现形式为:"一级标签:二级标签:三级标签"的中文名 仅供人了解风险原因时作为参考,程序请勿依赖该参数的值做逻辑处理
riskLabel1string一级风险标签
riskLabel2string二级风险标签
riskLabel3string三级风险标签
riskLevelstring识别结果,可能返回值: PASS:正常,建议直接放行 REVIEW:可疑,建议人工审核 REJECT:违规,建议直接拦截
riskDetailobject风险详情信息
riskSourceint32风险来源,可能取值: 1000:无风险 1001:文字风险 1002:视觉图片风险
face_numint32人脸数量
person_numint32人像数量
facesarray图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
face_ratiofloat人脸占比,在区间0-1,数值越大,人脸占比越高
idstring编号,图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次,分配n个ID
namestring人物名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人物位置信息,该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objectsarray物品信息。返回图片中标识或物品的名称及位置信息
idstring物品或标识编号,保证同一个位置下的物品在不同标签下的编号相同
namestring物品名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
qrContentstring返回图片中识别的二维码地址
locationarray物品位置信息 该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
ocrTextobject返回图片中文字识别内容,当请求参数type字段包含IMGTEXTRISK或ADVERT时存在
textstring图片中识别出的文字
matchedListsarray命中的客户自定义名单信息 仅在命中客户自定义名单时返回
namestring命中的名单名称
wordsarray命中的这个名单中的敏感词信息
wordstring命中的敏感词
positionarray敏感词所在位置
riskSegmentsarray高风险片段内容。检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在
segmentstring辅助信息 高风险内容片段
positionarray高风险内容片段所在位置 下标从0开始计数
personsarray图片中人物的名称及位置信息。当命中'人像-多人'标签时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
idstring编号,保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次,分配n个ID
person_ratiofloat人像占比。在区间0-1,数值越大,人脸占比越高
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人像位置坐标
auxInfoobject辅助信息
segmentsint32实际处理的片段数量
typeVersionobject传入的type值所对应的模型版本号
ADVERTstring广告版本号。组成形式为`X.Y`,其中`X`代表主版本号,通常表示模型整体的效果迭代;`Y`代表子版本号,通常表示日常的例行迭代。例如,`1001001.2`代表主版本号为`1001001`,子版本号为`2`。
EROTICstring色情版本号。组成形式为`X.Y`,其中`X`代表主版本号,通常表示模型整体的效果迭代;`Y`代表子版本号,通常表示日常的例行迭代。例如,`1001001.2`代表主版本号为`1001001`,子版本号为`2`。
IMGTEXTRISKstring违规文字版本号。组成形式为`X.Y`,其中`X`代表主版本号,通常表示模型整体的效果迭代;`Y`代表子版本号,通常表示日常的例行迭代。例如,`1001001.2`代表主版本号为`1001001`,子版本号为`2`。
POLITYstring涉政版本号。组成形式为`X.Y`,其中`X`代表主版本号,通常表示模型整体的效果迭代;`Y`代表子版本号,通常表示日常的例行迭代。例如,`1001001.2`代表主版本号为`1001001`,子版本号为`2`。
QRCODEstring二维码版本号。组成形式为`X.Y`,其中`X`代表主版本号,通常表示模型整体的效果迭代;`Y`代表子版本号,通常表示日常的例行迭代。例如,`1001001.2`代表主版本号为`1001001`,子版本号为`2`。
VIOLENTstring暴恐版本号。组成形式为`X.Y`,其中`X`代表主版本号,通常表示模型整体的效果迭代;`Y`代表子版本号,通常表示日常的例行迭代。例如,`1001001.2`代表主版本号为`1001001`,子版本号为`2`。
errorCodeint322001:输入数据格式不对,不是合法的json数据 2002:输入的参数字段不合法(必填字段缺失、类型不对、值不合法等) 2003:图片下载失败 2004:图片过大,超过了10M 2005:非法图片格式 2006:无效风险监测类型
qrContentstring返回图片中识别的二维码地址
riskDetailobject风险详情信息
riskSourceint32风险来源,可能取值: 1000:无风险 1001:文字风险 1002:视觉图片风险
face_numint32人脸数量
person_numint32人像数量
facesarray图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
face_ratiofloat人脸占比,在区间0-1,数值越大,人脸占比越高
idstring编号,图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次,分配n个ID
namestring人物名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人物位置信息,该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objectsarray物品信息。返回图片中标识或物品的名称及位置信息
idstring物品或标识编号,保证同一个位置下的物品在不同标签下的编号相同
namestring物品名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
qrContentstring返回图片中识别的二维码地址
locationarray物品位置信息 该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
ocrTextobject返回图片中文字识别内容,当请求参数type字段包含IMGTEXTRISK或ADVERT时存在
textstring图片中识别出的文字
matchedListsarray命中的客户自定义名单信息 仅在命中客户自定义名单时返回
namestring命中的名单名称
wordsarray命中的这个名单中的敏感词信息
wordstring命中的敏感词
positionarray敏感词所在位置
riskSegmentsarray高风险片段内容。检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在
segmentstring辅助信息 高风险内容片段
positionarray高风险内容片段所在位置 下标从0开始计数
personsarray图片中人物的名称及位置信息。当命中'人像-多人'标签时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
idstring编号,保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次,分配n个ID
person_ratiofloat人像占比。在区间0-1,数值越大,人脸占比越高
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人像位置坐标
tokenLabelsobject账号标签信息 见下面详情内容,仅在tokenId传入且联系数美开通时返回
UGC_account_riskobjectUGC内容相关风险
b_advertise_risk_tokenidint32广告风险。 0:暂未发现广告风险 1:存在广告风险
b_advertise_risk_tokenid_last_tsint32广告风险时间
b_politics_risk_tokenidint32涉政风险。 0:暂未发现涉政风险。 1:存在涉政风险
b_politics_risk_tokenid_last_tsint32涉政风险时间
b_sexy_risk_tokenidint32色情风险。 0:暂未发现色情风险 1:存在色情风险
b_sexy_risk_tokenid_last_tsint32色情风险时间
machine_account_riskobject机器控制相关风险
b_machine_control_tokenidint32机器账号, 0:非机器控制账号 1:机器控制账号
b_machine_control_tokenid_last_tsint32机器账号时间
b_offer_wall_tokenidint32积分墙账号。 0:非积分墙账号 1:积分墙账号
b_offer_wall_tokenid_last_tsint32积分墙账号时间
scene_account_riskobject场景账号风险,特殊场景才可取到,如航司等
i_tout_risk_tokenidint32航司占座账号: 0:非航司占座账号 1:航司占座账号
i_tout_risk_tokenid_last_tsint32航司占座时间
businessLabelsarray业务标签列表
businessDescriptionstring业务标签中文描述,格式为"一级标签:二级标签:三级标签"的中文名称
businessLabel1string一级业务标签
businessLabel2string二级业务标签
businessLabel3string三级业务标签
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
confidenceLevelint32置信等级,可选值在0~2之间,值越大,可信度越高
businessDetailobject业务标签详情
face_compare_numint32imgCompareBase传入图片检测到的人脸个数,当传入FACECOMPARE与imgCompareBase时存在
face_numint32人脸数量
face_ratiofloat人脸占比,在区间0-1,数值越大,人脸占比越高
namestring人物名称
person_numint32人像数量
person_ratiofloat人像占比。在区间0-1,数值越大,人脸占比越高
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
facesarray图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
face_ratiofloat人脸占比,在区间0-1,数值越大,人脸占比越高
idstring编号,图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次,分配n个ID
namestring人物名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人物位置信息,该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
locationarray标识位置信息 该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objectsarray物品信息。返回图片中标识或物品的名称及位置信息
idstring物品或标识编号,保证同一个位置下的物品在不同标签下的编号相同
namestring物品名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
qrContentstring返回图片中识别的二维码地址
locationarray物品位置信息 该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
personsarray图片中人物的名称及位置信息。当命中'人像-多人'标签时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
idstring编号,保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次,分配n个ID
person_ratiofloat人像占比。在区间0-1,数值越大,人脸占比越高
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人像位置坐标
disposalobject处置和映射结果 数美可按照贵司的标签体系和标识进行返回,未配置自定义标签体系则不返回该字段,如需开通可联系商务经理。 对于批量图片异步接口,处置映射功能开启后,回调结果会由之前的整体回调改为分开回调
riskDescriptionstring当riskLevel为PASS时为正常
riskLabel1string一级风险标签。当数美标签未映射上自定义标签,或当disposal下的riskLevel为PASS时返回normal
riskLabel2string二级风险标签。当数美标签未映射上自定义标签,或当disposal下的riskLevel为PASS时返回为空
riskLabel3string三级风险标签。当数美标签未映射上自定义标签,或当disposal下的riskLevel为PASS时返回为空
riskLevelstring若贵司有自己的处置规则,数美可按照贵司的处置逻辑配置并返回对应的处置建议;若规则标签未映射上,则返回默认处置建议
riskDetailobject风险详情信息
riskSourceint32风险来源,可能取值: 1000:无风险 1001:文字风险 1002:视觉图片风险
face_numint32人脸数量
person_numint32人像数量
facesarray图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
face_ratiofloat人脸占比,在区间0-1,数值越大,人脸占比越高
idstring编号,图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次,分配n个ID
namestring人物名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人物位置信息,该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objectsarray物品信息。返回图片中标识或物品的名称及位置信息
idstring物品或标识编号,保证同一个位置下的物品在不同标签下的编号相同
namestring物品名称
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
qrContentstring返回图片中识别的二维码地址
locationarray物品位置信息 该数组有四个值,分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
ocrTextobject返回图片中文字识别内容,当请求参数type字段包含IMGTEXTRISK或ADVERT时存在
textstring图片中识别出的文字
matchedListsarray命中的客户自定义名单信息 仅在命中客户自定义名单时返回
namestring命中的名单名称
wordsarray命中的这个名单中的敏感词信息
wordstring命中的敏感词
positionarray敏感词所在位置
riskSegmentsarray高风险片段内容。检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在
segmentstring辅助信息 高风险内容片段
positionarray高风险内容片段所在位置 下标从0开始计数
personsarray图片中人物的名称及位置信息。当命中'人像-多人'标签时,数组元素会有多个,最多10(如果超过10个,选择probability最高的10个)
idstring编号,保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次,分配n个ID
person_ratiofloat人像占比。在区间0-1,数值越大,人脸占比越高
probabilityfloat置信度。可选值在0~1之间,值越大,可信度越高
locationarray人像位置坐标
tokenProfileLabelsarray账号属性标签。仅在tokenId传入且标签服务开通时返回
descriptionstring标签描述
label1string一级标签
label2string二级标签
label3string三级标签
timestampint32打标签时间戳 13位Unix时间戳,单位:毫秒
tokenRiskLabelsarray账号风险标签。仅在tokenId传入且标签服务开通时返回
descriptionstring标签描述
label1string一级标签
label2string二级标签
label3string三级标签
timestampint32打标签时间戳 13位Unix时间戳,单位:毫秒

示例#

请求示例#

{
"accessKey": "***",
"requestIds": [
{
"btId": "xxxxx",
"requestId": "***"
}
]
}

返回示例#

{
"code": 1100,
"contents": [
{
"Result": {
"allLabels": [
{
"probability": 0.922851562500734,
"riskDescription": "暴恐:暴恐场景:血腥",
"riskDetail": {
"ocrText": {
"text": "颈曲: 正常胸曲"
},
"riskSource": 1002
},
"riskLabel1": "violence",
"riskLabel2": "baokongchangjing",
"riskLabel3": "xuexing",
"riskLevel": "REJECT"
}
],
"auxInfo": {
"segments": 1,
"typeVersion": {
"BAN": "1002106.1",
"MINOR": "2014055.1",
"OCR": "2001038.1",
"POLITICS": "2014055.1",
"PORN": "3058001.1",
"VIOLENCE": "2013019.1"
}
},
"businessLabels": [
{
"businessDescription": "人脸:性别:男性",
"businessDetail": {
"face_ratio": 0.00106996833346784,
"faces": [
{
"face_ratio": 0.00106996833346784,
"id": "35da33429897372017bb7ad7c7302693",
"location": [
228,
588,
256,
622
],
"name": "",
"probability": 0.967536687850952
}
],
"location": [
228,
588,
256,
622
],
"name": "",
"probability": 0.967536687850952
},
"businessLabel1": "face",
"businessLabel2": "gender",
"businessLabel3": "male",
"confidenceLevel": 2,
"probability": 0.967536687850952
},
{
"businessDescription": "人脸:人脸类型:真人",
"businessDetail": {
"face_num": 1,
"face_ratio": 0.00106996833346784,
"faces": [
{
"face_ratio": 0.00106996833346784,
"id": "35da33429897372017bb7ad7c7302693",
"location": [
228,
588,
256,
622
],
"name": "黄大谦",
"probability": 0.541935835649002
}
],
"location": [
228,
588,
256,
622
],
"name": "黄大谦",
"probability": 0.541935835649002
},
"businessLabel1": "face",
"businessLabel2": "renlianleixing",
"businessLabel3": "zhenren",
"confidenceLevel": 2,
"probability": 0.996093758527634
},
{
"businessDescription": "人脸:人脸姿态:正脸",
"businessDetail": {},
"businessLabel1": "face",
"businessLabel2": "renlianzitai",
"businessLabel3": "zhenglian",
"confidenceLevel": 1,
"probability": 0.450656906102068
}
],
"code": 1100,
"finalResult": 1,
"message": "成功",
"requestId": "8aebe9f775f1150c1fd99761904507d6",
"resultType": 0,
"riskDescription": "暴恐:暴恐场景:血腥",
"riskDetail": {
"ocrText": {
"text": "颈曲: 正常胸曲"
},
"riskSource": 1002
},
"riskLabel1": "violence",
"riskLabel2": "baokongchangjing",
"riskLabel3": "xuexing",
"riskLevel": "REJECT",
"riskSource": 1002,
"tokenLabels": {
"UGC_account_risk": {}
}
},
"code": 1100,
"message": "成功",
"requestId": "8aebe9f775f1150c1fd99761904507d6"
}
],
"message": "成功"
}

在线咨询