支持对合同、证件或票据中印章检测和字段识别，输出结构化信息。
信息包括印章类型、印章颜色、印章位置、印章内文本。
| 名称 | 内容 |
|---|---|
| 输入要求 | 1. 文件格式：支持JPG、JPEG、PNG、BMP、PDF等常见格式，建议使用JPG格式。 2. 文件大小： a.要求Base64编码和urlencode之后不超过 8 MB。 b.如果传图片及PDF完整URL，URL对应文件大小建议不要超过8MB。 3. 输入文件过大时，返回的HttpCode如下：400/413/502。 4. 输入多页PDF时，默认只识别第一页。 |
| 名称 | 内容 |
|---|---|
| 接口地址 | https://visual.volcengineapi.com |
| 请求方式 | POST |
| Content-Type | application/x-www-form-urlencoded |
| 是否需要鉴权 | 是 |
以下请求参数列表仅列出了接口请求参数和必要公共参数，完整公共参数列表见 公共参数。
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| X-Date | String | 是 | 使用UTC时间，精确到秒。请使用格式：YYYYMMDD'T'HHMMSS'Z' ，例如：20201103T104027Z |
Authorization | String | 是 | HMAC-SHA256：签名方法 |
| X-Security-Token | String | 否 | 指安全令牌服务（Security Token Service，STS） 颁发的临时安全凭证中的SessionToken，使用长期密钥时无需填写该参数。 |
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| Action | 必选 | String | 接口名，取值：OcrSeal |
| Version | 必选 | String | 版本号，取值：2021-08-23 |
| 参数 | 可选/必选 | 类型 | 说明 |
|---|---|---|---|
| image_base64 | 与image_url二选一 | String | 图片文件，base64编码 注意: 只需要传图片的base64值，类似data:image/png;base64的图片头不要传入 |
| image_url | 与image_base64二选一 | String | 图片/PDF文件的URL链接 注意: 要求image_base64与image_url二选一，如果2个字段都有，优先解析image_base64。 |
请参考通用返回字段及错误码 |
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| seal_infos | Array of seal_info | 检测到的每一个印章信息 | 字段说明见下方 |
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| seal_type | String | 印章类型 | seal_noise(不完整印章)/normal_seal(圆形印章)/ellipse_seal(椭圆印章) |
| seal_color | String | 印章颜色 | red(红章)/blue(蓝章)/black(黑白章) |
| curve_text | String | 文字信息 | 印章内部文字信息 |
| curve_text_poly | Array of points | 文本位置 | 外接多边形 注意: 输入是PDF文件时，以相对坐标的形式返回 |
| plain_text_1 | String | 税号 | 印章内部税号信息 |
| plain_text_1_poly | Array of points | 税号位置 | 外接多边形 注意: 输入是PDF文件时，以相对坐标的形式返回 |
| plain_text_2 | String | 专用章信息 | 印章内部专用章信息 |
| plain_text_2_poly | Array of points | 专用章信息位置 | 外接多边形 注意: 输入是PDF文件时，以相对坐标的形式返回 |
| poly | Array of points | 印章位置 | 印章的bbox角点 [左上,右上,右下,左下] 注意: 输入是PDF文件时，以相对坐标的形式返回 |
{ "code":10000, "data":{ "seal_infos":[ { "seal_type":"ellipse_seal", "seal_color":"red", "curve_text":"宁波迅途信息技术有限公司", "curve_text_poly":[ [641, 454], [641, 461], [655, 461], [656, 459], [657, 446], [661, 436], [665, 433], [675, 425], [682, 423], [697, 419], [722, 419], [740, 426], [749, 434], [756, 441], [758, 447], [758, 457], [760, 461], [772, 459], [773, 447], [771, 439], [764, 426], [753, 416], [745, 412], [730, 407], [717, 403], [706, 403], [679, 408], [659, 418], [651, 426], [646, 434], [642, 445] ] "plain_text_1":"913302820629019631", "plain_text_1_poly":[ [661, 447], [661, 458], [663, 459], [753, 459], [754, 458], [753, 457], [753, 446], [753, 446], [663, 446] ] "plain_text_2":"发票专用章", "plain_text_2_poly":[ 674, 470], [675, 471], [675, 476], [674, 476], [674, 485], [675, 486], [679, 486], [679, 485], [739, 485], [740, 484], [740, 482], [740, 481], [740, 476], [740, 476], [740, 471], [740, 471], [740, 469], [739, 469], [675, 469], [675, 470] ] "poly":[ [636, 399], [780, 399], [780, 506], [636, 506] ] }, ] }, "message":"Success", "request_id":"68465821727368171521594094134", "time_elapsed":"509.475088ms" }
请参考通用返回字段及错误码
| HttpCode | 错误码 | 错误消息 | 描述 |
|---|---|---|---|
| 200 | 10000 | 无 | 请求成功 |
| 400 | 50205 | "Image Size Exceeds Maximum Limit: please compress the image" | 输入文件过大 |
| 400 | 50206 | "Invalid Input Image: image is empty" | 输入图片为空 |
| 400 | 50207 | "Image Decode Error: image format unsupported" | 图片解码错误 |
| 400 | 50217 | "Process PDF File Error." | 处理PDF文件错误 |
| 400 | 60103 | "Missing Input Parameters: empty input image" | 输入图片为空 |
| 400 | 60301 | "Invalid Input Image: get input image error" | 获取图片错误 |
| 400 | 61301 | "Invalid Input Parameters: Input image can not be decoded" | 输入图片错误 |