异步批量检测

图片检测接口，可协助您识别图片中的涉政、色情、广告、暴恐等风险；同时可结合您的业务场景，识别人脸、LOGO、动植物等内容。

接口说明

批量检测接口，可返回识别结果。

接口要求

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

图片要求

图片类型：URL、BASE64。 图片格式：jpg，jpeg，png，webp，gif，tiff，tif，heif。 图片像素：目前支持`20px*20px`~`6000px*6000px`范围的分辨率图片，建议图片像素不小于`256px*256px`。 图片大小：同步接口限制为10M，异步接口限制为30M。 截帧说明：长图默认不切分。如需开通切分功能可联系数美，切分后审核数量及计费可能会增加。gif等动图按照传入参数决定切分张数。 图片地址：建议图片下载从CDN源站下载，并且源站不能为单点，否则可能存在图片下载失败，导致无法审核。

审核时间

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

回调机制

当用户的服务端收到推送结果，并返回HTTP状态码为200时，表示推送成功，否则系统将进行重试推送（直至达到重试次数上限）重试逻辑为间隔[1, 2, 3, 4, 5, 6, 7, 8]秒后重试，8次之后依然失败则不在重试

历史版本

历史版本

请求

请求地址

集群	请求地址	支持产品列表
北京图像集群	http://api-img-bj.fengkongcloud.com/images/v4	中文图片
上海图像集群	http://api-img-sh.fengkongcloud.com/images/v4	中文图片
硅谷图像集群	http://api-img-gg.fengkongcloud.com/images/v4	中文图片 英文图片 阿语图片
新加坡图像集群	http://api-img-xjp.fengkongcloud.com/images/v4	中文图片 英文图片 阿语图片

请求参数

参数名称	类型	是否必传	最大长度	参数说明
accessKey	string	是	20	公司密钥。用于权限认证，开通服务时由数美提供
eventId	string	是	64	事件标识。需要与数美约定好取值。
appId	string	是	64	应用标识。此字段强校验，需要提前与数美约定好取值。
type	string	否	64	需要识别的风险类型。type与businessType至少传一个, 可选值： POLITY ：涉政识别 EROTIC ：色情&性感违规识别 VIOLENT ：暴恐&违禁识别 QRCODE ：二维码识别 ADVERT ：广告识别 IMGTEXTRISK ：图片文字违规识别（如需要识别图片里文字的违规内容，务必传入图片文字违规识别功能） BOCR：OCR小语种识别支持和语种自动检测（仅限新加坡集群） 如果需要识别多个功能，通过下划线连接，如 POLITY_QRCODE_ADVERT 用于涉政、二维码和广告组合识别
businessType	string	否	128	需要识别的业务类型。businessType与type至少传一个，可选值见业务标签类型
callback	string	否	1024	回调请求url。传callback表示走异步回调逻辑，否则走同步逻辑。地址必须为http或https的规范的url。
data	object	是	-	请求的数据内容
tokenId	string	是	64	用户账号标识。建议传入用户ID，可用于灌水、广告等行为维度的风险识别。
imgs	array	是	-	要检测的图片数组，要求数组长度在12以内
btId	string	是	30	客户侧请求唯一标识
img	string	是	1024	要检测的图片，可使用图片的base64编码或者图片的url链接
imgCompareBase	string	否	1024	要检测比对的基准图片。请求参数businessType字段包含标签`FACECOMPARE`时存在 可使用base64编码的图片数据或者图片的url链接 支持格式： jpg，jpeg，png，webp，gif，tiff，tif，heif 建议图片像素不小于256*256，图片大小最大10MB 基准图暂时不支持长图和动图格式
dataId	string	否	128	客户自定义数据Id。可以用于数美saas后台检索
deviceId	string	否	128	数美设备指纹标识。由数美SDK生成，用于用户行为分析。
gender	string	否	-	用户性别，建议值： male：男性 female：女性 ambiguity：性别不明
interval	int32	否	-	动图截帧频率。动图检测专用，默认值为1。每interval张图片抽取一张进行检测。 当interval*maxFrame小于该图片所包含的图片数量时，截帧间隔会自动修改为该图片所包含的图片数/maxFrame，以提高整体检测效果。
ip	string	否	64	客户端公网IP地址。该参数用于IP维度的用户行为分析。
lang	string	否	-	语言类型。当type中包含`IMGTEXTRISK`时，可指定对应检测语种类型（默认为中文），可选值：： zh：中文 en：英文 ar：阿拉伯语
level	int32	否	-	用户等级，针对不同等级的用户可配置不同拦截策略。可选值：0：最低级用户，典型如新注册、完全不活跃或等级为0的用户等; 1：较低级用户，典型如低活跃或低等级用户等； 2：中等级用户，典型如具备一定活跃或等级中等的用户等； 3：较高级用户，典型如高活跃或高等级用户等； 4：最高级用户，典型如付费用户、VIP用户等
maxFrame	int32	否	-	动图的最大截帧数量。截取gif等动图帧数，最大为20帧，默认为3帧，计费按照实际截帧数量计费，如默认为截取3帧时按照3帧进行计费
receiveTokenId	string	否	64	消息接收者的tokenId由数字、字母、下划线、短杠组成的长度小于等于64位的字符串
extra	object	否	-	辅助参数,用于辅助检测的相关信息
isTokenSeparate	int32	否	-	是否区分不同应用下的账号。是否区分不同应用下的账号，可能取值： 0:不区分 1:区分 默认值为0。 取值为1时不同应用下的账号体系各自独立，账号相关的策略特征在不同应用下单独统计和生效。
room	string	否	64	直播间/游戏房间编号，可针对单个房间制定不同的策略
passThrough	object	否	1024	客户传入透传字段。数美内部不会对该字段进行识别处理，随结果返回给用户。
acceptLang	string	否	-	选择返回标签的语种类型 可选值： zh：中文 en：英文 不传入默认为返回中文标签

