功能介绍

识别保险单图片上的文字信息，并将识别的结构化结果返回给用户。支持对多板式保险单的扫描图片及手机照片进行结构化信息提取。

约束与限制

• 只支持识别PNG、JPG、JPEG、BMP、TIFF格式的图片。
• 图像各边的像素在15到8192px之间。
• 图像中保险单区域有效占比超过70%，保证整张保险单及其边缘包含在图像内。
• 支持图像中保险单旋转、支持少量扭曲。
• 能处理暗光等干扰的图片但影响识别精度。
• 覆盖常见保险公司的常见保单版式，由于即使是同一家保险公司，保险种类也繁多而且都在动态变化，实际支持情况请以实际测试效果为准。

调试

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

前提条件

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

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

URI

POST https://{endpoint}/v2/{project_id}/ocr/insurance-policy

请求参数

响应参数

状态码： 200

状态码： 400

请求示例

• 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/insurance-policy”，“project_id”为项目ID，获取方法请参见获取项目ID。
• 如何获取Token请参见认证鉴权。

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

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

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

  POST https://{endpoint}/v2/{project_id}/ocr/insurance-policy
  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/insurance-policy"
  token = "用户获取得到的实际token值"
  headers = {'Content-Type': 'application/json', 'X-Auth-Token': token}
  
  imagepath = r'./data/insurance-policy-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" : {
    "bill_number" : {
      "words" : "192365331963636",
      "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
    },
    "company" : {
      "words" : "华夏人寿保险股份有限公司",
      "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
    },
    "effective_date" : {
      "words" : "见特别约定",
      "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
    },
    "applicant_name" : {
      "words" : "杨建国",
      "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
    },
    "applicant_id_type" : {
      "words" : "身份证",
      "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
    },
    "applicant_id_number" : {
      "words" : "214631270006529342",
      "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
    },
    "insurant_list" : [ {
      "insurant_name" : {
        "words" : "惠秀梅",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "insurant_sex" : {
        "words" : "女",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "insurant_id_type" : {
        "words" : "身份证",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "insurant_id_number" : {
        "words" : "XXXXXXXXXXXXXXXX",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      }
    } ],
    "beneficiary_list" : [ {
      "beneficiary_name" : {
        "words" : "XXX",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "beneficiary_type" : {
        "words" : "生存保险金",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "beneficiary_order" : {
        "words" : "第一顺序",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "beneficiary_share" : null
    } ],
    "insurance_list" : [ {
      "insurance_name" : {
        "words" : "华夏黄金甲两全保险（分红型）",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "insurance_period" : {
        "words" : "2025年7月17日零时",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "insurance_amount" : {
        "words" : "RMB50000.00",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "payment_frequency" : {
        "words" : "月交",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      },
      "payment_period" : {
        "words" : "2017年7月17日零时",
        "location" : [ [ 10, 10 ], [ 20, 25 ], [ 20, 35 ], [ 10, 35 ] ]
      }
    } ]
  }
}

状态码： 400

失败响应样例

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

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。