超分图像重建

功能介绍

图像在成像过程中存在像素过少导致的视觉信息不够或者由于压缩导致的图像信息丢失的情况。针对此类场景，超分图像重建基于深度学习算法，对图像中缺失的视觉信息进行补充，使得图像视觉效果更好。使用时用户发送待处理图片，返回经过超分图像重建后的结果图片。

前提条件

在使用超分图像重建服务之前需要您完成服务申请和认证鉴权。

URI

URI格式

POST /v1.0/vision/super-resolution

请求消息

响应消息

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

  表2 响应参数说明

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

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

  表3 响应参数说明

  名称	类型	说明
  error_code	String	调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。
  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	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。