# 图像去雾
#### 功能介绍
摄像机在雾霾天气拍摄照片时，不可避免出现图像质量不高、拍摄场景不清晰的情况。针对此类场景，图像去雾算法进行针对性的去雾处理，除了可以去除均匀雾霾外，还可以处理非均匀的雾霾。使用时用户发送待处理图片，返回经过去雾处理后的结果图片。
#### 前提条件
在使用图像去雾服务之前需要您完成[服务申请](https://support.huaweicloud.com/api-image/image_03_0018.html)和[认证鉴权](https://support.huaweicloud.com/api-image/image_03_0003.html)。
#### URI
URI格式
POST /v1.0/vision/defog
#### 请求消息
请求参数请参见[表1]。
 表1请求参数说明 
| 名称           | 是否必选      | 类型      | 说明                                                          |
|:---|:---|:---|:---|
| image        | 与file二选一  | String  | 图片文件BASE64编码字符串。要求base64编码后大小不超过10MB，支持JPEG、PNG、BMP、WEBP格式。 |
| file         | 与image二选一 | File    | 图片文件。                                                       |
| gamma        | 否         | Float   | gamma矫正值，默认为1.5，取值范围：\[0.1,10\]。                            |
| natural_look | 否         | Boolean | 是否保持自然观感，默认是true。如果选择false，则图像只追求去雾效果，图像视觉效果可能不自然。          |
   
#### 响应消息
- 图片文件为BASE64字符串响应参数请参见[表2]。
   表2响应参数说明 
  | 名称         | 类型     | 说明                                                                                                                            |
  |:---|:---|:---|
  | result     | String | 调用成功时表示图片文件BASE64字符串。 调用失败时无此字段。                                                              |
  | error_code | String | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-image/image_03_0010.html)。 调用成功时无此字段。 |
  | error_msg  | String | 调用失败时的错误信息。 调用成功时无此字段。                                                                       |
     
  
- 图片为文件类型响应参数请参见[表3]。
   表3响应参数说明 
  | 名称         | 类型     | 说明                                                                                                                              |
  |:---|:---|:---|
  | error_code | String | 调用失败时的错误码，具体请参见[错误码](https://support.huaweicloud.com/api-image/image_03_0010.html)。 调用成功时无此字段。 |
  | error_msg  | String | 调用失败时的错误信息。 调用成功时无此字段。                                                                         |
     
  
 
#### 示例
- 请求示例（方式一：使用图片的BASE64编码）
  ```
  POST https://image.cn-north-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.cn-north-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 | 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。                                                                                                                                                                                                                                                                                                                         |