requestId | string | 是 | 数美请求唯一标识 |
message | string | 是 | 和code对应:
1100:成功
1901:QPS超限
1902:参数不合法
1903:服务失败
1911:图片下载失败
9101:无权限操作 |
code | int32 | 是 | 1100:成功
1901:QPS超限
1902:参数不合法
1903:服务失败
1911:图片下载失败
9101:无权限操作 |
riskLevel | string | 是 | 识别结果,可能返回值:
PASS:正常,建议直接放行
REVIEW:可疑,建议人工审核
REJECT:违规,建议直接拦截 |
riskLabel1 | string | 是 | 一级风险标签,当riskLevel为PASS时返回normal |
riskLabel2 | string | 是 | 二级风险标签,当riskLevel为PASS时为空 |
riskLabel3 | string | 是 | 三级风险标签, 当riskLevel为PASS时为空 |
riskDescription | string | 是 | 当riskLevel为PASS时返回正常;
其他情况展现形式为:"一级标签:二级标签:三级标签"的中文名
仅供人了解风险原因时作为参考,程序请勿依赖该参数的值做逻辑处理 |
resultType | int32 | 是 | 当前结果类型
0:机审
1:人审 |
finalResult | int32 | 是 | 是否为最终审核结果(如仅接入机审,则默认返回1)。
0:非最终结果。说明该结果为数美风控的机审结果,还需要经过数美人审再次审核后回传贵司。
1:最终结果。贵司可直接拿返回结果进行处置、分发等下游场景的使用。 |
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:无效风险监测类型 |
frameTime | int32 | 否 | 请求参数中传入streamInfo功能时满足相似功能会返回 |
qrContent | string | 否 | 返回图片中识别的二维码地址 |
streamId | string | 否 | 请求参数中传入streamInfo等参数并满足相似功能会返回 |
passThrough | object | 否 | 客户传入透传字段。数美内部不会对该字段进行识别处理,随结果返回给用户。 |
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 | 否 | 人像位置坐标 |
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 | 否 | 人像位置坐标 |
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 | 否 | 人像位置坐标 |
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 | 否 | 人像位置坐标 |
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 | 否 | 航司占座时间 |
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时间戳,单位:毫秒 |