文字识别 OCR-机动车销售发票识别:请求参数

时间:2024-04-15 09:41:19

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。

Content-Type

String

发送的实体的MIME类型,参数值为“application/json”。

Enterprise-Project-Id

String

企业项目ID。OCR支持通过企业项目管理(EPS)对不同用户组和用户的资源使用,进行分账。

获取方法:进入“企业项目管理”页面,单击企业项目名称,在企业项目详情页获取Enterprise-Project-Id(企业项目ID)。

企业项目创建步骤请参见用户指南。

说明:

创建企业项目后,在传参时,有以下三类场景。

  • 携带正确的ID,正常使用OCR服务,账单归到企业ID对应的企业项目中。
  • 携带错误的ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。
  • 不携带ID,正常使用OCR服务,账单的企业项目会被分类为“未归集”。
表3 请求Body参数

参数

是否必选

参数类型

说明

image

String

该参数与url二选一。

图片的Base64编码,要求Base64编码后大小不超过10MB。

图片最短边不小于100px,最长边不超过8000px。支持JPEG、JPG、PNG、BMP、TIFF、PDF格式。多页PDF仅识别第一页。

图片Base64编码示例如/9j/4AAQSkZJRgABAg...,带有多余前缀会产生The image format is not supported报错。

url

String

该参数与image二选一。图片的url路径,目前支持:

  • 公网http/https url
  • OBS提供的url,使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权,详情参见配置OBS访问权限
说明:
  • 接口响应时间依赖于图片的下载时间,如果图片下载时间过长,会返回接口调用失败。
  • 请保证被检测图片所在的存储服务稳定可靠,推荐使用OBS服务存储图片数据。
  • url中不能存在中文字符,若存在,中文需要进行utf8编码。

return_text_location

Boolean

如果为True,返回体中会包含text_location对象,内容是各字段的检测框四点坐标。

如果为False或者没有这个key,返回体中不包含text_location对象。

return_confidence

Boolean

如果为True,返回体中包含confidence对象,内容是各字段的置信度。

如果为False或者没有这个key,返回体中不包含confidence对象。

type

String

如果没有type字段则默认返回原机动车销售发票出参。

如果存在type字段但是不属于 auto、new或者used三个枚举值,API返回AIS.0101入参错误。

如果type为auto,API自动判断发票类型,并在返回参数中添加type出参以指明发票类型。

如果type为new,API在检测出的类型为机动车发票时返回原版机动车发票出参并添加type出参(机动车销售统一发票),不一致时报错AIS.0104图像质量差。

如果type为used,API在检测出的类型为二手车时返回二手车发票出参,并添加type出参(二手车销售统一发票),不一致时报错AIS.0104图像质量差。

support.huaweicloud.com/api-ocr/ocr_03_0041.html