华为云用户手册

OCR识别中，哪些算有效计费 OCR服务通过RestFul API调用，计费以Https请求返回的状态码为准，当返回状态码为2xx(如200/201)时，表示调用成功并进行扣费。 OCR服务通过套餐包计费方式，来降低调用成本，从绝大部分客户的使用来看，客户上传错误样本导致计费的占比非常非常小，几乎可忽略不计。 在客户使用OCR能力，进行二次开发时，可以尽可能的通过页面可视化提醒等方式，引导使用者尽量拍摄符合人眼易于识别的图片，以保障数据质量提升同时识别准确率。 由于图片的输入非常开放，因此为了避免恶意攻击，在公有云上对有效识别的信息（即便部分不准）也会计费，类似于在通话质量不佳时通常也是要求计费。 父主题： 计费类

不同区域是否有时延 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。 不过，在基础设施、BGP网络品质、资源的操作与配置等方面，中国大陆各个区域间区别不大，如果您或者您的目标用户在中国大陆，可以不用考虑不同区域造成的网络时延问题。 父主题： 区域与可用区

ModelArts.0212报错处理方法 调用API时出现{"error_code":"ModelArts.0212","error_msg":"Invalid Token header. The Token not contain project item. "}，表示Token无效，Token中缺少project信息。 OCR服务为项目级别服务， 获取Token 接口中，需填写scope参数，并设置为project，例如填写为cn-north-4，获取到北京四区域的Token。 父主题： 错误码类

如何选购合适的API 文字识别 服务（OCR）提供四种类型的API：通用类、证件类、票据类、智能分类。 除此之外，您也可以使用 ModelArts Pro 服务提供的“文字识别套件”零代码搭建出专属的文字识别系统。 通用类 通用 表格识别 ：提取表格内的文字和所在行列位置信息。 通用文字识别 ：提取图片内的文字及其对应位置信息。 手写文字识别：识别手写文字、印刷文字信息。 网络图片识别：识别网络图片内的所有文字及其对应位置信息。 证件类 身份证识别、护照识别、银行卡识别 驾驶证识别、 行驶证识别 、道路运输证识别、车牌识别、VIN码识别 营业执照识别、名片识别 票据类 增值税发票识别（增值税专用发票、增值税普通发票、增值税电子普通发票、通行费发票、卷票） 定额发票、火车票、出租车发票 机动车销售发票、车辆通行费发票 飞机行程单 智能分类 一张待识别图片中包含了卡证、发票多个内容时，进行混合识别。 一张待识别图片中包含了多张同类型的发票。 一张待识别图片中包含了多张不同类型的发票。 价格详情请参见OCR服务价格计算器，计费规则请参见计费说明。 父主题： 服务开通类

APIG.0307报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"The token must be updated.","error_code":"APIG.0307"，是因为Token失效，需要进行更新。 您可以尝试以下方案进行解决。 Token有效期为24小时，请使用重新获取Token调用API。 检查接口URL中的终端节点是否填写正确。部署在不同区域间的服务，不可以跨区域调用。如果调用了不同区域的接口，导致判断为Token失效，显示APIG.0307错误码。 父主题： 错误码类

OCR服务提供哪些版本的SDK 目前OCR提供的SDK有Java、Python、Node.js、PHP、C++、Go、.NET版本。具体请参考文字识别服务《SDK参考》手册，该手册详细介绍了SDK支持的版本及使用方法。 如果想用其他编程语言调用OCR API服务 ，可以使用Token鉴权方式，实现接口调用。具体请参考文字识别服务接口《API参考》手册，该手册详细介绍了如何调用API及各个API接口的详细参数信息。 父主题： SDK使用类

APIG.0308报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute","error_code":"APIG.0308"，是因为每个用户调用不同服务都有并发限制，例如目前该服务并发量最大为1分钟XX次。 您可以尝试以下两种解决方法： 通过重试机制，在代码里检查返回值，碰到并发错误可以延时一小段时间（如2-5s）重试请求； 后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 如果需要更大并发量请联系我们。 父主题： 错误码类

