文档首页 > > API参考> API(废弃)>

图像去雾

图像去雾

分享
更新时间:2021/01/26 GMT+08:00

功能介绍

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

前提条件

  • 在使用图像去雾服务之前需要您完成服务申请认证鉴权
  • 图像去雾默认API调用最大并发为1,如需调整更高并发限制请联系华为专业工程师为您服务。

URI

URI格式

POST /v1.0/vision/defog

请求消息

请求参数请参见表1
表1 请求参数说明

名称

是否必选

类型

说明

image

与file二选一

String

图片文件BASE64编码字符串。要求base64编码后大小不超过10MB,支持JPG、PNG、BMP格式。

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

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

    调用成功时无此字段。

    error_msg

    String

    调用失败时的错误信息。

    调用成功时无此字段。

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

    名称

    类型

    说明

    error_code

    String

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

    调用成功时无此字段。

    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

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

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问