响应

返回参数

参数名称	类型	是否必返	参数说明
message	string	是	和code对应： 1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 1911：图片下载失败 9101：无权限操作
code	int32	是	1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 1911：图片下载失败 9101：无权限操作
requestIds	array	是	多个图片流水号
btId	string	是	客户侧请求唯一标识
requestId	string	是	数美请求唯一标识

回调参数

以下参数，除code、message、requestId以外，其他必返参数均为在code返回1100时为必返。

参数名称	类型	是否必返	参数说明
requestId	string	是	数美请求唯一标识
message	string	是	和code对应： 1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 1911：图片下载失败 9101：无权限操作
code	int32	是	1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 1911：图片下载失败 9101：无权限操作
imgs	array	是
btId	string	是	客户侧请求唯一标识
code	int32	是	1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 1911：图片下载失败 9101：无权限操作
finalResult	int32	是	是否为最终审核结果（如仅接入机审，则默认返回1）。 0：非最终结果。说明该结果为数美风控的机审结果，还需要经过数美人审再次审核后回传贵司。 1：最终结果。贵司可直接拿返回结果进行处置、分发等下游场景的使用。
message	string	是	和code对应： 1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 1911：图片下载失败 9101：无权限操作
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	否	返回图片中识别的二维码地址
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时间戳，单位：毫秒
auxInfo	object	否
passThrough	object	否	客户传入透传字段。数美内部不会对该字段进行识别处理，随结果返回给用户。

示例

请求示例

{

"accessKey": "xxxxxx",

"appId": "default",

"callback": "http://callback.xxx",

"data": {

"imgs": [

{

"btId": "123",

"img": "xxxx"

},

{

"btId": "456",

"img": "xxxx"

}

],

"tokenId": "username123"

},

"eventId": "xxxxx",

"type": "xxxx"

}

返回示例

{

"code": 1100,

"message": "成功",

"requestIds": [

{

"btId": "123",

"requestId": "faf10b672ddae5e5e51ea719c44ca94b"

},

{

"btId": "456",

"requestId": "faf10b672ddae5e5e51ea719c44ca94b"

}

]

}

回调示例