企业主帐号购买的套餐包资源，子帐号如何使用 “企业主帐号”与“子帐号”为通俗意义的说法，准确上为“帐号”与“ IAM 用户”。帐号与IAM用户可以类比为父子关系，帐号是资源归属以及计费的主体，对其拥有的资源具有所有权限。IAM用户由帐号创建，只能拥有帐号授予的资源使用权限，帐号可以随时修改或者撤销IAM用户的使用权限。IAM用户进行资源操作时产生的费用统一计入帐号中，IAM用户不需要为资源付费。使用帐号可以创建IAM用户及给IAM用户授权，登录IAM用户即可查看和使用帐号授权的资源。 父主题： 计费类

使用OCR服务，是否会保存用户数据 OCR服务坚持“华为云始终把可信作为产品质量的第一要素”的理念，我们基于安全、合规、隐私、韧性、透明，为您提供有技术、有未来、值得信赖的云服务。 OCR服务承诺用户识别的图片与识别结果全部不作任何形式留存，识别返回后立即释放。 具体的声明请参考隐私政策声明和法律声明，可信资源请参见白皮书资源。关于文字识别的相关声明请参见文字识别服务声明。 父主题： 数据安全与隐私

ModelArts.4603、ModelArts.4704报错处理方法 如果在调用API时返回错误信息与错误码： "error_code":"ModelArts.4603","error_msg":"Obtaining the file from the URL failed. "表示从URL获取图片数据失败，可通过以下几个方面进行排查：（1）请确保提供的URL支持HTTP/HTTPS请求协议，即格式为http/https url；（2）请检查存储图片的服务器是否稳定可靠，网络连接是否有异常，是否公网可访问；（3）请检查下载图片的content-type是否为标准类型，例如：image/gif、image/jpeg、image/png、image/tiff。建议：使用OBS的URL进行请求。 "error_code":"ModelArts.4704","error_msg":"Obtaining the file from the OBS failed. "表示从OBS获取图片数据失败，请确保存储图片的OBS路径存在且可访问，如果路径存在，请确保设置OBS桶策略为公共桶。建议：不要使用跨区域的OBS路径，如果OBS与调用服务部署区域不属于用一个区域，建议本地下载图片后使用image的调用方式。 父主题： 错误码类

APIG.0201报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"Backend timeout.","error_code":"APIG.0201"，表示请求超时。 您可以尝试以下方案进行解决。 使用Postman等工具直接调用服务，查看是否成功，如果调用成功表示服务接口没有问题，请执行如下步骤1和步骤2进行检查： 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 请检查图片是否过大，或网络延时过长，如果图片过大，在保证图片清晰度前提下可以对图片进行等比例压缩；如果网络延时较长，可以适当提升网络传输速度。 如以上方案无法解决问题，请联系我们。 父主题： 错误码类

每月1000次的免费调用次数下线 尊敬的华为云客户： 华为云对文字识别OCR服务的价格进行下调，新价格于2022/03/01 00:00（北京时间）正式生效，生效后文字识别OCR服务的新购、续费均按调整后价格收取费用（调价前已生效的按需阶梯计费与已购买的预付费套餐包不受本次降价影响）。 具体价格请在新价格生效后参考产品的计费详情页。 如您有任何问题，可随时通过工单或者服务热线（4000-955-988或950808）与我们联系。 感谢您对华为云的支持！ 父主题： 计费类

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 LastModified time.Time 目标对象的最近一次修改时间。 ETag string 目标对象的ETag值。 CopySourceVersionId string 源对象的版本号。 VersionId string 目标对象的版本号。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。

