# 翻拍识别 #### 功能介绍 零售行业通常根据零售店的销售量进行销售奖励，拍摄售出商品的条形码上传后台是常用的统计方式。翻拍识别利用深度神经网络算法判断条形码图片为原始拍摄，还是经过二次翻拍、打印翻拍等手法二次处理的图片。利用翻拍识别，可以检测出经过二次处理的不合规范图片，使得统计数据更准确、有效。 ![](https://support.huaweicloud.com/api-image/public_sys-resources/note_3.0-zh-cn.png) 目前只支持华为系列商品的条形码的翻拍识别。 #### URI URI格式 POST /v1.0/image/recapture-detect #### 请求消息 请求参数请参见[表1]。 表1请求参数说明 | 名称 | 是否必选 | 类型 | 说明 | |:---|:---|:---|:---| | image | 与url二选一 | String | 图像数据，base64编码，要求base64编码后大小不超过10MB，最短边至少15px，最长边最大4096px，支持JPG、PNG、BMP格式。 | | url | 与image二选一 | String | 图片的URL路径，目前支持： - 公网HTTP/HTTPS URL - 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见[配置OBS服务的访问权限](https://support.huaweicloud.com/api-moderation/moderation_03_0020.html)。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云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）。 | | detail | List | 识别结果详情。 | | label | String | 标签值。 - original：原始图 - recapture：翻拍图 | | confidence | Float | 置信度，取值范围（0\~1）。 | | error_code | String | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-image/image_03_0010.html)。 调用成功时无此字段。 | | 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://.obs..myhuaweicloud.com/", "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 | 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。 | #### 错误码 错误码请参见 [错误码](https://support.huaweicloud.com/api-image/image_03_0010.html)。