功能介绍

识别用户上传的表格图片中的文字内容，并将识别的结果返回给用户。

约束与限制

• 只支持识别PNG、JPG、JPEG、BMP、TIFF格式的图片。
• 图像各边的像素大小在15px到8192px之间。
• 图像中识别区域有效占比超过80%，保证整张表格及其边缘包含在图像内。
• 支持图像任意角度的水平旋转。
• 目前不支持复杂背景（如户外自然场景、防伪水印等）和表格线扭曲图像的文字识别。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

前提条件

在使用财务报表识别之前，需要您完成服务申请和认证鉴权，具体操作流程请参见开通服务和认证鉴权章节。

用户首次使用需要先申请开通。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示ModelArts.4204报错，请在调用服务前先进入控制台开通服务，并注意开通服务区域与调用服务的区域保持一致。

URI

POST https://{endpoint}/v2/{project_id}/ocr/financial-statement

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

• Endpoint即调用API的请求地址，不同服务不同区域的Endpoint不同，具体请参见终端节点。 例如，财务报表识别服务部署在“华东-上海一”区域的“endpoint”为“ocr.cn-east-3.myhuaweicloud.com”或“ocr.cn-north-4.myhuaweicloud.cn”，请求URL为“https://ocr.cn-east-3.myhuaweicloud.com/v2/{project_id}/ocr/insurance-policy”，“project_id”为项目ID，获取方法请参见获取项目ID。
• 如何获取Token请参见认证鉴权。

• 请求样例（方式一：使用图片的Base64编码）

  POST https://{endpoint}/v2/{project_id}/ocr/financial-statement
  Request Header:
  Content-Type: application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  Request Body:
  {
    "image" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
  }

• 请求样例（方式二：使用图片URL）

  POST https://{endpoint}/v2/{project_id}/ocr/financial-statement
  Request Header:
  Content-Type: application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  Request Body:
  {
    "url" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..."
  }

• Python3语言请求代码示例（其他语言参照下列示例编写或使用OCR SDK）

  # encoding:utf-8
  
  import requests
  import base64
  
  url = "https://{endpoint}/v2/{project_id}/ocr/financial-statement"
  token = "用户获取得到的实际token值"
  headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
  
  imagepath = r'./data/financial-statement-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)

响应示例

状态码： 200

成功响应样例

{
  "result" : {
    "words_region_count" : 2,
    "words_region_list" : [ {
      "type" : "text",
      "words_block_count" : 1,
      "words_block_list" : [ {
        "words" : "文字区域识别文字块1",
        "confidence" : 0.999
      } ]
    }, {
      "type" : "table",
      "table_location" : [ [ 120, 106 ], [ 200, 106 ], [ 200, 351 ], [ 120, 351 ] ],
      "words_block_count" : 2,
      "words_block_list" : [ {
        "words" : "负债和所有者权益（或股东权益）",
        "confidence" : 0.9963,
        "rows" : [ 0 ],
        "columns" : [ 0 ]
      }, {
        "words" : "行次",
        "confidence" : 0.9999,
        "rows" : [ 0 ],
        "columns" : [ 1 ]
      } ]
    } ],
    "excel" : "AQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKg…",
    "image_size" : {
      "height" : 2501,
      "width" : 1701
    }
  }
}

状态码： 400

失败响应样例

{
  "error_code" : "AIS.0103",
  "error_msg" : "The image size does not meet the requirements."
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。