更新时间:2024-04-18 GMT+08:00

超分图像重建

功能介绍

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

前提条件

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

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

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

    调用成功时无此字段。

    error_msg

    String

    调用失败时的错误信息。

    调用成功时无此字段。

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

    名称

    类型

    说明

    error_code

    String

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

    调用成功时无此字段。

    error_msg

    String

    调用失败时的错误信息。

    调用成功时无此字段。

示例

  • 请求示例(方式一:使用图片的BASE64编码)
    POST https://image.ap-southeast-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.ap-southeast-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

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