华为云用户手册

URI POST /v2/{project_id}/ocr/auto-classification 表2 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

功能介绍 检测定位图片上指定要识别的票证（票据、证件或其他文字载体），并以JSON格式返回识别的结构化结果。 接口以列表形式返回图片上要识别票证的位置坐标、结构化识别的内容以及对应的类别。该接口支持的票证类型请见表1，该接口的使用限制请参见约束与限制，详细使用指导请参见OCR服务使用简介章节。 图1 智能分类示例图 表1 支持票证类型 票证类型 身份证头像面 银行卡 身份证国徽面 道路运输证 行驶证主页 增值税发票（含全电发票） 行驶证副页 增值税普通发票（卷票） 驾驶证主页 机动车销售统一发票 驾驶证副页 出租车发票 护照 火车票 车辆通行费发票 定额发票 飞机行程单 车船票 网约车行程单 通用机打发票 增值税发票（销货清单） - 智能分类服务只对识别成功的票证进行计费，识别失败的票证不计费。例如，图片中包含三张票证，有两张识别成功，一张识别失败，此时接口计费两次。

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，VIN码识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/vin”，“project_id”为项目ID，获取方法请参见获取项目ID 如何获取Token请参见认证鉴权。 传入车架号VIN码图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/vin Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } 传入车架号VIN码图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/vin Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" }

URI POST /v2/{project_id}/ocr/vin 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

请求参数 表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。 图片最短边不小于15px，最长边不超过4096px，支持JPEG、JPG、PNG、BMP、TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 url 否 String 该参数与image二选一。图片的url路径，目前支持： 公网http/https url OBS提供的url，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权，详情参见配置OBS访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 url中不能存在中文字符，若存在，中文需要进行utf8编码。

响应参数 根据识别的结果，可能有不同的HTTP响应状态码（status code）。例如，200表示API调用成功，400表示调用失败，详细的状态码和响应参数说明如下。 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result VINResult object 识别结果。 调用失败时不返回此字段。 表5 VINResult 参数 参数类型 描述 vin String 识别检测到的车架号。 状态码： 400 表6 响应Body参数 参数 参数类型 说明 error_code String 调用失败时的错误码，具体请参见错误码。 当出现错误码“ModelArts.4204”时，请参考为什么调用API时提示“ModelArts.4204”？章节。 调用成功时不返回此字段。 error_msg String 调用失败时返回的错误信息。 调用成功时不返回此字段。

URI POST /v2/{project_id}/ocr/colombia-id-card 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

请求示例 Endpoint即调用API的请求地址，不同服务不同区域的Endpoint不同，具体请参见终端节点。 例如，哥伦比亚身份证识别服务部署在“拉美-圣地亚哥”区域的“endpoint”为“ocr.la-south-2.myhuaweicloud.com”，请求URL为“https://ocr.la-south-2.myhuaweicloud.com/v2/{project_id}/ocr/colombia-id-card”，“project_id”为项目ID，获取方法请参见获取项目ID。 如何获取Token请参见认证鉴权。 传入哥伦比亚身份证图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/colombia-id-card Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } 传入哥伦比亚身份证图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/colombia-id-card Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName" }

响应示例 状态码： 200 成功响应示例 { "result" : { "side" : "front", "number" : "1.039xxxx", "name" : "VALENxxx", "last_name" : "SANCHxxxx", "confidence" : { "number" : 0.9888, "name" : 0.9969, "last_name" : 0.9959 } } } 状态码： 400 失败响应样例 { "error_code" : "AIS.0103", "error_msg" : "The image size does not meet the requirements." }

约束与限制 支持哥伦比亚身份证的识别。 只支持识别PNG、JPG、JPEG、BMP、TIFF格式图片。 图像各边的像素大小在15px到8000px之间。 图像中身份证区域有效占比超过80%，保证整张身份证内容及其边缘包含在图像内。 支持图像中身份证任意角度的水平旋转。 支持少量扭曲，扭曲后图像中的身份证长宽比与实际身份证相差不超过10%。 能处理反光、暗光等干扰的图片但影响识别精度。 目前只支持识别单张身份证的正面或者反面。

