安装SDK 使用SDK前，需要安装“HuaweiCloud.SDK.Core”和“HuaweiCloud.SDK.Ocr”，有两种安装方式，分别如下。 使用 .NET CLI 工具 dotnet add package HuaweiCloud.SDK.Core dotnet add package HuaweiCloud.SDK.Ocr 使用 Package Manager Install-Package HuaweiCloud.SDK.Core Install-Package HuaweiCloud.SDK.Ocr

开始使用 在开始使用之前，请确保您安装的是最新版本的SDK。使用过时的版本可能会导致兼容性问题或无法使用最新功能。您可以通过运行以下命令来检查并更新SDK至最新版本。 dotnet list package dotnet add package HuaweiCloud.SDK.Core --version * dotnet add package HuaweiCloud.SDK.Ocr --version * 导入依赖模块 using System; using System.Collections.Generic; using HuaweiCloud.SDK.Core; using HuaweiCloud.SDK.Core.Auth; using HuaweiCloud.SDK.Ocr; using HuaweiCloud.SDK.Ocr.V1; using HuaweiCloud.SDK.Ocr.V1.Model; 配置客户端连接参数 默认配置 // 使用默认配置 var config = HttpConfig.GetDefaultConfig(); 网络代理（可选） // 根据需要配置网络代理 config.ProxyHost = "proxy.huaweicloud.com"; config.ProxyPort = 8080; config.ProxyUsername = "test"; config.ProxyPassword = "test"; 超时配置（可选） // 默认超时时间为120秒，可根据需要调整 config.Timeout = 120; SSL配置（可选） // 根据需要配置是否跳过SSL证书验证 config.IgnoreSslVerification = true; 配置认证信息 配置AK、SK信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。AK、SK获取方法请参见准备工作。 const string ak = Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_AK"); const string sk = Environment.GetEnvironmentVariable("HUAWEICLOUD_SDK_SK"); var auth = new BasicCredentials(ak, sk); 认证用的 ak 和sk 硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。 本示例以 ak 和 sk 保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 初始化客户端（二选一） 指定云服务region方式（推荐） // 初始化指定云服务的客户端 {Service}Client ，以初始化OCR服务的 OcrClient 为例 var client = OcrClient.NewBuilder() .WithCredential(auth) .WithRegion(OcrRegion.ValueOf("cn-north-4")) .WithHttpConfig(config) .Build(); 指定云服务endpoint方式 // 指定终端节点，以OCR服务北京四的 endpoint 为例 String endpoint = "https://ocr.cn-north-4.myhuaweicloud.com"; // 初始化客户端认证信息，需要填写相应 projectId，以初始化 BasicCredentials 为例 var auth = new BasicCredentials(ak, sk, projectId); // 初始化指定云服务的客户端 {Service}Client，以初始化OCR服务的 OcrClient 为例 var client = OcrClient.NewBuilder() .WithCredential(auth) .WithEndPoint(endpoint) .WithHttpConfig(config) .Build(); endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 地区和终端节点 。 发送请求并查看响应 // 以调用通用 表格识别 接口 RecognizeGeneralTable 为例 var req = new RecognizeGeneralTableRequest { }; req.Body = new GeneralTableRequestBody() { Url = "图片的url" }; try { var resp = client.RecognizeGeneralTable(req); var respStatusCode = resp.HttpStatusCode; Console.WriteLine(respStatusCode); } 异常处理 表1 异常处理 一级分类 一级分类说明 二级分类 二级分类说明 ConnectionException 连接类异常 HostUnreachableException 网络不可达、被拒绝。 SslHandShakeException SSL认证异常。 RequestTimeoutException 响应超时异常 CallTimeoutException 单次请求，服务器处理超时未返回。 RetryOutageException 在重试策略消耗完成后，仍无有效的响应。 ServiceResponseException 服务器响应异常 ServerResponseException 服务端内部错误，Http响应码：[500,]。 ClientRequestException 请求参数不合法，Http响应码：[400, 500) try { var resp = client.RecognizeGeneralTable(req); var respStatusCode = resp.HttpStatusCode; Console.WriteLine(respStatusCode); } catch (RequestTimeoutException requestTimeoutException) { Console.WriteLine(requestTimeoutException.ErrorMessage); } catch (ServiceResponseException clientRequestException) { Console.WriteLine(clientRequestException.HttpStatusCode); Console.WriteLine(clientRequestException.ErrorCode); Console.WriteLine(clientRequestException.ErrorMsg); } catch (ConnectionException connectionException) { Console.WriteLine(connectionException.ErrorMessage); }

