印章检测识别
功能描述
印章检测识别
请求URL
https://api.textin.com/ai/service/v1/recognize_stamp
HTTP请求方法
HTTP POST
请求头说明(Request Header)
请在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
| 参数名 | 数据类型 | 是否必填 | 允许的值 | 描述 |
|---|---|---|---|---|
| edge_extension | integer | 否 | 见描述 |
边缘外扩:将印章切图外扩,设置范围0~100;不设置则默认为0不外扩,按照百分比进行外扩; |
| rectify_image | integer | 否 | 见描述 |
是否返回印章展平图片,默认rectify_image=0;如rectify_image=1,在Responses中返回rectify_image字段;如rectify_image=0,在Responses中不返回rectify_image字段;(圆章、椭圆章进行展平,其他印章不展平) |
请求体说明(Request Body)
支持以下两种请求格式
1. Content-Type: application/octet-stream
要上传的图片,目前支持jpg, png, bmp, pdf, tiff, 单帧gif等大部分格式.
请注意,请求体的数据格式为本地文件的二进制流,非 FormData 或其他格式。文件大小不超过 10M,图像宽高须介于 20 和 10000(像素)之间。
2. Content-Type: text/plain
请求体的数据格式为文本,内容为在线文件的URL链接(支持http以及https协议)。在线文件大小不超过 10M,图像宽高须介于 20 和 10000(像素)之间。
响应体说明 (Response Data)
Content-Type: application/json
JSON结构说明如下:
说明:所有接口响应中均包含字段 x_request_id(string类型),作为请求的唯一标识。
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | integer | 错误码,详见“错误码说明” |
| message | string |
错误信息 |
| duration | number |
服务时间消耗,单位是毫秒(ms)。 |
| result | object | |
| + angle | integer |
图片角度,指原图需要经过顺时针旋转多少度,才能得到正方向的图片 【圆章和椭圆章不输出角度,默认为0度】 |
| + width | integer |
输入图像的宽度 |
| + height | integer |
输入图像的高度 |
| + type | string |
当前接口类型
|
| + details | object |
图片OCR识别结果 |
| ++ stamp | array |
印章识别 |
| +++ type | string |
当前印章类型
|
| +++ color | string |
当前印章颜色
|
| +++ stamp_shape | string |
当前印章形状
|
| +++ value | string |
字段识别结果 |
| +++ image | string |
印章切图(jpg图片的base64编码) |
| +++ rectify_image | string |
印章展平图片(jpg图片的base64编码)【圆章、椭圆章进行展平,其他印章类型不展平,返回空】 |
| +++ position | array |
识别的value在原图中的坐标是个长度为8的数组 [0,1,2,3,4,5,6,7]
|