响应示例 状态码： 200 成功响应样例 { "result" : { "template_id" : "43580526-658f-11ed-863a-0242ac11000b", "template_name" : "3", "confidence" : 0.4057 }, "template_id" : "43580526-658f-11ed-863a-0242ac11000b" } 状态码： 400 失败响应样例 { "error_code" : "AIS.0103", "error_msg" : "The image size does not meet the requirements." }

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，自定义模板OCR部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/custom-template”，“project_id”为项目ID，获取方法请参见获取项目ID 如何获取Token请参见认证鉴权。 传入自定义模板OCR的图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/custom-template Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...", "classifier_id" : "3bed12e0-7c1e-11ed-9bdb-0255ac10009d", "classifier_mode" : true } 传入自定义模板OCR的图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/custom-template Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName", "classifier_id" : "3bed12e0-7c1e-11ed-9bdb-0255ac10009d", "classifier_mode" : true }

请求参数 表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。图片最小边不小于15px，最长边不超过8192px，支持JPEG、JPG、PNG、BMP、TIFF、GIF、WEBP格式。 图片文件Base64编码字符串，单击这里查看详细获取方式。 url 否 String 与image二选一 图片的URL路径，目前支持： 公网http/https url OBS提供的url，使用OBS数据需要进行授权。包括对服务授权、临时授权、匿名公开授权，详情参见配置OBS访问权限。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。 template_id 否 String 该参数与classifier_id二选一。 模型id，如果传入，启用单模板识别模式。 classifier_id 否 String 该参数与template_id二选一。 分类器id，如果传入，启用多模板识别模式。 classifier_mode 否 Boolean 该参数与classifier_id参数配合使用，可选值如下所示： true：仅返回模板分类结果 false：正常返回多模板识别结果 说明： 如果未传入该参数时默认为false，即正常返回多模板识别结果。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result Object 调用成功时表示调用结果。 调用失败时无此字段。 template_id String 调用成功时返回调用模板id。 调用失败时无此字段。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参见错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

约束与限制 只支持识别PNG、JPG、PNG、BMP、TIFF、GIF、WEBP格式图片。 图像各边的像素大小在100px到8000px之间。 图像中识别区域有效占比超过80%，保证整张表格及其边缘包含在图像内。 支持图像任意角度的水平旋转。 目前不支持复杂背景（如户外自然场景、防伪水印等）和表格线扭曲图像的文字识别。 支持中英文以及部分繁体字。 API支持识别的图片版式依赖于创建自定义OCR工作流时的类型。

URI POST /v2/{project_id}/ocr/custom-template 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

请求示例 Endpoint即调用API的请求地址，不同服务不同区域的Endpoint不同，具体请参见终端节点。 例如，核酸检测记录服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/pcr-test-record”，“project_id”为项目ID，获取方法请参见获取项目ID。 如何获取Token请参见认证鉴权。 传入核酸检测记录图片的base64编码进行文字识别 POST https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/pcr-test-record Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." }

约束与限制 支持全国不同地区健康码小程序中的核酸检测记录界面的识别。 支持识别PNG、JPG、JPEG、BMP、TIFF格式图片。 图像各边的像素大小在15px到8192px之间。 图像中核酸检测记录区域有效占比超过80%，保证整张核酸检测记录内容及其边缘包含在图像内。 推荐采用手机截图图像。 支持图像中核酸检测记录界面任意角度的水平旋转（需开启方向检测）。 能处理反光、暗光等干扰的图片但影响识别精度。 目前只支持识别单张核酸检测记录界面。

URI POST /v2/{project_id}/ocr/pcr-test-record 表1 路径参数 参数 是否必选 描述 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

