1. 接口描述
接口请求域名： ocr.tencentcloudapi.com 。
本接口支持病案首页、费用清单、结算单、医疗发票四种保险理赔单据的文本识别和结构化输出。
默认接口请求频率限制：1次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：InsuranceBillOCR。 |
| Version | 是 | String | 公共参数，本接口取值：2018-11-19。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表，本接口仅支持其中的: ap-beijing, ap-guangzhou, ap-hongkong, ap-shanghai 。 |
| ImageBase64 | 否 | String | 图片的 Base64 值。 支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。 支持的图片大小：所下载图片经Base64编码后不超过 7M。图片下载时间不超过 3 秒。 图片的 ImageUrl、ImageBase64 必须提供一个，如果都提供，只使用 ImageUrl。 |
| ImageUrl | 否 | String | 图片的 Url 地址。 支持的图片格式：PNG、JPG、JPEG，暂不支持 GIF 格式。 支持的图片大小：所下载图片经 Base64 编码后不超过 7M。图片下载时间不超过 3 秒。 图片存储于腾讯云的 Url 可保障更高的下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的 Url 速度和稳定性可能受一定影响。 示例值：https://xx/a.jpg |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| InsuranceBillInfos | Array of InsuranceBillInfo | 保险单据识别结果，具体内容请点击左侧链接。 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 保险单据识别示例代码
输入示例
POST / HTTP/1.1
Host: ocr.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: InsuranceBillOCR
<公共请求参数>
{
"ImageUrl": "https://xx/a.jpg "
}输出示例
{
"Response": {
"InsuranceBillInfos": [
{
"Name": "定点医疗机构名称",
"Value": "北京南郊肿瘤医院"
},
{
"Name": "No",
"Value": "2000000000000000000"
},
{
"Name": "定点医疗机构编号",
"Value": "241560156"
},
{
"Name": "公民身份号码",
"Value": "320000195101010000"
},
{
"Name": "社保卡/手册编号",
"Value": "32100000000"
},
{
"Name": "单位",
"Value": "元(保留两位小数)"
},
{
"Name": "姓名",
"Value": "AMY"
},
{
"Name": "性别",
"Value": "男"
},
{
"Name": "年龄",
"Value": "68岁"
},
{
"Name": "病案号",
"Value": "T000000000"
},
{
"Name": "费用发生时段",
"Value": "2019-02-06至2019-02-12"
},
{
"Name": "费用总额",
"Value": "21257.17"
},
{
"Name": "共计(天)",
"Value": "6"
},
{
"Name": "日均额",
"Value": "3542.86"
},
{
"Name": "床位费总额",
"Value": "182.00"
},
{
"Name": "名称",
"Value": "普通床位费[普通床位费(24)]"
},
{
"Name": "单价",
"Value": "24.0000"
},
{
"Name": "数量",
"Value": "7.00"
},
{
"Name": "金额",
"Value": "168.00"
},
{
"Name": "医保内",
"Value": "168.00"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "二级医院住院床位费加收"
},
{
"Name": "单价",
"Value": "2.0000"
},
{
"Name": "数量",
"Value": "7.00"
},
{
"Name": "金额",
"Value": "14.00"
},
{
"Name": "医保内",
"Value": "14.00"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "护理费总额",
"Value": "44.00"
},
{
"Name": "名称",
"Value": "一级护理"
},
{
"Name": "单价",
"Value": "8.0000"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "8.00"
},
{
"Name": "医保内",
"Value": "8.00"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "二级护理"
},
{
"Name": "单价",
"Value": "6.0000"
},
{
"Name": "数量",
"Value": "6.00"
},
{
"Name": "金额",
"Value": "36.00"
},
{
"Name": "医保内",
"Value": "36.00"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "诊疗费总额",
"Value": "42.00"
},
{
"Name": "名称",
"Value": "住院诊疗费(二级医院)"
},
{
"Name": "单价",
"Value": "6.0000"
},
{
"Name": "数量",
"Value": "7.00"
},
{
"Name": "金额",
"Value": "42.00"
},
{
"Name": "医保内",
"Value": "42.00"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "药费总额",
"Value": "4526.87"
},
{
"Name": "其中西药费",
"Value": "4526.87"
},
{
"Name": "其中中成药费",
"Value": "0.00"
},
{
"Name": "其中中草药费",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "吸入用七氟烷"
},
{
"Name": "规格",
"Value": "1ml"
},
{
"Name": "单价",
"Value": "7.5400"
},
{
"Name": "数量",
"Value": "60.00"
},
{
"Name": "金额",
"Value": "452.40"
},
{
"Name": "医保内",
"Value": "452.40"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "依托咪酯注射用乳剂"
},
{
"Name": "规格",
"Value": "10ml:20mg"
},
{
"Name": "单价",
"Value": "43.4100"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "43.41"
},
{
"Name": "医保内",
"Value": "43.41"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "盐酸利多卡因注射液"
},
{
"Name": "规格",
"Value": "5ml:0.1g"
},
{
"Name": "单价",
"Value": "1.5200"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "1.52"
},
{
"Name": "医保内",
"Value": "1.52"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "盐酸利多卡因胶浆"
},
{
"Name": "规格",
"Value": "10g:0.2g"
},
{
"Name": "单价",
"Value": "7.4280"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "7.43"
},
{
"Name": "医保内",
"Value": "0.00"
},
{
"Name": "医保外",
"Value": "7.43"
},
{
"Name": "名称",
"Value": "维生素C注射液"
},
{
"Name": "规格",
"Value": "2.5ml:1g"
},
{
"Name": "单价",
"Value": "0.5700"
},
{
"Name": "数量",
"Value": "8.00"
},
{
"Name": "金额",
"Value": "4.56"
},
{
"Name": "医保内",
"Value": "4.56"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "地塞米松磷酸钠注射液"
},
{
"Name": "规格",
"Value": "1ml:5mg"
},
{
"Name": "单价",
"Value": "0.5100"
},
{
"Name": "数量",
"Value": "3.00"
},
{
"Name": "金额",
"Value": "1.53"
},
{
"Name": "医保内",
"Value": "1.53"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "左甲状腺素钠片"
},
{
"Name": "规格",
"Value": "50ug"
},
{
"Name": "单价",
"Value": "0.3110"
},
{
"Name": "数量",
"Value": "40.00"
},
{
"Name": "金额",
"Value": "12.43"
},
{
"Name": "医保内",
"Value": "12.43"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "硫酸阿托品注射液"
},
{
"Name": "规格",
"Value": "1ml:0.5mg"
},
{
"Name": "单价",
"Value": "0.7500"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "0.75"
},
{
"Name": "医保内",
"Value": "0.75"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "盐酸氨溴索注射液"
},
{
"Name": "规格",
"Value": "2ml:15mg"
},
{
"Name": "单价",
"Value": "6.2100"
},
{
"Name": "数量",
"Value": "6.00"
},
{
"Name": "金额",
"Value": "37.26"
},
{
"Name": "医保内",
"Value": "0.00"
},
{
"Name": "医保外",
"Value": "37.26"
},
{
"Name": "名称",
"Value": "盐酸托烷司琼注射液"
},
{
"Name": "规格",
"Value": "5ml:5mg"
},
{
"Name": "单价",
"Value": "97.2900"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "97.29"
},
{
"Name": "医保内",
"Value": "97.29"
},
{
"Name": "医保外",
"Value": "0.00"
},
{
"Name": "名称",
"Value": "乌拉地尔注射液"
},
{
"Name": "规格",
"Value": "5ml:25mg"
},
{
"Name": "单价",
"Value": "58.3000"
},
{
"Name": "数量",
"Value": "1.00"
},
{
"Name": "金额",
"Value": "58.30"
},
{
"Name": "医保内",
"Value": "52.47"
},
{
"Name": "医保外",
"Value": "5.83"
},
{
"Name": "名称",
"Value": "复方电解质葡萄糖MG3注射液"
},
{
"Name": "规格",
"Value": "500ml"
},
{
"Name": "单价",
"Value": "13.2000"
}
],
"RequestId": "4ff69826-ce50-41f9-acf6-1e37d068fcb8"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.DownLoadError | 文件下载失败。 |
| FailedOperation.ImageDecodeFailed | 图片解码失败。 |
| FailedOperation.ImageNoText | 图片中未检测到文本。 |
| FailedOperation.OcrFailed | OCR识别失败。 |
| FailedOperation.UnKnowError | 未知错误。 |
| FailedOperation.UnOpenError | 服务未开通。 |
| InvalidParameter.EngineImageDecodeFailed | 图片解码失败。 |
| InvalidParameterValue.InvalidParameterValueLimit | 参数值错误。 |
| LimitExceeded.TooLargeFileError | 文件内容太大。 |
| ResourceUnavailable.InArrears | 账号已欠费。 |
| ResourceUnavailable.ResourcePackageRunOut | 账号资源包耗尽。 |
| ResourcesSoldOut.ChargeStatusException | 计费状态异常。 |