OCR权限 默认情况下，管理员创建的 IAM 用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 OCR部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域（如华北-北京四）对应的项目（cn-north-4）中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问OCR时，需要先切换至授权区域。 如表1所示，包括了OCR的所有系统角色。 表1 OCR系统策略 策略名称 描述 策略类型 依赖关系 OCR FullAccess 所有权限 系统策略 无 OCR ReadOnlyAccess 只读访问权限 系统策略 无 表2列出了OCR常用操作与系统策略的授权关系，您可以参照该表选择合适的系统策略。 表2 OCR操作与系统策略关系 Action Action说明 OCR FullAccess OCR ReadOnlyAccess ocr:financialStatement:subscribe 开通财报识别服务 √ × ocr:financialStatement:unsubscribe 取消开通财报识别服务 √ × ocr:financialStatement:getSubscribeUserList 查询开通财报识别的用户列表 √ √ ocr:financialStatement:subscribeAllUsers 为其余子用户开通财报识别服务 √ × ocr:financialStatement:unsubscribeAllUsers 为其余子用户取消开通财报识别服务 √ × ocr:autoClassification:subscribe 开通智能分类识别服务 √ × ocr:autoClassification:unsubscribe 取消开通智能分类识别服务 √ × ocr:autoClassification:getSubscribeUserList 查询开通智能分类识别的用户列表 √ √ ocr:autoClassification:subscribeAllUsers 为其余子用户开通智能分类识别服务 √ × ocr:autoClassification:unsubscribeAllUsers 为其余子用户取消开通智能分类识别服务 √ × ocr:idCard:subscribe 开通身份证识别服务 √ × ocr:idCard:unsubscribe 取消开通身份证识别服务 √ × ocr:idCard:getSubscribeUserList 查询开通身份证识别的用户列表 √ √ ocr:idCard:subscribeAllUsers 为其余子用户开通身份证识别服务 √ × ocr:idCard:unsubscribeAllUsers 为其余子用户取消开通身份证识别服务 √ × ocr:driverLicense:subscribe 开通驾驶证识别服务 √ × ocr:driverLicense:unsubscribe 取消开通驾驶证识别服务 √ × ocr:driverLicense:getSubscribeUserList 查询开通驾驶证识别的用户列表 √ √ ocr:driverLicense:subscribeAllUsers 为其余子用户开通驾驶证识别服务 √ × ocr:driverLicense:unsubscribeAllUsers 为其余子用户取消开通驾驶证识别服务 √ × ocr:vehicleLicense:subscribe 开通 行驶证识别 服务 √ × ocr:vehicleLicense:unsubscribe 取消开通行驶证识别服务 √ × ocr:vehicleLicense:getSubscribeUserList 查询开通行驶证识别的用户列表 √ √ ocr:vehicleLicense:subscribeAllUsers 为其余子用户开通行驶证识别服务 √ × ocr:vehicleLicense:unsubscribeAllUsers 为其余子用户取消开通行驶证识别服务 √ × ocr:vatInvoice:subscribe 开通增值税发票识别服务 √ × ocr:vatInvoice:unsubscribe 取消开通增值税发票识别服务 √ × ocr:vatInvoice:getSubscribeUserList 查询开通增值税发票识别的用户列表 √ √ ocr:vatInvoice:subscribeAllUsers 为其余子用户开通增值税发票识别服务 √ × ocr:vatInvoice:unsubscribeAllUsers 为其余子用户取消开通增值税发票识别服务 √ × ocr:invoiceVerification:subscribe 开通发票验真服务 √ × ocr:invoiceVerification:unsubscribe 取消开通发票验真服务 √ × ocr:invoiceVerification:getSubscribeUserList 查询开通发票验真的用户列表 √ √ ocr:invoiceVerification:subscribeAllUsers 为其余子用户开通发票验真服务 √ × ocr:invoiceVerification:unsubscribeAllUsers 为其余子用户取消开通发票验真服务 √ × ocr:mvsInvoice:subscribe 开通机动车销售发票识别服务 √ × ocr:mvsInvoice:unsubscribe 取消开通机动车销售发票识别服务 √ × ocr:mvsInvoice:getSubscribeUserList 查询开通机动车销售发票识别的用户列表 √ √ ocr:mvsInvoice:subscribeAllUsers 为其余子用户开通机动车销售发票识别服务 √ × ocr:mvsInvoice:unsubscribeAllUsers 为其余子用户取消开通机动车销售发票识别服务 √ × ocr:generalText:subscribe 开通 通用文字识别 服务 √ × ocr:generalText:unsubscribe 取消开通通用 文字识别 服务 √ × ocr:generalText:getSubscribeUserList 查询开通通用文字识别的用户列表 √ √ ocr:generalText:subscribeAllUsers 为其余子用户开通通用文字识别服务 √ × ocr:generalText:unsubscribeAllUsers 为其余子用户取消开通通用文字识别服务 √ × ocr:generalTable:subscribe 开通通用表格识别服务 √ × ocr:generalTable:unsubscribe 取消开通通用表格识别服务 √ × ocr:generalTable:getSubscribeUserList 查询开通通用表格识别的用户列表 √ √ ocr:generalTable:subscribeAllUsers 为其余子用户开通通用表格识别服务 √ × ocr:generalTable:unsubscribeAllUsers 为其余子用户取消开通通用表格识别服务 √ × ocr:tollInvoice:subscribe 开通车辆通行费发票识别服务 √ × ocr:tollInvoice:unsubscribe 取消开通车辆通行费发票识别服务 √ × ocr:tollInvoice:getSubscribeUserList 查询开通车辆通行费发票识别的用户列表 √ √ ocr:tollInvoice:subscribeAllUsers 为其余子用户开通车辆通行费发票识别服务 √ × ocr:tollInvoice:unsubscribeAllUsers 为其余子用户取消开通车辆通行费发票识别服务 √ × ocr:quotaInvoice:subscribe 开通定额发票识别服务 √ × ocr:quotaInvoice:unsubscribe 取消开通定额发票识别服务 √ × ocr:quotaInvoice:getSubscribeUserList 查询开通定额发票识别的用户列表 √ √ ocr:quotaInvoice:subscribeAllUsers 为其余子用户开通定额发票识别服务 √ × ocr:quotaInvoice:unsubscribeAllUsers 为其余子用户取消开通定额发票识别服务 √ × ocr:flightItinerary:subscribe 开通飞机行程单识别服务 √ × ocr:flightItinerary:unsubscribe 取消开通飞机行程单识别服务 √ × ocr:flightItinerary:getSubscribeUserList 查询开通飞机行程单识别的用户列表 √ √ ocr:flightItinerary:subscribeAllUsers 为其余子用户开通飞机行程单识别服务 √ × ocr:flightItinerary:unsubscribeAllUsers 为其余子用户取消开通飞机行程单识别服务 √ × ocr:taxiInvoice:subscribe 开通出租车发票识别服务 √ × ocr:taxiInvoice:unsubscribe 取消开通出租车发票识别服务 √ × ocr:taxiInvoice:getSubscribeUserList 查询开通出租车发票识别的用户列表 √ √ ocr:taxiInvoice:subscribeAllUsers 为其余子用户开通出租车发票识别服务 √ × ocr:taxiInvoice:unsubscribeAllUsers 为其余子用户取消开通出租车发票识别服务 √ × ocr:trainTicket:subscribe 开通火车票识别服务 √ × ocr:trainTicket:unsubscribe 取消开通火车票识别服务 √ × ocr:trainTicket:getSubscribeUserList 查询开通火车票识别的用户列表 √ √ ocr:trainTicket:subscribeAllUsers 为其余子用户开通火车票识别服务 √ × ocr:trainTicket:unsubscribeAllUsers 为其余子用户取消开通火车票识别服务 √ × ocr:bankCard:subscribe 开通银行卡识别服务 √ × ocr:bankCard:unsubscribe 取消开通银行卡识别服务 √ × ocr:bankCard:getSubscribeUserList 查询开通银行卡识别的用户列表 √ √ ocr:bankCard:subscribeAllUsers 为其余子用户开通银行卡识别服务 √ × ocr:bankCard:unsubscribeAllUsers 为其余子用户取消开通银行卡识别服务 √ × ocr:passport:subscribe 开通护照识别服务 √ × ocr:passport:unsubscribe 取消开通护照识别服务 √ × ocr:passport:getSubscribeUserList 查询开通护照识别的用户列表 √ √ ocr:passport:subscribeAllUsers 为其余子用户开通护照识别服务 √ × ocr:passport:unsubscribeAllUsers 为其余子用户取消开通护照识别服务 √ × ocr:transportationLicense:subscribe 开通道路运输证识别服务 √ × ocr:transportationLicense:unsubscribe 取消开通道路运输证识别服务 √ × ocr:transportationLicense:getSubscribeUserList 查询开通道路运输证识别的用户列表 √ √ ocr:transportationLicense:subscribeAllUsers 为其余子用户开通道路运输证识别服务 √ × ocr:transportationLicense:unsubscribeAllUsers 为其余子用户取消开通道路运输证识别服务 √ × ocr:businessLicense:subscribe 开通营业执照识别服务 √ × ocr:businessLicense:unsubscribe 取消开通营业执照识别服务 √ × ocr:businessLicense:getSubscribeUserList 查询开通营业执照识别的用户列表 √ √ ocr:businessLicense:subscribeAllUsers 为其余子用户开通营业执照识别服务 √ × ocr:businessLicense:unsubscribeAllUsers 为其余子用户取消开通营业执照识别服务 √ × ocr:licensePlate:subscribe 开通车牌识别服务 √ × ocr:licensePlate:unsubscribe 取消开通车牌识别服务 √ × ocr:licensePlate:getSubscribeUserList 查询开通车牌识别的用户列表 √ √ ocr:licensePlate:subscribeAllUsers 为其余子用户开通车牌识别服务 √ × ocr:licensePlate:unsubscribeAllUsers 为其余子用户取消开通车牌识别服务 √ × ocr:webImage:subscribe 开通网络图片识别服务 √ × ocr:webImage:unsubscribe 取消开通网络图片识别服务 √ × ocr:webImage:getSubscribeUserList 查询开通网络图片识别的用户列表 √ √ ocr:webImage:subscribeAllUsers 为其余子用户开通网络图片识别服务 √ × ocr:webImage:unsubscribeAllUsers 为其余子用户取消开通网络图片识别服务 √ × ocr:handwriting:subscribe 开通手写文字识别服务 √ × ocr:handwriting:unsubscribe 取消开通手写文字识别服务 √ × ocr:handwriting:getSubscribeUserList 查询开通手写文字识别的用户列表 √ √ ocr:handwriting:subscribeAllUsers 为其余子用户开通手写文字识别服务 √ × ocr:handwriting:unsubscribeAllUsers 为其余子用户取消开通手写文字识别服务 √ × ocr:vin:subscribe 开通vin码识别服务 √ × ocr:vin:unsubscribe 取消开通vin码识别服务 √ × ocr:vin:getSubscribeUserList 查询开通vin码识别的用户列表 √ √ ocr:vin:subscribeAllUsers 为其余子用户开通vin码识别服务 √ × ocr:vin:unsubscribeAllUsers 为其余子用户取消开通vin码识别服务 √ × ocr:businessCard:subscribe 开通名片识别服务 √ × ocr:businessCard:unsubscribe 取消开通名片识别服务 √ × ocr:businessCard:getSubscribeUserList 查询开通名片识别的用户列表 √ √ ocr:businessCard:subscribeAllUsers 为其余子用户开通名片识别服务 √ × ocr:businessCard:unsubscribeAllUsers 为其余子用户取消开通名片识别服务 √ × ocr:insurancePolicy:subscribe 开通保险单识别服务 √ × ocr:insurancePolicy:unsubscribe 取消开通保险单识别服务 √ × ocr:insurancePolicy:getSubscribeUserList 查询开通保险单识别的用户列表 √ √ ocr:insurancePolicy:subscribeAllUsers 为其余子用户开通保险单识别服务 √ × ocr:insurancePolicy:unsubscribeAllUsers 为其余子用户取消开通保险单识别服务 √ × ocr:transportationQualificationCertificate:subscribe 开通道路运输从业资格证服务 √ × ocr:transportationQualificationCertificate:unsubscribe 取消开通道路运输从业资格证服务 √ × ocr:transportationQualificationCertificate:getSubscribeUserList 查询开通道路运输从业资格证的用户列表 √ √ ocr:transportationQualificationCertificate:subscribeAllUsers 为其余子用户开通道路运输从业资格证服务 √ × ocr:transportationQualificationCertificate:unsubscribeAllUsers 为其余子用户取消开通道路运输从业资格证服务 √ ×