功能介绍 支持对全国各地不同版式的核酸检测记录中的4个关键字段进行结构化识别，包括姓名、核酸检测采样时间、检测检测结果更新时间、核酸检测结果（阳性、阴性、未知） 图1 核酸检测记录版式示例 防疫健康码识别已推出三码合一功能（健康码、核酸检测记录、行程卡）。相比于核酸检测记录识别API，您只需要调用1个接口，即可智能结构化识别健康码、核酸检测记录、行程卡等页面信息，包括防疫码类别、姓名、身份证号码、手机号码、省份、城市、健康码或行程卡的更新时间、健康码或行程卡颜色、疫苗接种情况、核酸检测结果、核酸检测机构、核酸检测结果更新时间、核酸检测采样时间、行程卡的途经地址等14个关键字段。

请求参数 表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 图片的Base64编码，图片尺寸不小于15×15像素，最长边不超过8192像素，支持JPG/PNG/BMP/TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 url 否 String 与image二选一 图片的URL路径，目前仅支持华为云上OBS提供的匿名公开授权访问的URL以及公网URL。 detect_direction 否 Boolean 是否校正图片的倾斜角度，可选值如下： true：校正图片的倾斜角度 false：不校正图片的倾斜角度 支持任意角度的校正，未传入该参数时默认为“false”。 待识别图片如果存在倾斜，建议将此参数设置为“true”。

请求示例 Endpoint即调用API的请求地址，不同服务不同区域的Endpoint不同，具体请参见终端节点。 例如，承兑汇票识别服务部署在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”，请求URL为“https://ocr.cn-north-4.myhuaweicloud.com/v2/{project_id}/ocr/acceptance-bill”，“project_id”为项目ID，获取方法请参见获取项目ID。 如何获取Token请参见认证鉴权。 传入承兑汇票图片的base64编码进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/acceptance-bill Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } 传入承兑汇票图片的url进行文字识别 POST https://{endpoint}/v2/{project_id}/ocr/acceptance-bill Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url" : "https://BucketName.obs.myhuaweicloud.com/ObjectName" }