参数描述 字段名 类型 约束 说明 Bucket string 必选 目标桶名。 Key string 必选 目标对象名。 CopySourceBucket string 必选 源桶名。 CopySourceKey string 必选 源对象名。 CopySourceVersionId string 可选 源对象版本号。 ACL AclType 可选 复制对象时可指定的预定义访问策略。 MetadataDirective MetadataDirectiveType 可选 复制源对象属性的策略。 CopySourceIfMatch string 可选 如果源对象的ETag值与该参数值相同，则进行复制，否则返回错误。 CopySourceIfNoneMatch string 可选 如果源对象的ETag值与该参数值不相同，则进行复制，否则返回错误。 CopySourceIfUnmodifiedSince time.Time 可选 如果源对象的修改时间晚于该参数值指定的时间，则进行复制，否则返回错误。 CopySourceIfModifiedSince time.Time 可选 如果源对象的修改时间早于该参数值指定的时间，则进行复制，否则返回错误。 WebsiteRedirectLocation string 可选 当桶设置了Website配置，该参数指明对象的重定向地址。 SseHeader SseCHeader 或 SseKmsHeader 可选 服务端加密头信息，用于加密目标对象。 SourceSseHeader SseCHeader 可选 服务端解密头信息，用于解密源对象。 CacheControl string 可选 复制时重写响应中的Cache-Control头。 ContentDisposition string 可选 复制时重写响应中的Content-Disposition头。 ContentEncoding string 可选 复制时重写响应中的Content-Encoding头。 ContentLanguage string 可选 复制时重写响应中的Content-Language头。 ContentType string 可选 复制时重写响应中的Content-Type头。 Expires string 可选 复制时重写响应中的Expires头。 StorageClass StorageClassType 可选 复制时设置对象的存储类型。 Metadata map[string]string 可选 目标对象的自定义元数据。 GrantReadId string 可选 授权指定租户有读对象和获取对象元数据的权限。 GrantReadAcpId string 可选 授权指定租户有获取对象ACL的权限。 GrantWriteAcpId string 可选 授权指定租户有写对象ACL的权限。 GrantFullControlId string 可选 授权指定租户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限。 SuccessActionRedirect string 可选 指定当此次请求操作成功响应后的重定向的地址。 如果包含CopySourceIfUnmodifiedSince并且不符合，或者包含CopySourceIfMatch并且不符合，或者包含CopySourceIfModifiedSince并且不符合，或者包含CopySourceIfNoneMatch并且不符合，则复制对象失败，返回错误：412 precondition failed。

参数描述 字段名 类型 约束 说明 Bucket string 必选 桶名。 Quiet bool 可选 批量删除对象的响应方式，false表示详细模式，返回的删除成功和删除失败的所有结果；true表示简单模式，只返回的删除过程中出错的结果。 Objects []ObjectToDelete 必选 待删除的对象列表。 EncodingType string 可选 用于指定待删除的对象Key和响应中的对象Key的编码类型。如果Key包含xml 1.0标准不支持的控制字符，可通过设置该参数指定对象Key的编码类型。 可选值：url。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 Deleteds []Deleted 删除成功的对象列表。 Errors []Error 删除失败的对象列表。 EncodingType string 响应中的Key的编码类型。

参数描述 字段名 类型 约束 说明 Bucket string 必选 桶名。 Key string 必选 对象名。 VersionId string 可选 对象的版本号。 Origin string 可选 预请求指定的跨域请求Origin（通常为域名）。 RequestHeader string 可选 跨域请求可以使用的HTTP头域。 SseHeader SseCHeader 可选 服务端解密头信息。

