图像增强

对文档图像进行增强，默认返回类似文档扫描件的效果。支持多种增强模式，可选择智能增强（类似扫描件），智能增强并锐化，黑白等。

请求URL

POST /v1/document/enhance

请求参数

参数名	数据类型	是否必填	描述
image	file	是	文档图片。目前支持jpg, png, bmp等大部分格式，请注意，请求体的数据格式为FormData 格式。文件大小不超过 10M，图像宽高须介于 50 到 10000（像素）之间。当dewarp为False时，建议传入切边矫正后的图像。否则，直接传入未切变矫正的图像。
enhance_mode	int	否	● 1 智能增强 ● 2 智能增亮并锐化 ● 3 黑白默认使用智能增强。
dewarp	bool	否	是否切边矫正，默认为False。
corners	array	否	文档的4个顶点坐标。该数据由“文档顶点坐标”返回，你也可以修改顶点坐标，实现自定义切边。

请求示例

curl --location --request POST 'localhost:8000/api/document/enhance' --header 'Content-Type: multipart/form-data; boundary=--------------------------994702659308423812684350' --form 'image=@/data/your-image.jpg' --form 'dewarp=true' --form 'enhance_mode=1'

响应参数

参数名	数据类型	描述
code	int	0代表正常返回，其他返回值详见错误码说明。
data	object
enhanced_image	string	切边矫正后的图片, 以base64形式返回。
origin_width	int	原图的宽。
origin_height	int	原图的高。
corners	array	文档的4个顶点坐标。如果没有检测到文档，则corners返回的顶点坐标为原始输入图片的4个角的坐标。

响应示例

{
  "code": 0,
  "data": {
    "enhanced_image": "image_encoded-by_base64",
    "origin_width": 3024,
    "origin_height": 4032,
    "corners": [
      [
        282,
        6
      ],
      [
        282,
        3991
      ],
      [
        2619,
        6
      ],
      [
        2619,
        3991
      ]
    ]
  }
}