响应示例 状态码： 200 成功响应样例 { "result" : { "issue_date" : "20xx-07-10", "bill_status" : "背书待签收", "due_date" : "20xx-01-10", "bill_number" : "130212XXX", "issuer_account" : "811180XXX", "payee_account" : "793201XXX", "issuer_full_name" : "XX集团有限公司", "issuer_bank_name" : "XX银行股份有限公司XX支行", "issuer_bank_number" : "302121XXX", "payee_full_name" : "XX有限公司", "payee_bank_name" : "XX银行股份有限公司XX分行", "payee_bank_number" : "303124XXX", "amount_in_figures" : "￥XXX", "amount_in_words" : "XXX元整", "acceptor_bank_name" : "XX银行XX分行", "acceptor_full_name" : "XX银行XX分行", "acceptor_bank_number" : "302121XXX", "issuer_commitment" : "本汇票请予以承兑，到期无条件付款", "acceptor_commitment" : "本汇票已经承兑，到期无条件付款", "assignability" : "可再转让", "acceptance_date" : "20xx-07-10", "issuance_guarantor_name" : "xx", "issuance_guarantor_address" : "xx", "issuance_guarantor_account" : "xx", "issuance_guarantee_date" : "xx", "issuance_guarantor_bank_number" : "xx", "issuance_guarantor_bank_name" : "xx", "acceptor_account" : "xx", "contract_number" : "xx", "acceptance_guarantor_name" : "xx", "acceptance_guarantor_address" : "xx", "acceptance_guarantor_account" : "xx", "acceptance_guarantee_date" : "xx", "acceptance_guarantor_bank_number" : "xx", "acceptance_guarantor_bank_name" : "xx", "issuer_rating_entity" : "xx", "issuer_credit_rating" : "xx", "issuer_rating_due_date" : "xx", "acceptor_rating_entity" : "xx", "acceptor_credit_rating" : "xx", "acceptor_rating_due_date" : "xx", "remarks" : "xxx", "bill_package_number" : "xx", "confidence" : { "issue_date" : 0.9998, "bill_status" : 0.9997, "due_date" : 0.9999, "bill_number" : 1.0, "issuer_account" : 1.0, "payee_account" : 1.0, "issuer_full_name" : 1.0, "issuer_bank_name" : 0.9999, "issuer_bank_number" : 0.999, "payee_full_name" : 1.0, "payee_bank_name" : 0.9999, "payee_bank_number" : 0.9999, "amount_in_figures" : 0.9999, "amount_in_words" : 0.9998, "acceptor_account" : 0.0, "acceptor_bank_name" : 0.9997, "acceptor_full_name" : 0.9999, "acceptor_bank_number" : 0.9998, "issuer_commitment" : 0.9998, "acceptor_commitment" : 1.0, "assignability" : 1.0, "acceptance_date" : 1.0, "issuance_guarantor_name" : 0.0, "issuance_guarantor_address" : 0.0, "issuance_guarantor_account" : 0.0, "issuance_guarantee_date" : 0.0, "issuance_guarantor_bank_number" : 0.0, "issuance_guarantor_bank_name" : 0.0, "contract_number" : 0.0, "acceptance_guarantor_name" : 0.0, "acceptance_guarantor_address" : 0.0, "acceptance_guarantor_account" : 0.0, "acceptance_guarantee_date" : 0.0, "acceptance_guarantor_bank_number" : 0.0, "acceptance_guarantor_bank_name" : 0.0, "issuer_rating_entity" : 0.0, "issuer_credit_rating" : 0.0, "issuer_rating_due_date" : 0.0, "acceptor_rating_entity" : 0.0, "acceptor_credit_rating" : 0.0, "acceptor_rating_due_date" : 0.0, "remarks" : 0.0, "bill_package_number" : 0.0 } } } 状态码： 400 失败响应样例 { "error_code" : "AIS.0103", "error_msg" : "The image size does not meet the requirements." }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 result AcceptanceBillResult object 调用成功时表示调用结果。 调用失败时无此字段。 表5 AcceptanceBillResult 参数 参数类型 描述 issue_date String 出票日期。 due_date String 汇票到期日。 bill_status String 票据状态。 bill_number String 票据号码。 issuer_full_name String 出票人全称。 issuer_account String 出票人账号。 issuer_bank_name String 出票人开户银行。 issuer_bank_number String 出票人开户行号。 payee_full_name String 收款人全称。 payee_account String 收款人账号。 payee_bank_name String 收款人开户银行。 payee_bank_number String 收款人开户行号。 issuance_guarantor_name String 出票保证人名称。 issuance_guarantor_address String 出票保证人地址。 issuance_guarantor_account String 出票保证人账号。 issuance_guarantee_date String 出票保证日期。 issuance_guarantor_bank_number String 出票保证人开户行行号。 issuance_guarantor_bank_name String 出票保证人开户行名称。 amount_in_words String 大写票据金额。 amount_in_figures String 小写票据金额。 acceptor_full_name String 承兑人全称。 acceptor_account String 承兑人账号。 acceptor_bank_number String 承兑人开户行行号。 acceptor_bank_name String 承兑人开户行名称。 contract_number String 交易合同号。 assignability String 能否转让。 issuer_commitment String 出票人承诺。 acceptor_commitment String 承兑人承诺。 acceptance_date String 承兑日期。 acceptance_guarantor_name String 承兑保证人名称。 acceptance_guarantor_address String 承兑保证人地址。 acceptance_guarantor_account String 承兑保证人账号。 acceptance_guarantee_date String 承兑保证日期。 acceptance_guarantor_bank_number String 承兑保证人开户行行号。 acceptance_guarantor_bank_name String 承兑保证人开户行名称。 issuer_rating_entity String 出票人评级主体。 issuer_credit_rating String 出票人信用等级。 issuer_rating_due_date String 出票人评级到期日。 acceptor_rating_entity String 承兑人评级主体。 acceptor_credit_rating String 承兑人信用等级。 acceptor_rating_due_date String 承兑人评级到期日。 bill_package_number String 票据包号。 remarks String 备注。 confidence Object 各个字段的置信度。 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码。调用成功时无此字段。 error_msg String 调用失败时的错误信息。调用成功时无此字段。