IAM用户登录并验证权限 使用新创建的IAM账户登录控制台，切换至授权区域，进行验证权限。 假设IAM用户只具备“OCR ReadOnlyAccess”权限，即只读访问权限，使IAM用户仅具备使用服务能力，开通/关闭服务需要主账户操作。 进入OCR控制台界面，单击“开通服务”，如果无法开通，提示权限不足，则表示“OCR ReadOnlyAccess”已生效。 IAM用户不管是否具备“OCR ReadOnlyAccess”权限，只要具备 “OCR FullAccess”权限，便可以在控制台进行开通、关闭服务。 父主题： 权限管理

解读识别结果 本章节通过网络图片识别API介绍如何解读调API返回的JSON格式识别结果。请参照API参考“响应参数”章节比对查看。 以下图识别结果为例，讲解图片内容如何与API的返回字段对应。 调用网络图片API成功后，在“JSON返回结果”中，可见result字段，该字段包含了图片中的文字块数目、文字块排列顺序、具体文本内容、所在位置、置信度等信息。 result字段仅在API调用成功后返回。 words_block_count表示文字块识别结果，本示例中，识别出2个文字块，分别代表图片中的2行文字。 words_block_list表示文字块列表，按照图片文字从上到下、从左到右排列。 words为识别出来的文本内容，confidence表示该字段的置信度。 location表示文字块的区域位置信息，采用图像坐标系，第一个文字块左上角顶点为[140,45]。 extracted_data表示图片中包含的联系人信息，仅在设置了入参extract_type，且图片中有联系人信息时支持提取。 { "result": { "words_block_count": 2, "words_block_list": [ { "words": "真材实料/舒柔养足", "confidence": 0.9491, "location": [ [ 140, 45 ], [ 380, 45 ], [ 380, 75 ], [ 140, 75 ] ] }, { "words": "选自优质头层牛皮，皮质柔软富弹性，耐折抗拉伸，穿着不变形", "confidence": 0.9897, "location": [ [ 58, 84 ], [ 462, 84 ], [ 462, 102 ], [ 58, 102 ] ] } ], "extracted_data": {} }} 父主题： 获取识别结果

