翻拍识别

更新时间： 2019/08/06 17:24

功能介绍

零售行业通常根据零售店的销售量进行销售奖励，拍摄售出商品的条形码上传后台是常用的统计方式。翻拍识别利用深度神经网络算法判断条形码图片为原始拍摄，还是经过二次翻拍、打印翻拍等手法二次处理的图片。利用翻拍识别，可以检测出经过二次处理的不合规范图片，使得统计数据更准确、有效。

URI

URI格式

POST /v1.0/image/recapture-detect

请求消息

请求参数请参见表1。

表1 请求参数说明
名称	是否必选	类型	说明
image	与url二选一	String	图像数据，base64编码，要求base64编码后大小不超过10M，最短边至少15px，最长边最大4096px，支持JPG/PNG/BMP格式。
url	与image二选一	String	图片的URL路径，目前支持对服务授权访问华为云上OBS的URL，华为云上OBS提供的临时授权访问的URL和匿名公开授权的URL。OBS服务的访问权限设置请参见配置OBS服务的访问权限。说明：接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。
threshold	可选	Float	判断图片真实或虚假的阈值，默认值为0.95，取值范围：0-1，输入非该范围内值算法即取默认值。
scene	可选	List	检测场景，当前仅支持翻拍照片场景： recapture。该参数可以为空，为空返回所有的场景的检测结果。

响应消息

响应参数请参见表2。

表2 响应参数说明
名称	类型	说明
result	JSON	调用成功时为图片标签内容。调用失败时无此字段。
suggestion	String	总体的结论： true：真实 false：虚假 uncertainty：不确定
category	String	标签（如果suggestion为真时，则该值为空字符串，否则不为空）。 recapture：翻拍图
score	Float	总体置信度，取值范围 0-1.0。
detail	List	识别结果详情。
label	String	标签值。 original：原始图 recapture：翻拍图
confidence	Float	置信度，取值范围：0-1.0。
error_code	String	调用失败时的错误码，具体请参见错误码。调用成功时无此字段。
error_msg	String	调用失败时的错误信息。调用成功时无此字段。

示例

请求示例（方式一：使用图片的BASE64编码）

POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/recapture-detect
   
Request Header:  
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   

Request Body:
{
 "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
  "url": "",
  "threshold":0.99,
  "scene":["recapture"]
}

请求示例（方式二：使用图片URL）

POST https://image.cn-north-1.myhuaweicloud.com/v1.0/image/recapture-detect
   
Request Header:  
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   

Request Body:
{
  "image":"",
  "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName",
  "threshold":0.99,
  "scene":["recapture"]
}

成功响应示例

{
  "result": {
    "suggestion": "false",
    "category": "recapture",
    "score": "0.9998",
    "detail": [
      {
        "label": "recapture",
        "confidence": "0.9998"
      }
    ]
  }
}

失败响应示例

{
    "error_code": "AIS.0105",
    "error_msg": "Recognize Failed"
}

返回值

正常
200

失败

返回值	说明
400	语义有误，当前请求无法被服务器解析。除非进行修改，否则客户端不应重复提交这个请求。请求参数有误。
401	当前请求需要用户验证。
403	没有操作权限。
404	请求失败，在服务器上未找到请求所希望得到的资源。
500	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。