# 接口简介支持对合同、证件或票据中印章检测和字段识别，输出结构化信息。信息包括印章类型、印章颜色、印章位置、印章内文本。 # 限制条件 |名称 |内容 | |---|---| |输入要求 |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](https://visual.volcengineapi.com) | |请求方式 |POST | |Content\-Type |application/x\-www\-form\-urlencoded | |是否需要鉴权 |是 | ## 请求参数 ### header请求参数以下请求参数列表仅列出了接口请求参数和必要公共参数，完整公共参数列表见 [公共参数](https://www.volcengine.com/docs/6369/67268)。 |名称 |类型 |是否必填 |描述 | |---|---|---|---| |X\-Date |String |是 |使用UTC时间，精确到秒。请使用格式：`YYYYMMDD'T'HHMMSS'Z'` ，例如：`20201103T104027Z` | |Authorization |String |是 |HMAC\-SHA256：签名方法|\ | | | |\-**Credential**为签名凭证，其中:|\ | | | |\-**AccessKeyId**为访问密钥ID，可在 [访问密钥（Access Key）](https://www.volcengine.com/docs/6291/65568) 获取；|\ | | | |\-**ShortDate**为请求的短时间，使用UTC时间，精确到日。请使用格式：`YYYYMMDD`，例如：`20180201`；|\ | | | |\-**Region**为请求地区，国内一般为为`cn-north-1`；|\ | | | |\-**Service**为请求的服务，文字识别一般为`cv`；|\ | | | |\-**SignedHeaders**为参与签名计算的头部信息，`content-type` 和 `host` 为必选头部；|\ | | | |\-**Signature**为签名，可在 [签名方法](https://www.volcengine.com/docs/6369/67269) 获取。|\ | | | |注：我们提供了SDK及签名示例供您实现服务快速接入，具体可参考 [快速接入](https://www.volcengine.com/docs/6444/69729)|\ | | | |例如：`HMAC-SHA256 Credential={AccessKeyId}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}` | |X\-Security\-Token |String |否 |指安全令牌服务（Security Token Service，STS）颁发的临时安全凭证中的SessionToken，使用长期密钥时无需填写该参数。 | ### Query请求参数 |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |Action |**必选** |String |接口名，取值：OcrSeal | |Version |**必选** |String |版本号，取值：2021\-08\-23 | ### Body参数 |参数 |可选/必选 |类型 |说明 | |---|---|---|---| |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。 | # 输出说明 ## 通用输出参数请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) | ## 业务输出参数 ### data 字段说明 |字段 |类型 |说明 |备注 | |---|---|---|---| |seal_infos |Array of seal_info |检测到的每一个印章信息 |字段说明见下方 | ### 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文件时，以相对坐标的形式返回 | ## 输出示例 ### 主页面图片返回值示例 ```Plain Text { "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" } ``` # 错误码 ## 通用错误码请参考[通用返回字段及错误码](https://www.volcengine.com/docs/6444/69728) ## 业务错误码 |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" |输入图片错误 |

图像生成大模型