低光照增强

功能介绍

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

前提条件

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

URI

URI格式

POST /v1.0/vision/dark-enhance

请求消息

响应消息

• 图片为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	服务器遇到了一个未曾预料的状况，导致无法完成对请求的处理。