文档图像切边增强矫正
功能描述
文档图像切边增强矫正
文档图像切边矫正与图片切边增强合并产品;边缘背景去除,文档图像形变矫正,增强显示效果。
请求URL
https://api.textin.com/ai/service/v1/crop_enhance_image
HTTP请求方法(Method)
HTTP POST
请求头说明(Request Headers)
请在HTTP请求中添加以下自定义标头(Header)。
| header 名 | 值 |
|---|---|
| x-ti-app-id | 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id |
| x-ti-secret-code | 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code |
URL参数(Parameters)
URL参数指以{参数名}={参数值} 形式拼接到 URL 上的键值对。它以?开头,不同参数之间使用&连接。形如?p1=v1&p2=v2
| 参数名 | 数据类型 | 是否必填 | 允许的值 | 描述 |
|---|---|---|---|---|
| enhance_mode | integer | 否 | -1, 1, 2, 3, 4, 5, 6 |
|
| crop_image | integer | 否 | 0, 1 |
|
| only_position | integer | 否 | 0, 1 |
|
| dewarp_image | integer | 否 | 0, 1 |
|
| deblur_image | integer | 否 | 0, 1 |
|
| correct_direction | integer | 否 | 0, 1 |
|
| round_image | integer | 否 | 0, 1 |
|
| jpeg_quality | integer | 否 | 见描述 |
支持切边图片压缩率设置,建议设置范围65~100;不设置则默认为95 |
| size_and_positon | string | 否 | 见描述 |
支持客户端传入宽高及座标,根据传的切图宽高和座标点来切边 格式 width,height,x1,y1,x2,y2,x3,y3,x4,y4
|
请求体说明(Request Body)
支持以下两种请求格式
1. Content-Type: application/octet-stream
要上传的图片,目前支持jpg, png, bmp, webp, pdf, tiff, 单帧gif等大部分格式。
请注意,请求体的数据格式为本地文件的二进制流,非 FormData 或其他格式。文件大小不超过 50M,图像宽高须介于 20 和 10000(像素)之间。
2. Content-Type: text/plain
请求体的数据格式为文本,内容为在线文件的URL链接(支持http以及https协议)。在线文件大小不超过 50M,图像宽高须介于 20 和 10000(像素)之间。
响应体说明 (Response)
Content-Type: application/json
JSON结构说明如下:
说明:所有接口响应中均包含字段 x_request_id(string类型),作为请求的唯一标识。
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | integer | 错误码,详见“错误码说明” |
| message | string |
错误信息 |
| version | string |
接口版本号 |
| duration | number |
接口耗时计算,时间单位是毫秒(ms) |
| result | object | |
| + origin_width | integer |
原图的宽 |
| + origin_height | integer |
原图的高 |
| + image_list | array |
处理后的图像内容 |
| ++ cropped_width | integer |
图像处理后的宽 |
| ++ cropped_height | integer |
图像处理后的高 |
| ++ image | string |
图像处理后的jpg图片,base64格式 |
| ++ position | array |
切图区域的4个角点坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7]
|
| ++ angle | integer |
图像角度,correct_direction=1时生效 定义0度为人类阅读文字的图像方向,称为正置图像, 本字段表示输入图像是正置图像进行顺时针若干角度的旋转所得。
|