文档首页> 内容审核 Moderation> API参考> API（废弃）> 扭曲校正
更新时间：2022-07-01 GMT+08:00
查看PDF

扭曲校正

功能介绍

仅支持识别拍摄的企业表单原始图片是否扭曲，并进行扭曲的校正。

前提条件

扭曲校正默认API调用最大并发为3，如需调整更高并发限制请联系华为专业工程师为您服务。

URI

URI格式

POST /v1.0/moderation/image/distortion-correct

请求消息

请求参数请参见表1。

表1 请求参数说明

名称

是否必选

类型

说明

image

与url二选一

String

图片文件Base64编码字符串。要求base64编码后大小不超过10M，支持JPG/PNG/BMP格式。

url

与image二选一

String

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

  • 公网HTTP/HTTPS URL
  • 华为云OBS提供的URL，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权。详请参见配置OBS访问权限。
说明：

接口响应时间依赖图片的下载时间，如果图片下载时间过长，会返回接口调用失败。请保证被审核图片所在的存储服务稳定可靠，建议您使用华为云OBS存储。

correction

否

Boolean

是否要进行图片扭曲校正。

  • true：校正。默认校正。
  • false：不进行校正。

响应消息

响应参数请参见表2。

表2 响应参数说明

名称

类型

说明

result

Object

调用成功时表示调用结果。

调用失败时无此字段。

distortion

Boolean

识别结果是否扭曲。

  • true：扭曲。
  • false：正常。

data

String

校正后的图片。格式为图片文件的Base64编码字符串。

如果图片正常，无需校正，或者输出参数中指明无需校正，则此处返回为空串。

error_code

String

调用失败时的错误码，具体请参见错误码。

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例(方式一，使用图片的BASE64编码)
    POST https://moderation.ap-southeast-1.myhuaweicloud.com/v1.0/moderation/image/distortion-correct
    
Request Header:      
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
Request Body:
{
 "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
"url": "", 
"correction":true
}
  • 请求示例(方式二，使用图片URL)
    POST https://moderation.ap-southeast-1.myhuaweicloud.com/v1.0/moderation/image/distortion-correct
    
Request Header:      
Content-Type:application/json
X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
Request Body:
{
 "image":"",
 "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName",
 "correction":true
}
  • 成功响应示例
    {
  "result":{
      "distortion": true,
      "data": "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAA..."
   }
}
  • 失败响应示例
    {
    "error_code": "AIS.0005",
    "error_msg": "The service does not exist."
}

状态码

  • 正常

    200

  • 失败

    返回值

    说明

    400
    • 语义有误，当前请求无法被服务器解析。除非进行修改，否则客户端不应重复提交这个请求。
    • 请求参数有误。

    401

    当前请求需要用户验证。

    403

    没有操作权限。

    404

    请求失败，在服务器上未找到请求所希望得到的资源。

    500

    服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。
父主题： API（废弃）