查询接口

查询图片审核结果

查询说明

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

接口要求

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

审核时间

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

历史版本

历史版本

请求

请求地址

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

请求参数

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

响应

返回参数

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

参数名称	类型	是否必返	参数说明
message	string	是	和code对应： 1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 9101：无权限操作
code	int32	是	1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 9101：无权限操作
contents	array	是	查询结果
code	int32	是	1100：成功 1102：正在处理 1910：失败 1912：处理超时(默认24h)
message	string	是	1100：成功 1102：正在处理 1910：失败 1912：处理超时(默认24h)
requestId	string	是	数美请求唯一标识
btId	string	否	客户侧请求唯一标识
Result	object	否	下面必返参数均为在result下面的code返回1100时为必返。
code	int32	是	1100：成功 1903：服务失败 1911：图片下载失败
finalResult	int32	是	是否为最终审核结果（如仅接入机审，则默认返回1）。 0：非最终结果。说明该结果为数美风控的机审结果，还需要经过数美人审再次审核后回传贵司。 1：最终结果。贵司可直接拿返回结果进行处置、分发等下游场景的使用。
message	string	是	1100：成功 1903：服务失败 1911：图片下载失败
requestId	string	是	数美请求唯一标识
resultType	int32	是	当前结果类型 0:机审 1:人审
riskDescription	string	是	当riskLevel为PASS时返回正常； 其他情况展现形式为："一级标签:二级标签:三级标签"的中文名 仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
riskLabel1	string	是	一级风险标签，当riskLevel为PASS时返回normal
riskLabel2	string	是	二级风险标签,当riskLevel为PASS时为空
riskLabel3	string	是	三级风险标签, 当riskLevel为PASS时为空
riskLevel	string	是	识别结果，可能返回值： PASS：正常，建议直接放行 REVIEW：可疑，建议人工审核 REJECT：违规，建议直接拦截
allLabels	array	是	全部的风险标签列表
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
riskDescription	string	否	当riskLevel为PASS时返回正常； 其他情况展现形式为："一级标签:二级标签:三级标签"的中文名 仅供人了解风险原因时作为参考，程序请勿依赖该参数的值做逻辑处理
riskLabel1	string	否	一级风险标签
riskLabel2	string	否	二级风险标签
riskLabel3	string	否	三级风险标签
riskLevel	string	否	识别结果，可能返回值： PASS：正常，建议直接放行 REVIEW：可疑，建议人工审核 REJECT：违规，建议直接拦截
riskDetail	object	否	风险详情信息
riskSource	int32	是	风险来源，可能取值： 1000：无风险 1001：文字风险 1002：视觉图片风险
face_num	int32	否	人脸数量
person_num	int32	否	人像数量
faces	array	否	图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
face_ratio	float	否	人脸占比，在区间0-1，数值越大，人脸占比越高
id	string	否	编号，图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次，分配n个ID
name	string	否	人物名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人物位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objects	array	否	物品信息。返回图片中标识或物品的名称及位置信息
id	string	否	物品或标识编号，保证同一个位置下的物品在不同标签下的编号相同
name	string	否	物品名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
qrContent	string	否	返回图片中识别的二维码地址
location	array	否	物品位置信息 该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
ocrText	object	否	返回图片中文字识别内容，当请求参数type字段包含IMGTEXTRISK或ADVERT时存在
text	string	是	图片中识别出的文字
matchedLists	array	否	命中的客户自定义名单信息 仅在命中客户自定义名单时返回
name	string	否	命中的名单名称
words	array	否	命中的这个名单中的敏感词信息
word	string	否	命中的敏感词
position	array	否	敏感词所在位置
riskSegments	array	否	高风险片段内容。检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在
segment	string	否	辅助信息 高风险内容片段
position	array	否	高风险内容片段所在位置 下标从0开始计数
persons	array	否	图片中人物的名称及位置信息。当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
id	string	否	编号，保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	否	人像占比。在区间0-1，数值越大，人脸占比越高
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人像位置坐标
auxInfo	object	是	辅助信息
segments	int32	是	实际处理的片段数量
typeVersion	object	是	传入的type值所对应的模型版本号
ADVERT	string	否	广告版本号。组成形式为`X.Y`，其中`X`代表主版本号，通常表示模型整体的效果迭代；`Y`代表子版本号，通常表示日常的例行迭代。例如，`1001001.2`代表主版本号为`1001001`，子版本号为`2`。
EROTIC	string	否	色情版本号。组成形式为`X.Y`，其中`X`代表主版本号，通常表示模型整体的效果迭代；`Y`代表子版本号，通常表示日常的例行迭代。例如，`1001001.2`代表主版本号为`1001001`，子版本号为`2`。
IMGTEXTRISK	string	否	违规文字版本号。组成形式为`X.Y`，其中`X`代表主版本号，通常表示模型整体的效果迭代；`Y`代表子版本号，通常表示日常的例行迭代。例如，`1001001.2`代表主版本号为`1001001`，子版本号为`2`。
POLITY	string	否	涉政版本号。组成形式为`X.Y`，其中`X`代表主版本号，通常表示模型整体的效果迭代；`Y`代表子版本号，通常表示日常的例行迭代。例如，`1001001.2`代表主版本号为`1001001`，子版本号为`2`。
QRCODE	string	否	二维码版本号。组成形式为`X.Y`，其中`X`代表主版本号，通常表示模型整体的效果迭代；`Y`代表子版本号，通常表示日常的例行迭代。例如，`1001001.2`代表主版本号为`1001001`，子版本号为`2`。
VIOLENT	string	否	暴恐版本号。组成形式为`X.Y`，其中`X`代表主版本号，通常表示模型整体的效果迭代；`Y`代表子版本号，通常表示日常的例行迭代。例如，`1001001.2`代表主版本号为`1001001`，子版本号为`2`。
errorCode	int32	否	2001：输入数据格式不对，不是合法的json数据 2002：输入的参数字段不合法（必填字段缺失、类型不对、值不合法等） 2003：图片下载失败 2004：图片过大，超过了10M 2005：非法图片格式 2006：无效风险监测类型
qrContent	string	否	返回图片中识别的二维码地址
passThrough	object	否	客户传入透传字段。数美内部不会对该字段进行识别处理，随结果返回给用户。
riskDetail	object	是	风险详情信息
riskSource	int32	是	风险来源，可能取值： 1000：无风险 1001：文字风险 1002：视觉图片风险
face_num	int32	否	人脸数量
person_num	int32	否	人像数量
faces	array	否	图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
face_ratio	float	否	人脸占比，在区间0-1，数值越大，人脸占比越高
id	string	否	编号，图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次，分配n个ID
name	string	否	人物名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人物位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objects	array	否	物品信息。返回图片中标识或物品的名称及位置信息
id	string	否	物品或标识编号，保证同一个位置下的物品在不同标签下的编号相同
name	string	否	物品名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
qrContent	string	否	返回图片中识别的二维码地址
location	array	否	物品位置信息 该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
ocrText	object	否	返回图片中文字识别内容，当请求参数type字段包含IMGTEXTRISK或ADVERT时存在
text	string	是	图片中识别出的文字
matchedLists	array	否	命中的客户自定义名单信息 仅在命中客户自定义名单时返回
name	string	否	命中的名单名称
words	array	否	命中的这个名单中的敏感词信息
word	string	否	命中的敏感词
position	array	否	敏感词所在位置
riskSegments	array	否	高风险片段内容。检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在
segment	string	否	辅助信息 高风险内容片段
position	array	否	高风险内容片段所在位置 下标从0开始计数
persons	array	否	图片中人物的名称及位置信息。当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
id	string	否	编号，保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	否	人像占比。在区间0-1，数值越大，人脸占比越高
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人像位置坐标
tokenLabels	object	是	账号标签信息 见下面详情内容，仅在tokenId传入且联系数美开通时返回
UGC_account_risk	object	否	UGC内容相关风险
b_advertise_risk_tokenid	int32	否	广告风险。 0：暂未发现广告风险 1：存在广告风险
b_advertise_risk_tokenid_last_ts	int32	否	广告风险时间
b_politics_risk_tokenid	int32	否	涉政风险。 0：暂未发现涉政风险。 1：存在涉政风险
b_politics_risk_tokenid_last_ts	int32	否	涉政风险时间
b_sexy_risk_tokenid	int32	否	色情风险。 0：暂未发现色情风险 1：存在色情风险
b_sexy_risk_tokenid_last_ts	int32	否	色情风险时间
machine_account_risk	object	否	机器控制相关风险
b_machine_control_tokenid	int32	否	机器账号， 0：非机器控制账号 1：机器控制账号
b_machine_control_tokenid_last_ts	int32	否	机器账号时间
b_offer_wall_tokenid	int32	否	积分墙账号。 0：非积分墙账号 1：积分墙账号
b_offer_wall_tokenid_last_ts	int32	否	积分墙账号时间
scene_account_risk	object	否	场景账号风险,特殊场景才可取到，如航司等
i_tout_risk_tokenid	int32	否	航司占座账号： 0：非航司占座账号 1：航司占座账号
i_tout_risk_tokenid_last_ts	int32	否	航司占座时间
businessLabels	array	否	业务标签列表
businessDescription	string	是	业务标签中文描述，格式为"一级标签:二级标签:三级标签"的中文名称
businessLabel1	string	是	一级业务标签
businessLabel2	string	是	二级业务标签
businessLabel3	string	是	三级业务标签
probability	float	是	置信度。可选值在0～1之间，值越大，可信度越高
confidenceLevel	int32	否	置信等级，可选值在0～2之间，值越大，可信度越高
businessDetail	object	否	业务标签详情
face_compare_num	int32	否	imgCompareBase传入图片检测到的人脸个数，当传入FACECOMPARE与imgCompareBase时存在
face_num	int32	否	人脸数量
face_ratio	float	否	人脸占比，在区间0-1，数值越大，人脸占比越高
name	string	否	人物名称
person_num	int32	否	人像数量
person_ratio	float	否	人像占比。在区间0-1，数值越大，人脸占比越高
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
faces	array	否	图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
face_ratio	float	否	人脸占比，在区间0-1，数值越大，人脸占比越高
id	string	否	编号，图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次，分配n个ID
name	string	否	人物名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人物位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
location	array	否	标识位置信息 该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objects	array	否	物品信息。返回图片中标识或物品的名称及位置信息
id	string	否	物品或标识编号，保证同一个位置下的物品在不同标签下的编号相同
name	string	否	物品名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
qrContent	string	否	返回图片中识别的二维码地址
location	array	否	物品位置信息 该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
persons	array	否	图片中人物的名称及位置信息。当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
id	string	否	编号，保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	否	人像占比。在区间0-1，数值越大，人脸占比越高
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人像位置坐标
disposal	object	否	处置和映射结果 数美可按照贵司的标签体系和标识进行返回，未配置自定义标签体系则不返回该字段，如需开通可联系商务经理。 对于批量图片异步接口，处置映射功能开启后，回调结果会由之前的整体回调改为分开回调
riskDescription	string	是	当riskLevel为PASS时为正常
riskLabel1	string	是	一级风险标签。当数美标签未映射上自定义标签，或当disposal下的riskLevel为PASS时返回normal
riskLabel2	string	是	二级风险标签。当数美标签未映射上自定义标签，或当disposal下的riskLevel为PASS时返回为空
riskLabel3	string	是	三级风险标签。当数美标签未映射上自定义标签，或当disposal下的riskLevel为PASS时返回为空
riskLevel	string	是	若贵司有自己的处置规则，数美可按照贵司的处置逻辑配置并返回对应的处置建议；若规则标签未映射上，则返回默认处置建议
riskDetail	object	是	风险详情信息
riskSource	int32	是	风险来源，可能取值： 1000：无风险 1001：文字风险 1002：视觉图片风险
face_num	int32	否	人脸数量
person_num	int32	否	人像数量
faces	array	否	图片中涉政人物的名称及位置信息。当命中人脸-人脸类型-多人脸时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
face_ratio	float	否	人脸占比，在区间0-1，数值越大，人脸占比越高
id	string	否	编号，图片同一个位置下的人在不同标签下的编号相同。 如果同一个人在图片中出现n次，分配n个ID
name	string	否	人物名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人物位置信息，该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
objects	array	否	物品信息。返回图片中标识或物品的名称及位置信息
id	string	否	物品或标识编号，保证同一个位置下的物品在不同标签下的编号相同
name	string	否	物品名称
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
qrContent	string	否	返回图片中识别的二维码地址
location	array	否	物品位置信息 该数组有四个值，分别代表左上角的坐标和右下角的坐标。例如[207,522,340,567] 207代表的是左上角的x坐标 522代表左上角的y坐标 340代表的是右下角的x坐标 567代表的是右下角的y坐标
ocrText	object	否	返回图片中文字识别内容，当请求参数type字段包含IMGTEXTRISK或ADVERT时存在
text	string	是	图片中识别出的文字
matchedLists	array	否	命中的客户自定义名单信息 仅在命中客户自定义名单时返回
name	string	否	命中的名单名称
words	array	否	命中的这个名单中的敏感词信息
word	string	否	命中的敏感词
position	array	否	敏感词所在位置
riskSegments	array	否	高风险片段内容。检测图片包含涉政、暴恐、违禁、竞品、广告法等风险内容的时候存在
segment	string	否	辅助信息 高风险内容片段
position	array	否	高风险内容片段所在位置 下标从0开始计数
persons	array	否	图片中人物的名称及位置信息。当命中'人像-多人'标签时，数组元素会有多个，最多10（如果超过10个，选择probability最高的10个）
id	string	否	编号，保证同一个人在不同标签下的编号相同。如果同一个人在图片中出现n次，分配n个ID
person_ratio	float	否	人像占比。在区间0-1，数值越大，人脸占比越高
probability	float	否	置信度。可选值在0～1之间，值越大，可信度越高
location	array	否	人像位置坐标
tokenProfileLabels	array	否	账号属性标签。仅在tokenId传入且标签服务开通时返回
description	string	否	标签描述
label1	string	否	一级标签
label2	string	否	二级标签
label3	string	否	三级标签
timestamp	int32	否	打标签时间戳 13位Unix时间戳，单位：毫秒
tokenRiskLabels	array	否	账号风险标签。仅在tokenId传入且标签服务开通时返回
description	string	否	标签描述
label1	string	否	一级标签
label2	string	否	二级标签
label3	string	否	三级标签
timestamp	int32	否	打标签时间戳 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": "成功"

}