{

"auxInfo": {},

"code": 1100,

"imgs": [

{

"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": "faf10b672ddae5e5e51ea719c44ca94b_123",

"resultType": 0,

"riskDescription": "暴恐:暴恐场景:血腥",

"riskDetail": {

"ocrText": {

"text": "颈曲： 正常胸曲"

},

"riskSource": 1002

},

"riskLabel1": "violence",

"riskLabel2": "baokongchangjing",

"riskLabel3": "xuexing",

"riskLevel": "REJECT",

"riskSource": 1002,

"tokenLabels": {

"UGC_account_risk": {}

}

},

{

"allLabels": [],

"auxInfo": {

"segments": 1,

"typeVersion": {

"OCR": "2001003.1",

"PORN": "3043001.1"

}

},

"btId": "456",

"code": 1100,

"message": "成功",

"requestId": "faf10b672ddae5e5e51ea719c44ca94b_456",

"riskDescription": "正常",

"riskDetail": {

"riskSource": 1000

},

"riskLabel1": "normal",

"riskLabel2": "",

"riskLabel3": "",

"riskLevel": "PASS",

"tokenLabels": {

"UGC_account_risk": {}

}

}

],

"message": "成功",

"requestId": "faf10b672ddae5e5e51ea719c44ca94b"

}

附录

业务标签类型

业务标签识别类型	类型说明	备注
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	场景主题-城市风光	如识别街景
3CPRODUCTSLOGO	LOGO-3C电子类品牌	如识别华为、小米、OPPO等LOGO
SHOPPINGAPPSLOGO	LOGO-购物比价类应用	如识别拼多多等LOGO
RETOUCHAPPSLOGO	LOGO-拍摄美化类应用	如识别快剪辑、秒拍等LOGO
SOCIALAPPSLOGO	LOGO-社交通讯类应用	如识别微博、小红书等LOGO
PHOTOMATERIALLOGO	LOGO-素材版权类应用	如识别CFP等LOGO
NEWSAPPSLOGO	LOGO-新闻阅读类应用	如识别新浪、视觉中国等LOGO
ENTERTAINMENTAPPSLOGO	LOGO-影音娱乐类应用	如识别抖音、快手等LOGO
SPORTSLOGO	LOGO-体育赛事	如识别奥运会等LOGO
APPARELLOGO	LOGO-鞋帽服饰类品牌	如识别VANS、H&M等LOGO
ACCESSORIESLOGO	LOGO-饰品首饰类品牌	如识别AudemarsPiguet、Nomos等LOGO
COSMETICSLOGO	LOGO-化妆品类品牌	如识别LOTTE、EyesLipsFace等LOGO
FOODLOGO	LOGO-食品类品牌	如识别Starbucks、LOTTE等LOGO
AUTOTRADEAPPSLOGO	LOGO-汽车交易平台类	如识别懂车帝、易车、太平洋汽车、爱卡等LOGO
VEHICLE	物品-交通工具
BUILDING	物品-建筑
TABLEWARE	物品-餐具
FOOD	物品-食物
HOMEAPPLICATION	物品-家用电器
OFFICESUPPLIES	物品-办公用品
FASHION	物品-穿着用品
SPORTEQUIPMENT	物品-运动器材
TOY	物品-玩具
MAKEUP	物品-化妆品
DRUGS	物品-药品
PAINTING	物品-绘画作品
ELECTRONIC	物品-电子产品
LOTTERY	物品-彩票-刮刮乐
DEFORMITY	人体-畸形躯干
MEDICALIMAGE	物品-医疗影像
FURNITURE	物品-家居用品
DAILYSUPPLIES	物品-生活用品
CONSTELLATION	物品-星座占卜
KITCHENWARE	物品-厨房用品
KEEPSAKE	物品-纪念品
MAMMAL	动物-哺乳动物
BIRDS	动物-鸟类
REPTILE	动物-爬行动物
FISH	动物-鱼
ARTHROPOD	动物-节肢动物
COELENTERATE	动物-腔肠动物
MOLLUSKS	动物-软体动物
CRUSTACEAN	动物-甲壳动物
PLANT	植物
SETTING	场所	如识别卫生间、酒店、厨房等
EXTREMEWEATHER	极端天气识别	如水灾、暴雨、沙尘暴、冰等
LICENCEPLATE	车牌识别
DANCE	跳舞识别