文档首页/图像识别 Image/API参考/API/翻拍识别-RunRecaptureDetect
更新时间：2025-12-08 GMT+08:00
查看PDF
分享

翻拍识别-RunRecaptureDetect

功能介绍

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

目前只支持华为系列商品的条形码的翻拍识别。

前提条件

  • 使用翻拍识别服务之前需要您完成服务申请和认证鉴权。
  • 图像识别服务属于公有云服务，线上用户资源共享，如果需要多并发请求，请提前联系我们。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/image/recapture-detect

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

用户的项目ID。获取方法请参见获取项目ID和名称。

约束限制：

不涉及。

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

image

否

String

参数解释：

用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

与url二选一。

图像数据，base64编码，要求base64编码后大小不超过10MB，最短边至少1px，最长边最大10000px，支持JPG、PNG、BMP格式。

url

否

String

参数解释：

用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

与image二选一。

图片的URL路径，目前支持：

  • 公网HTTP/HTTPS URL
  • 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS服务的访问权限。
说明：
  • 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。
  • lmage不支持跨区域OBS，OBS的区域需要和服务保持一致。

threshold

否

Float

参数解释：

用户Token。用于获取操作API的权限。获取方法请参见获取Token接口，响应消息头中X-Subject-Token的值即为Token。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

判断图片真实或虚假的阈值，默认值为0.95，取值范围（0~1），输入非该范围内值算法即取默认值。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

result

result object

参数解释：

调用成功时为图片标签内容。

调用失败时无此字段。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表5 result

参数

参数类型

描述

suggestion

String

参数解释：

总体的结论。

约束限制：

不涉及。

取值范围：

有三个取值：

  • true：真实，表明算法识别是原图。
  • false：虚假，表明算法识别是翻拍图。
  • uncertainty：不确定。

默认取值：

不涉及。

category

String

参数解释：

标签。

约束限制：

不涉及。

取值范围：

取值有以下两种情况：

  • 若suggestion字段为true时，category为空。
  • 若suggestion字段为false或者uncertainty时，category固定为recapture，表示可能为翻拍图。

默认取值：

不涉及。

score

String

参数解释：

总体置信度。

约束限制：

不涉及。

取值范围：

0-1。

默认取值：

不涉及。

detail

Array of detail objects

参数解释：

识别结果详情。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表6 detail

参数

参数类型

描述

label

String

参数解释：

标签值，固定为recapture，表示翻拍图。

约束限制：

不涉及。

取值范围：

固定为recapture。

默认取值：

不涉及。

confidence

String

参数解释：

置信度，表示是翻拍图的概率大小。

约束限制：

不涉及。

取值范围：

0-1。

默认取值：

不涉及。

状态码： 400

表7 响应Body参数

参数

参数类型

描述

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

失败响应结果。

错误码

请参见错误码。

父主题：API

相关文档