"en": "sky", "zh": "天空"
},
"type": "object"
}, {
"confidence": 25.75, "tag":"landscape", "i18n_tag":
{
"en": "landscape", "zh": "风景"
},
"type": "scene"
} ] } }
● 失败响应示例
{ "error_code": "AIS.0014",
"error_msg": "The JSON format of the input data is incorrect."
}
返回值
● 正常 200
● 失败
返回值 说明
400 ● 语义有误，当前请求无法被服务器解析。除非进行修改，否则 客户端不应重复提交这个请求。
● 请求参数有误。
401 当前请求需要用户验证。
403 没有操作权限。
404 请求失败，在服务器上未找到请求所希望得到的资源。
500 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。
错误码
错误码请参见 错误码。
5.2 翻拍识别
功能介绍
零售行业通常根据零售店的销售量进行销售奖励，拍摄售出商品的条形码上传后台是 常用的统计方式。翻拍识别利用深度神经网络算法判断条形码图片为原始拍摄，还是
经过二次翻拍、打印翻拍等手法二次处理的图片。利用翻拍识别，可以检测出经过二 次处理的不合规范图片，使得统计数据更准确、有效。
说明
目前只支持华为系列商品的条形码的翻拍识别，如有其他业务场景，请提交工单联系技术服务人 员。
前提条件
● 在使用翻拍识别服务之前需要您完成服务申请和认证鉴权。
● 翻拍识别默认API调用最大并发为1，如需调整更高并发限制请联系华为专业工程 师为您服务。
URI
URI格式
POST /v1.0/image/recapture-detect
请求消息
请求参数请参见表5-3。
表5-3 请求参数说明
名称 是否必选 类型 说明 image 与url二选
一 String 图像数据，base64编码，要求base64编码后大小不 超过10MB，最短边至少15px，最长边最大
4096px，支持JPG、PNG、BMP格式。
url 与image 二选一
String 图片的URL路径，目前支持：
● 公网HTTP/HTTPS URL
● 华为云OBS提供的URL，使用OBS数据需要进行 授权。包括对服务授权、临时授权、匿名公开授 权。详请参见配置OBS服务的访问权限。
说明
接口响应时间依赖于图片的下载时间，如果图片下载时间 过长，会返回接口调用失败。
请保证被检测图片所在的存储服务稳定可靠，建议您使用 华为云OBS存储。
thresh
old 可选 Float 判断图片真实或虚假的阈值，默认值为0.95，取值 范围（0~1），输入非该范围内值算法即取默认值。
scene 可选 List 检测场景，当前仅支持翻拍照片场景： recapture。
该参数可以为空，为空返回所有的场景的检测结 果。
响应消息
响应参数请参见表5-4。
表5-4 响应参数说明
名称 类型 说明
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 调用失败时的错误码，具体请参见错误码。
调用成功时无此字段。
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/
4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAag EoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAA AnEAAK/
IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAA AA6ABAAMAAAAB//
8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAA AEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...", "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.<region>.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 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。
错误码
错误码请参见 错误码。