URI POST /v2/{project_id}/ocr/acceptance-bill 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 用于获取操作API的权限。获取Token接口响应消息头中X-Subject-Token的值即为Token。 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编码后大小不超过10M。 图片最小边不小于15像素，最长边不超过8192像素。支持JPG/PNG/BMP/TIFF格式。 图片Base64编码示例如/9j/4AAQSkZJRgABAg...，带有多余前缀会产生The image format is not supported报错。 url 否 String 与image二选一。 图片的URL路径，目前仅支持华为云上OBS提供的匿名公开授权访问的URL以及公网URL。 说明： 接口响应时间依赖于图片的下载时间，如果图片下载时间过长，会返回接口调用失败。 请保证被检测图片所在的存储服务稳定可靠，推荐使用OBS服务存储图片数据。

约束与限制 只支持中英文。 只支持识别PNG、JPG、JPEG、BMP、GIF、TIFF、WEBP、PCX、ICO、PSD格式的图片。 图像各边的像素大小在15px到8192px之间。 图像中识别区域有效占比超过80%，保证所有文字及其边缘包含在图像内。 不支持角度旋转的图片识别。 支持电子承兑汇票，对于拍照场景、复杂背景支持欠佳。 文字识别服务属于公有云服务，线上用户资源共享，如果需要多并发请求，请提前联系我们。

响应示例 状态码：200 成功响应示例 { "result" : [ { "plate_number" : "กง XXX4", "province" : "มหาสารคาม", "confidence" : 0.9225, "plate_location" : [ [ 370, 881 ], [ 2591, 881 ], [ 2591, 2281 ], [ 370, 2281 ] ] } ] } 状态码：400 失败响应示例 { "error_code": "AIS.0103", "error_msg": "The image size does not meet the requirements." }

请求示例 “endpoint”即调用API的请求地址，不同服务不同区域的“endpoint”不同，具体请参见终端节点。 例如，泰国车牌识别服务部署在“亚太-曼谷”区域的“endpoint”为“ocr.ap-southeast-2.myhuaweicloud.com”或“ocr.ap-southeast-2.myhuaweicloud.cn”，请求URL为“https://ocr.ap-southeast-2.myhuaweicloud.com/v2/{project_id}/ocr/thailand-license-plate”，“project_id”为项目ID，获取方法请参见获取项目ID 如何获取Token请参见构造请求。 请求样例（方式一：使用图片的Base64编码） POST https://{endpoint}/v2/{project_id}/ocr/thailand-license-plate Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } 请求样例（方式二：使用图片URL） POST https://{endpoint}/v2/{project_id}/ocr/thailand-license-plate Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" } Python3语言请求代码示例（其他语言参照下列示例编写或使用OCR SDK） # encoding:utf-8 import requests import base64 url = "https://{endpoint}/v2/{project_id}/ocr/thailand-license-plate" token = "用户获取得到的实际token值" headers = {'Content-Type': 'application/json', 'X-Auth-Token': token} imagepath = r'./data/thailand-license-plate-demo.png' # 读取本地图片 with open(imagepath, "rb") as bin_data: image_data = bin_data.read() image_base64 = base64.b64encode(image_data).decode("utf-8") # 使用图片的Base64编码 payload = {"image": image_base64} response = requests.post(url, headers=headers, json=payload) print(response.text)

URI POST /v2/{project_id}/ocr/thailand-license-plate 表1 路径参数 参数 是否必选 说明 endpoint 是 终端节点，即调用API的请求地址。 不同服务不同区域的endpoint不同，您可以从终端节点中获取。 例如，OCR服务在“华北-北京四”区域的“endpoint”为“ocr.cn-north-4.myhuaweicloud.com”。 project_id 是 项目ID，您可以从获取项目ID中获取。