操作步骤 登录 云审计 服务控制台。 单击左侧导航树的“事件列表”，进入事件列表信息页面。 事件列表支持通过筛选来查询对应的操作事件。当前事件列表支持四个维度的组合查询，详细信息如下： 事件来源、资源类型和筛选类型。 在下拉框中选择查询条件。 其中筛选类型选择事件名称时，还需选择某个具体的事件名称。 选择资源ID时，还需选择或者手动输入某个具体的资源ID。 选择资源名称时，还需选择或手动输入某个具体的资源名称。 操作用户：在下拉框中选择某一具体的操作用户，此操作用户指用户级别，而非租户级别。 事件级别：可选项为“所有事件级别”、“normal”、“warning”、“incident”，只可选择其中一项。 时间范围：可选择查询最近七天内任意时间段的操作事件。 展开需要查看的事件，查看详细信息。 图1 展开记录 在需要查看的记录右侧，单击“查看事件”，弹窗中显示了该操作事件结构的详细信息。

OCR自定义策略 如果系统预置的权限，不满足您的授权要求，可以创建自定义策略。自定义策略中可以添加的授权项（Action）请参见权限管理。 目前华为云支持以下两种方式创建自定义策略： 可视化视图创建自定义策略：无需了解策略语法，按可视化视图导航栏选择云服务、操作、资源、条件等策略内容，可自动生成策略。 JSON视图创建自定义策略：可以在选择策略模板后，根据具体需求编辑策略内容；也可以直接在编辑框内编写JSON格式的策略内容。 具体创建步骤请参见：创建自定义策略。 父主题： 权限管理

