翻拍识别
功能介绍
零售行业通常根据零售店的销售量进行销售奖励,拍摄售出商品的条形码上传后台是常用的统计方式。翻拍识别利用深度神经网络算法判断条形码图片为原始拍摄,还是经过二次翻拍、打印翻拍等手法二次处理的图片。利用翻拍识别,可以检测出经过二次处理的不合规范图片,使得统计数据更准确、有效。
URI
URI格式
POST /v1.0/image/recapture-detect
请求消息
名称 |
是否必选 |
类型 |
说明 |
---|---|---|---|
image |
与url二选一 |
String |
图像数据,base64编码,要求base64编码后大小不超过10MB,最短边至少15px,最长边最大4096px,支持JPG、PNG、BMP格式。 |
url |
与image二选一 |
String |
图片的URL路径,目前支持:
说明:
接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。 |
threshold |
可选 |
Float |
判断图片真实或虚假的阈值,默认值为0.95,取值范围(0~1),输入非该范围内值算法即取默认值。 |
scene |
可选 |
List |
检测场景,当前仅支持翻拍照片场景: recapture。该参数可以为空,为空返回所有的场景的检测结果。 |
响应消息
名称 |
类型 |
说明 |
---|---|---|
result |
JSON |
调用成功时为图片标签内容。 调用失败时无此字段。 |
suggestion |
String |
总体的结论:
|
category |
String |
标签(如果suggestion为真时,则该值为空字符串,否则不为空)。 recapture:翻拍图 |
score |
Float |
总体置信度,取值范围(0~1)。 |
detail |
List |
识别结果详情。 |
label |
String |
标签值。
|
confidence |
Float |
置信度,取值范围(0~1)。 |
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" }
返回值
错误码
错误码请参见 错误码。
