清晰度检测
功能介绍
仅支持识别拍摄的企业表单原始图片是清晰还是模糊,并基于此构建图片审核系统。
前提条件
清晰度检测默认API调用最大并发为3,如需调整更高并发限制请联系华为专业工程师为您服务。
URI
URI格式
POST /v1.0/moderation/image/clarity-detect
请求消息
请求参数请参见表1。
名称 |
是否必选 |
类型 |
说明 |
---|---|---|---|
image |
与url二选一 |
String |
图片文件Base64编码字符串。要求base64编码后大小不超过10M,支持JPG/PNG/BMP格式。 |
url |
与image二选一 |
String |
图片的URL路径,目前支持:
说明:
接口响应时间依赖图片的下载时间,如果图片下载时间过长,会返回接口调用失败。请保证被审核图片所在的存储服务稳定可靠,建议您使用华为云OBS存储。 |
threshold |
否 |
Number |
判断图片是否清晰的阈值,取值范围 0-1,如果不设置,默认值为0.8。 |
响应消息
响应参数说明请参见表2。
名称 |
类型 |
说明 |
---|---|---|
result |
Object |
调用成功时表示调用结果。 调用失败时无此字段。 |
category |
String |
结果判定标签。
|
detail |
List |
检测结果详情。 |
label |
String |
标签名。
|
confidence |
Number |
置信度,取值范围 0-1。 |
error_code |
String |
调用失败时的错误码,具体请参见错误码。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
示例
- 请求示例(方式一,使用图片的BASE64编码)
POST https://moderation.cn-north-1.myhuaweicloud.com/v1.0/moderation/image/clarity-detect Request Header: Content-Type:application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...", "url": "", "threshold":0.8 }
- 请求示例(方式二,使用图片URL)
POST https://moderation.cn-north-1.myhuaweicloud.com/v1.0/moderation/image/clarity-detect Request Header: Content-Type:application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"", "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName", "threshold":0.8 }
- 成功响应示例
{ "result":{ "category": "blur", "detail": [ { "label":"clarity", "confidence":0.2907 }, { "label":"blur", "confidence":0.7093 } ] } }
- 失败响应示例
{ "error_code": "AIS.0005", "error_msg": "The service does not exist." }