翻拍识别
功能介绍
零售行业通常根据零售店的销售量进行销售奖励，拍摄售出商品的条形码上传后台是常用的统计方式。翻拍识别利用深度神经网络算法判断条形码图片为原始拍摄，还是经过二次翻拍、打印翻拍等手法二次处理的图片。利用翻拍识别，可以检测出经过二次处理的不合规范图片，使得统计数据更准确、有效。
目前只支持华为系列商品的条形码的翻拍识别。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/image/recapture-detect
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
用户的项目ID。获取方法请参见获取项目ID和名称。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
image |
否 |
String |
与url二选一。 图像数据，base64编码，要求base64编码后大小不超过10MB，最短边至少1px，最长边最大10000px，支持JPG、PNG、BMP格式。 |
url |
否 |
String |
与image二选一。 图片的URL路径，目前支持：
说明：
|
threshold |
否 |
Float |
判断图片真实或虚假的阈值，默认值为0.95，取值范围（0~1），输入非该范围内值算法即取默认值。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result |
result object |
调用成功时为图片标签内容。 调用失败时无此字段。 |
参数 |
参数类型 |
描述 |
|---|---|---|
suggestion |
String |
总体的结论。有三个取值：
|
category |
String |
标签。取值有以下两种情况：
|
score |
String |
总体置信度，取值范围为（0~1）。 |
detail |
Array of detail objects |
识别结果详情。 |
参数 |
参数类型 |
描述 |
|---|---|---|
label |
String |
标签值，固定为recapture，表示翻拍图。 |
confidence |
String |
置信度，表示是翻拍图的概率大小，取值范围为（0~1）。 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
- 方式一：使用图片的BASE64编码，检测出经过二次处理的不合规范图片，置信度的阈值为0.99。
POST https://{endpoint}/v2/{project_id}/image/recapture-detect { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "url" : "", "threshold" : 0.99 } - 方式二：使用图片URL，检测出经过二次处理的不合规范图片，置信度的阈值为0.99。
POST https://{endpoint}/v2/{project_id}/image/recapture-detect { "image" : "", "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "threshold" : 0.99 }
响应示例
状态码： 200
成功响应结果
{
"result" : {
"suggestion" : "false",
"category" : "recapture",
"score" : "0.9998",
"detail" : [ {
"label" : "recapture",
"confidence" : "0.9998"
} ]
}
}
状态码： 400
失败响应结果
{
"error_code" : "AIS.0105",
"error_msg" : "Recognize Failed"
}
状态码
状态码 |
描述 |
|---|---|
200 |
成功响应结果。 |
400 |
失败响应结果。 |
错误码
请参见错误码。