监控指标详情 表1 OCR支持的监控指标 指标ID 指标名称 指标含义 取值范围 测量对象 监控周期（原始指标） successful_call_times_of_service 调用服务成功次数 统计周期内调用服务成功次数。 单位：次/分钟 ≥ 0 times/min 接口 1分钟 failed_call_times_of_service 调用服务失败次数 统计周期内调用服务失败次数。 单位：次/分钟 ≥ 0 times/min 接口 1分钟

使用工作流开发应用流程 自定义OCR提供了单模板工作流和多模板工作流，您可以通过预置的工作流，自主构建文字识别模板，识别模板图片中的文字，提供高精度的文字识别模型，保证结构化信息提取精度。 图1 使用预置工作流开发应用 表1 使用工作流开发应用流程 流程 说明 详细指导 自定义OCR 根据您的实际使用需求选择自定义OCR。您可以通过查看产品文档选择所需使用的工作流。 在“文字识别”控制台界面，单击左侧菜单“自定义OCR”，进入自定义OCR应用页面。 创建应用 基于已选择的工作流创建应用，填写应用基本信息、选择工作流。 创建应用 开发应用 通用单模板工作流 根据工作流指引，创建单模板服务，通过模板训练文字识别模型，实现单模板图像的文字信息结构化提取。 通用单模板工作流 多模板分类工作流 根据工作流指引，创建多模板服务，通过多模板训练模板分类器和文字识别模型，实现多模板图像的文字信息结构化提取。 多模板分类工作流 调用API 调用指南，支持通过API调用当前模板服务。 调用API