参数描述 字段名 类型 约束 说明 Bucket string 必选 桶名。 Key string 必选 对象名。 VersionId string 可选 对象的版本号。 ACL AclType 可选 预定义访问策略。 Owner Owner 可选 对象的所有者。 Grants []Grant 可选 被授权用户权限信息。 Delivered string 可选 设置对象ACL是否继承桶的ACL。 Owner和Grants必须配套使用，且与ACL互斥。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 VersionId string 对象的版本号。 Owner Owner 对象的所有者。 Grants []Grant 被授权用户权限信息。 Delivered string 对象ACL是否继承桶的ACL。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 StorageClass StorageClassType 对象的存储类型。 AllowOrigin string 如果请求中的Origin满足桶的CORS规则，则返回CORS规则中的AllowedOrigin。 AllowHeader string 如果请求的RequestHeader满足桶的CORS规则，则返回CORS规则中的AllowedHeader。 AllowMethod string 桶CORS规则中的AllowedMethod。 ExposeHeader string 桶CORS规则中的ExposeHeader。 MaxAgeSeconds int 桶CORS规则中的MaxAgeSeconds。 ContentLength int64 对象数据的长度。 ContentType string 对象的MIME类型。 LastModified time.Time 对象的最近一次修改时间。 ETag string 对象的ETag值。 VersionId string 对象的版本号。 Restore string 归档存储类型对象的恢复状态，如果对象不为归档存储类型，则该值为空。 Expiration string 对象的详细过期信息。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。 WebsiteRedirectLocation string 当桶设置了Website配置，该参数指明对象的重定向地址。 Metadata map[string]string 对象自定义元数据。 ObjectType string 对象类型，对象为非Normal对象时，会返回此头域。 NextAppendPosition string 下次追加位置。

参数描述 字段名 类型 约束 说明 Bucket string 必选 桶名。 Key string 必选 对象名。 ACL AclType 可选 预定义访问策略。 WebsiteRedirectLocation string 可选 当桶设置了Website配置，该参数指明对象的重定向地址。 ContentType string 可选 对象的MIME类型。 SseHeader SseCHeader 或 SseKmsHeader 可选 服务端加密头信息。 StorageClass StorageClassType 可选 对象的存储类型。 Metadata map[string]string 可选 对象的自定义元数据信息。 GrantReadId string 可选 授权指定租户有读对象和获取对象元数据的权限。 GrantReadAcpId string 可选 授权指定租户有获取对象ACL的权限。 GrantWriteAcpId string 可选 授权指定租户有写对象ACL的权限。 GrantFullControlId string 可选 授权指定租户有读对象、获取对象元数据、获取对象ACL、写对象ACL的权限。 Expires int64 可选 表示对象的过期时间。 EncodingType string 可选 用于指定对响应中的Key进行指定类型的编码。如果Key包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的Key进行编码。 可选值：url。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 Bucket string 分段上传任务的桶名。 Key string 分段上传任务的对象名。 UploadId string 分段上传任务的ID。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。 EncodingType string 分段上传对象Key的编码类型。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 PartNumber int 段号。 ETag string 当前上传段的ETag值。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。

参数描述 字段名 类型 约束 说明 Bucket string 必选 桶名。 Key string 必选 对象名。 PartNumber int 必选 段号，取值范围：1~10000。 UploadId string 必选 分段上传任务的ID。 ContentMD5 string 可选 待上传段数据的MD5值（经过Base64编码），提供给OBS服务端，校验数据完整性。 SseHeader SseCHeader 可选 服务端加密头信息。 Body io.Reader 可选 待上传段的数据流。 SourceFile string 可选 待上传段的源文件路径。 Offset int64 可选 源文件中某一分段的起始偏移大小，默认值为0， 单位为字节。 PartSize int64 可选 源文件中某一分段的大小，默认值为文件大小减去Offset的剩下字节数，单位为字节。 Body与SourceFile不能同时使用。 当Body与SourceFile都为空时，上传对象的大小为0字节。 Offset、PartSize和SourceFile配套使用，用于指定上传源文件中的某一分段数据。

