文档首页> > API参考> API说明> 扭曲校正

扭曲校正

更新时间: 2018-12-05 17:20

功能介绍

可识别拍摄的企业表单等原始图片是否扭曲,并进行扭曲的校正。

URI

URI格式

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

请求消息

请求参数请参见表1

表1 请求参数说明

名称

是否必选

类型

说明

image

与url二选一

String

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

url

与image二选一

String

图片的URL路径,目前支持对服务授权访问华为云上OBS的URL,华为云上OBS提供的临时授权访问的URL和匿名公开授权的URL。OBS服务的访问权限设置请参考A.2 配置OBS服务的访问权限

出于安全的考虑,当前服务不支持从公网上任意URL读取数据。

correction

Boolean

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

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

响应消息

响应参数请参见表2

表2 响应参数说明

名称

类型

说明

result

Object

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

调用失败时无此字段。

distortion

Boolean

识别结果是否扭曲。

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

data

String

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

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

error_code

String

调用失败时的错误码,具体请参考错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例(方式一,使用图片的BASE64编码)
    POST https://ais.cn-north-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://ais.cn-north-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.myhwclouds.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

    服务器遇到了一个未曾预料的状况,导致无法完成对请求的处理。

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

在文档使用中是否遇到以下问题







请至少选择或填写一项反馈信息

字符长度不能超过100

反馈内容不能为空!

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区
点我,12·12惊喜等着你哦~