工作流 自定义OCR当前提供了单模板工作流和多模板工作流，自主构建文字识别模板，识别模板图片中的文字，提供高精度的文字识别模型，保证结构化信息提取精度。 通用单模板工作流 通过构建文字识别模板，识别单个板式图片中的文字，提供高精度的文字识别模型，保证结构化信息提取精度。 多模板分类工作流 支持用户自定义多个文字识别模板，通过AI分类算法，自动识别图片所需使用的模板，从而支持从大量不同板式图像中提取结构化信息。

提取特定字段导入Excel 本示例调用身份证识别API，并从获取到的JSON结果中，提取所需的字段，填入至Excel。 前提条件 开通身份证识别。 参考本地调用，安装OCR Python SDK。并执行pip install xlsxwriter命令安装依赖包。 登录访问密钥页面，获取AK、SK。可以新增访问密钥，或使用已有的访问密钥。访问密钥为credentials.csv文件，包含AK/SK信息。 代码示例 # -*- coding: utf-8 -*-import base64import xlsxwriterfrom huaweicloudsdkcore.auth.credentials import BasicCredentialsfrom huaweicloudsdkocr.v1.region.ocr_region import OcrRegionfrom huaweicloudsdkcore.exceptions import exceptionsfrom huaweicloudsdkocr.v1 import *from huaweicloudsdkcore.http.http_config import HttpConfigdef recognize_id_card_request(): try: request = RecognizeIdCardRequest() request.body = IdCardRequestBody( image=image_base64 ) response = client.recognize_id_card(request) return response except exceptions.ClientRequestException as e: print(e.status_code) print(e.request_id) print(e.error_code) print(e.error_msg)def get_credential(): return BasicCredentials(ak, sk)def get_client(): config = HttpConfig.get_default_config() config.ignore_ssl_verification = True return OcrClient.new_builder(OcrClient) \ .with_credentials(credentials) \ .with_region(OcrRegion.CN_NORTH_4) \ .with_http_config(config) \ .build()def image_to_base64(imagepath): """ 将本地图片转化为base64编码 """ with open(imagepath, "rb") as bin_data: image_data = bin_data.read() base64_data = base64.b64encode(image_data).decode("utf-8") return base64_datadef response_to_execl(save_file, data): """ :param save_file: 文件名 :param data: result data """ # 处理调用API返回的result数据 keys_list = list(data["result"].keys()) values_list = list(data["result"].values()) options = {'in_memory': True} with xlsxwriter.Workbook(save_file, options) as workbook: worksheet = workbook.add_worksheet() worksheet.set_column('A1:A20', 23) worksheet.set_column('B1:B20', 100) worksheet.write_column('A1', keys_list) worksheet.write_column('B1', values_list) workbook.close()if __name__ == '__main__': # 填写访问密钥AK、SK ak = "填写AK" sk = "填写SK" # Init Auth Info credentials = get_credential() # Create OcrClient client = get_client() image_base64 = image_to_base64(r"图片的路径，例如D:\local\test.png") # request id card service response = recognize_id_card_request().to_dict() # 数据保存在execl上 response_to_execl(r"excel路径，例如D:\local\test.xlsx", response)

