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

低光照增强

功能介绍

夜晚或光线暗区域拍摄的图像存在人眼或机器“看不清”暗光区域的情况。针对此类场景,低光照增强可以将图像的暗光区域增强,使得原来人眼不可见区域变得可见,突显图像中的有效视觉信息。使用时用户发送待处理图片,返回低光照增强后的结果图片。

前提条件

在使用低光照增强服务之前需要您完成服务申请认证鉴权

URI

URI格式

POST /v1.0/vision/dark-enhance

请求消息

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

名称

是否必选

类型

说明

image

与file二选一

String

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

file

与image二选一

File

图片文件。

说明:
  • 不推荐使用该请求参数。
  • 为了保持兼容服务端,对此类接口的支持能力,保留该请求参数,但不再展示该参数对应的请求示例和响应示例。

brightness

Float

亮度值,亮度值设置的越高,亮度越大。默认值0.9,取值范围[0,1]。

响应消息

  • 图片为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/dark-enhance
        
    Request Header:   
    Content-Type:application/json
    X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
         
    Request Body:
    {
      "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj...",
      "brightness":0.9
    }
  • 成功响应示例
    {
     "result":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAAUAAAABAAAAagEoAAMAAAABAAIAAAExAAIAAAAcAAAAcgEyAAIAAAAUAAAAjodpAAQAAAABAAAApAAAANAACvyAAAAnEAAK/IAAACcQQWRvYmUgUGhvdG9zaG9wIENTMyBXaW5kb3dzADIwMTc6MTA6MjAgMTA6NDU6MzYAAAAAA6ABAAMAAAAB//8AAKACAAQAAAABAAALIKADAAQAAAABAAAGQAAAAAAAAAAGAQMAAwAAAAEABgAAARoABQAAAAEAAAEeARsABQAAAAEAAAEmASgAAwAAAAEAAgAAAgEABAAAAAEAAAEuAgIABAAAAAEAABAj..."
    }
  • 失败响应示例
    {
        "error_code": "AIS.0105",
        "error_msg": "Recognize Failed"
    }

返回值

  • 正常

    200

  • 失败

    返回值

    说明

    400

    • 语义有误,当前请求无法被服务器解析。除非进行修改,否则客户端不应重复提交这个请求。
    • 请求参数有误。

    401

    当前请求需要用户验证。

    403

    没有操作权限。

    404

    请求失败,在服务器上未找到请求所希望得到的资源。

    500

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