参数描述 字段名 类型 约束 说明 Bucket string 必选 目标桶名。 Key string 必选 目标对象名。 PartNumber int 必选 段号，取值范围：1~10000。 UploadId string 必选 分段上传任务的ID。 CopySourceBucket string 必选 源桶名。 CopySourceKey string 必选 源对象名。 CopySourceVersionId string 可选 源对象版本号。 CopySourceRangeStart int64 可选 指定复制源对象的起始位置，非负整数。 CopySourceRangeEnd int64 可选 指定复制源对象的结束位置。如果该值大于源对象长度-1，实际仍取源对象长度-1。 SseHeader SseCHeader 可选 服务端加密头信息，用于加密目标对象。 SourceSseHeader SseCHeader 可选 服务端加密头信息，用于解密源对象。

参数描述 字段名 类型 约束 说明 Bucket string 必选 桶名。 Key string 必选 对象名。 UploadId string 必选 分段上传任务的ID。 PartNumberMarker int 可选 列举已上传段的起始位置，只有PartNumber大于该参数的段会被列出。 MaxParts int 可选 列举已上传段的返回结果最大段数目，即分页时每一页中段数目。 EncodingType string 可选 对响应中的Key进行指定类型的编码。如果Key包含xml 1.0标准不支持的控制字符，可通过设置该参数对响应中的Key进行编码。 可选值：url。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 ETag string 目标段的ETag值。 LastModified time.Time 目标段的最近一次修改时间。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。 PartNumber int 段号。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 ETag string 合并段后根据各个段的ETag值计算出的结果。 Bucket string 合并段所在的桶。 Key string 合并段后得到的对象名。 Location string 合并段后得到的对象的url。 VersionId string 合并段后得到的对象版本号。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。 EncodingType string 对象Key的编码类型。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 Bucket string 桶名。 Key string 对象名。 UploadId string 分段上传任务的ID。 Initiator Initiator 分段上传任务的创建者。 Owner Owner 和initiator相同，代表分段上传任务的创建者。 StorageClass string 待分段上传的对象的存储类型。 PartNumberMarker int 列举段的起始位置，与请求中的该参数对应。 NextPartNumberMarker int 下次列举段请求的起始位置。 MaxParts int 列举段的返回结果最大段数目，与请求中的该参数对应。 IsTruncated bool 表明本次请求是否返回了全部结果，true表示没有返回全部结果；false表示已返回了全部结果。 Parts []Part 已上传段信息列表。 EncodingType string 对象Key的编码类型。

参数描述 字段名 类型 说明 StatusCode int HTTP状态码。 RequestId string OBS服务端返回的请求ID。 ResponseHeaders map[string][]string HTTP响应头信息。 Body io.ReadCloser 对象的数据流。 DeleteMarker bool 标识删除的对象是否是删除标记。 StorageClass StorageClassType 对象的存储类型。 AllowOrigin string 如果请求中的Origin满足桶的CORS规则，则返回CORS规则中的AllowedOrigin。 AllowHeader string 如果请求的RequestHeader满足桶的CORS规则，则返回CORS规则中的AllowedHeader。 AllowMethod string 桶CORS规则中的AllowedMethod。 ExposeHeader string 桶CORS规则中的ExposeHeader。 MaxAgeSeconds int 桶CORS规则中的MaxAgeSeconds。 ContentLength int64 对象数据的长度。 CacheControl string 响应中的Cache-Control头。 ContentDisposition string 响应中的Content-Disposition头。 ContentEncoding string 响应中的Content-Encoding头 ContentLanguage string 响应中的Content-Language头 ContentType string 对象的MIME类型。 Expires string 响应中的Expires头。 LastModified time.Time 对象的最近一次修改时间。 ETag string 对象的ETag值。 VersionId string 对象的版本号。 Restore string 归档存储类型对象的恢复状态，如果对象不为归档存储类型，则该值为空。 Expiration string 对象的详细过期信息。 SseHeader SseCHeader 或 SseKmsHeader 服务端加密头信息。 WebsiteRedirectLocation string 当桶设置了Website配置，该参数指明对象的重定向地址。 Metadata map[string]string 对象自定义元数据。 从Body字段中读取数据完成后必须调用其Close方法关闭。