# 超分图像重建
#### 功能介绍
图像在成像过程中存在像素过少导致的视觉信息不够或者由于压缩导致的图像信息丢失的情况。针对此类场景，超分图像重建基于深度学习算法，对图像中缺失的视觉信息进行补充，使得图像视觉效果更好。使用时用户发送待处理图片，返回经过超分图像重建后的结果图片。
#### 前提条件
在使用超分图像重建服务之前需要您完成[服务申请](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/super-resolution
#### 请求消息
请求参数请参见[表1]。
 表1请求参数说明 
| 名称    | 是否必选      | 类型      | 说明                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| image | 与file二选一  | String  | 图片文件BASE64编码字符串。要求base64编码后大小不超过10MB，支持JPEG/PNG/BMP格式。                                                                                                                                                                                                                                                                                |
| file  | 与image二选一 | File    | 图片文件。                                                                                                                                                                                                                                                                                                                                 |
| scale | 否         | Integer | 放大倍数，默认为3，取值范围：3或4。                                                                                                                                                                                                                                                                                                                   |
| model | 否         | String  | 图像超分辨率重建采用的算法模式，支持ESPCN和SRCNN，默认ESPCN。 取值为： "ESPCN"：Efficient Sub-Pixel Convolutional Neural Network。 "SRCNN"： Super-Resolution Convolutional Neural Network。 |
   
#### 响应消息
- 图片为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/super-resolution
      
  Request Header:      
  Content-Type:application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...   
  Request Body:
  {  "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
    "scale":3,
    "model":"ESPCN"
  }
  ```
  
- 请求示例（方式二：使用图片文件）
  ```
  POST https://image.cn-north-1.myhuaweicloud.com/v1.0/vision/super-resolution
      
  Request Header:      
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
       
  Request Body(form-data):
  file:File(图片文件)
  scale:3
  model:ESPCN
  ```
  
方式一：图片为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 | 服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。                                                                                                                                                                                                                                                                                                                 |