文档首页 > > API参考> API> 手写字母数字识别

手写字母数字识别

分享
更新时间: 2019/09/12 21:41

功能介绍

文字识别OCR手写字母数字识别用于识别用户上传的手写字母数字图片(或者用户提供的华为云上OBS的手写字母数字图片文件的URL)中的字母数字内容,并将识别的结果返回给用户。

URI

URI格式:

POST /v1.0/ocr/handwriting

请求消息

手写字母数字识别请求参数说明请参见 表1
表1 请求参数说明

参数

是否必选

参数类型

说明

image

与url二选一

String

图像数据,base64编码,要求base64编码后大小不超过10M。图片最小边不小于15像素,最长边不超过4096像素,支持JPG/PNG/BMP/TIFF格式。

url

与image二选一

String

图片的URL路径,目前仅支持华为云上OBS提供的匿名公开授权访问的URL以及公网URL。

text_type

Array of strings

指定图片内包含的手写字符类型,预留扩展。目前仅支持数字和大写字母识别,内部数据类型为String,默认值为["digit","upper_letter"]。

detect_direction

Boolean

图片朝向检测开关,可选值包括:

  • true:检测图片朝向
  • false:不检测图片朝向

支持图片朝向逆时针旋转0/90/180/270度检测。默认值为false即不检测图片朝向,只支持正常角度的图片识别

响应消息

手写字母数字识别响应参数说明请参见 表2
表2 响应参数说明

参数

参数类型

说明

result

Object

调用成功时表示调用结果。

调用失败时无此字段。

direction

Integer

图片朝向,仅当detect_direction为true时,该字段有效。

0:表示正向;

90:表示逆时针旋转90度;

180:表示逆时针旋转180度;

270:表示逆时针旋转270度。

当detect_direction为false时,该字段值为 -1。

words_region_count

Integer

文字区域数目。

words_region_list

Integer

文字区域识别结果列表,输出顺序从左到右,先上后下。

type

String

文字区域类型。

  • text:文本识别区域
  • table:表格识别区域

words_block_count

String

子区域识别字母数字块数目。

words_block_list

Array of objects

子区域识别字母数字块列表,输出顺序从左到右,先上后下。

words

String

字母数字识别结果。

rows

Array of integer

识别字母数字块占用的行信息,编号从0开始,列表形式,数据类型为Integer,可识别跨行字母或数字。仅在表格区域内有效,即type字段为"table"时该字段有效。

columns

String

识别字母数字块占用的列信息,编号从0开始,列表形式,数据类型为Integer,可识别跨列字母或数字。仅在表格区域内有效,即type字段为"table"时该字段有效。

error_code

String

调用失败时的错误码,具体请参见错误码

调用成功时无此字段。

error_msg

String

调用失败时的错误信息。

调用成功时无此字段。

示例

  • 请求示例(方式一:使用图片的BASE64编码)
    POST https://{endpoint}/v1.0/ocr/handwriting 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...     
     Request Body:
     { 
        "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA...",
        "text_type":["digit","upper_letter"],
        "detect_direction":false
      }
  • 请求示例(方式二:使用图片URL)
    POST https://{endpoint}/v1.0/ocr/handwriting 
        
     Request Header:   
     Content-Type: application/json   
     X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...      
     Request Body:
     {
         "url":"https://BucketName.obs.myhuaweicloud.com/ObjectName",
         "text_type":["digit","upper_letter"],
         "detect_direction":false
      }
说明:

Endpoint即调用API的请求地址,不同服务不同区域的Endpoint不同,具体请参见终端节点

例如手写字母数字识别服务部署在“华北-北京四”区域的Endpoint为“ocr.cn-north-4.myhuaweicloud.com”,请求URL为“POST https://ocr.cn-north-4.myhuaweicloud.com/v1.0/ocr/handwriting”。

  • 成功响应示例
    {
        "result": {
            "direction": -1,
            "words_region_count": 2,
            "words_region_list": [
                {
                   "type": "text",
                   "words_block_count": 1,
                   "words_block_list": [  
                        {
                           "words":"文字区域识别字母数字块1"
                        }
                    ]
                },
                {
                   "type": "table",
                   "words_block_count": 2,
                   "words_block_list": [
                       {
                            "words":"表格区域识别字母数字块1",
                            "rows":[
                                0
                            ],
                            "columns":[
                                0
                            ]
                        },
                        {
                            "words":"表格区域识别字母数字块2",
                            "rows":[
                                0
                            ],
                            "columns":[
                                1,
                                2
                            ]
                        }
                    ]
                }
            ]
        }
    }
  • 失败响应示例
    {
        "error_code": "AIS.0105",
        "error_msg": "Recognize Failed"
    }

状态码

状态码请参见状态码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区