按需计费开通服务 进入文字识别官网主页，单击“立即使用”，进入文字识别控制台。 在“总览”页面，选择需要使用的服务，执行开通操作，默认的计费方式采用按需计费。 图1 服务开通 服务开通成功后，开通状态将显示为“已开通”。 如果您需要调用 对象存储服务 （OBS）中的数据，请在开通服务页面进行服务授权。 图2 OBS服务授权 OCR服务开通后，可在控制台进行关闭。开通服务时，计费规则默认为“按需计费”。只有调用成功才会计费，其中返回的2xx状态码表示调用成功，调用失败不计费，详细的计费价格及规则请参见计费说明。 如未开通服务，直接调用OCR API会提示ModelArts.4204报错。

购买套餐包开通服务 进入文字识别官网主页，单击“立即使用”，进入文字识别控制台。 在“总览”页面，选择需要使用的服务，在操作列单击“购买套餐包”，此时的计费方式采用套餐包计费，套餐包额度用完后自动转为按需计费。 图3 购买套餐包 服务开通成功后，开通状态将显示为“已开通”。 如果您需要调用对象存储服务（OBS）中的数据，请在开通服务页面进行服务授权。 图4 OBS服务授权 购买套餐包后只有调用成功才会计算调用次数，其中返回的2xx状态码表示调用成功，调用失败不计算次数。套餐包扣减规则包括计费模式、变更配置、续费、欠费类等问题请参见计费说明。 如未开通服务，直接调用OCR API会提示ModelArts.4204报错。 4.服务开通后，您可以按照官方文档数据要求，调用API或SDK步骤继续完成实际服务需求。

基本概念 参照字段为模板图片和待识别图片中的公共文字部分，所有需要识别的图片中都要包含参照字段，且位置必须固定。 套件提供了自动搜索参照字段和手动框选参照字段这两种模式。 自动搜索参照字段：未手动框选任何参照字段的情况下，默认激活自动搜索参照字段模式。 手动框选参照字段：若手动框选了任意参照字段，将激活手动框选模式。 当识别图片的场景比较单一时，即只有一种模板，且参照字段不容易与其他文字混淆时，可以使用自动参照字段来简化模板制作过程，否则建议手动框选，详细步骤请参见操作步骤。

创建用户组 使用主账号登录IAM服务控制台。 左侧导航窗格中，选择“用户组”页签，单击右上方的“+创建用户组”。 在“创建用户组”界面，输入“用户组名称”，创建用户组。 返回用户组列表，单击列表中的“授权”。 勾选需要授予用户组的权限，单击“确定”，完成用户组授权。 选择权限的作用服务。此处选择“文字识别（OCR）”，并为该用户组设置所需的权限。 OCR FullAccess：所有权限，可以使IAM用户具备开通/关闭/使用服务能力。 OCR ReadOnlyAccess：只读访问权限，使IAM用户仅具备使用服务能力，开通/关闭服务需要主账户操作。 单击“下一步”，设置用户组的最小授权范围。单击“确定”，完成用户组授权。 所有资源：不设置最小授权范围，授权后，用户根据权限使用账号中所有资源。 指定区域项目资源：授权后，用户根据权限使用已选区域项目中的资源。 选择指定企业项目：IAM用户可以根据权限使用该企业项目中的资源。仅开通企业项目后可选。