图像去雾

功能介绍

摄像机在雾霾天气拍摄照片时，不可避免出现图像质量不高、拍摄场景不清晰的情况。针对此类场景，图像去雾算法进行针对性的去雾处理，除了可以去除均匀雾霾外，还可以处理非均匀的雾霾。使用时用户发送待处理图片，返回经过去雾处理后的结果图片。

前提条件

在使用图像去雾服务之前需要您完成服务申请和认证鉴权。

URI

URI格式

POST /v1.0/vision/defog

请求消息

响应消息

• 图片文件为BASE64字符串响应参数请参见表2。

  表2 响应参数说明

  名称	类型	说明
  result	String	调用成功时表示图片文件BASE64字符串。 调用失败时无此字段。
  error_code	String	调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。
  error_msg	String	调用失败时的错误信息。 调用成功时无此字段。

• 图片为文件类型响应参数请参见表3。

  表3 响应参数说明

  名称	类型	说明
  error_code	String	调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。
  error_msg	String	调用失败时的错误信息。 调用成功时无此字段。

示例

• 请求示例（方式一：使用图片的BASE64编码）

  POST https://image.ap-southeast-1.myhuaweicloud.com/v1.0/vision/defog
      
  Request Header:   
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...    
  Request Body:
  {
    "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
    "gamma":1.5,
    "natural_look":true
  }

• 请求示例（方式二：使用图片文件）

  POST https://image.ap-southeast-1.myhuaweicloud.com/v1.0/vision/defog
      
  Request Header:   
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... 
   
  Request Body(form-data):
  file:File(图片文件)
  gamma:1.5
  natural_look:true

方式一：图片文件为BASE64字符串。

• 成功响应示例

  {
   "result":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..."
  }

• 失败响应示例

  {
      "error_code": "AIS.0105",
      "error_msg": "Recognize Failed"
  }

方式二：图片为文件类型。

• 响应样例

  成功时返回图片文件字节流。

• 失败响应样例

  {
      "error_code": "AIS.0105",
      "error_msg": "Recognize Failed"
  }

返回值

• 正常

  200

• 失败

  返回值	说明
  400	语义有误，当前请求无法被服务器解析。除非进行修改，否则客户端不应重复提交这个请求。 请求参数有误。
  401	当前请求需要用户验证。
  403	没有操作权限。
  404	请求失败，在服务器上未找到请求所希望得到的资源。
  500	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。