Skip to main content
本教程基于python示例分步讲解如何使用医疗票据识别API。我们另外提供了完整的多语言示例代码和在线快捷调试功能,请参考Textin文档中心

为什么使用医疗票据识别API ?

在医疗行业票据处理场景中,人工录入住院发票、费用明细、检验报告等票据信息时,常面临格式多样、字段复杂、效率低下、误差率高等痛点,而使用医疗票据识别 API,可通过自动化识别技术,快速提取 10 余种医疗票据的 6 大类关键信息,核心数据以符合行业规范的 Key/Value 形式融入 JSON 格式返回,不仅极大程度压缩单张票据处理时间,还具备比人工更高的识别精度,有效解决人工处理的效率与合规难题,降低医院财务对账、医保机构审核、第三方医疗服务平台数据录入的综合成本。

如何使用医疗票据识别API ?

您可以参考以下示例文件和步骤,快速验证并将医疗票据识别API接入到您的系统和应用流程中。 Quick start 1 Quick start 2

先决条件:获取API Key

使用医疗票据识别API处理文档时,您需要先获取API Key。请先登录后前往 TextIn工作台 - 账号与开发者信息 获取您的 x-ti-app-id 和 x-ti-secret-code 。

前置准备

您可以参考以下示例代码完成医疗票据识别API请求的前置准备工作,替换您自己的 x-ti-app-id 和 x-ti-secret-code ,后续步骤可根据实际使用场景在main函数中插入代码。

请求体说明

支持以下两种请求格式
  1. Content-Type: application/octet-stream
要上传的图片,目前支持jpg、png、bmp、pdf、tiff、ofd、单帧gif等大部分格式,ofd文件支持多页,多页pdf样本当前版本仅识别第一页内容。 请注意,请求体的数据格式为本地文件的二进制流,非 FormData 或其他格式。文件大小不超过 20M,图像宽高须介于 20 和 10000(像素)之间。
  1. Content-Type: text/plain
请求体的数据格式为文本,内容为在线文件的URL链接(支持http以及https协议)。在线文件大小不超过 20M,图像宽高须介于 20 和 10000(像素)之间。

URL参数说明

以下是医疗票据识别API的URL参数,URL参数指以 参数名=参数值 形式拼接到 URL 上的键值对。它以?开头,不同参数之间使用&连接,形如?p1=v1&p2=v2。URL参数会影响文档的解析结果和JSON输出内容,您可按需进行设置。
  • crop_image:选择是否需要进行图片切分,默认为0,关闭切分。
    • 0 关闭切分
    • 1 开启切分
  • return_image_base64:选择是否需要输出图片base64,对应image_list中image_base64,默认为0,不输出。
    • 0 不输出图片base64
    • 1 输出图片base64
  • category:指定样本类型,不进行样本分类,直接抽取结果,默认为0,不使用该功能。
    • 0 不使用该功能
    • 1 医疗住院收费票据(纸质)
    • 2 医疗门诊收费票据(纸质)
    • 3 医疗住院收费票据(电子)
    • 4 医疗门诊收费票据(电子)
    • 5 医保结算单
    • 6 医疗费用明细
    • 7 医疗处方笺
    • 8 实验室检验报告
    • 9 影像学检查报告
    • 10 门急诊病历
    • 11 出院小结
    • 12 诊断证明书
    • 13 入院记录
    • 14 病理报告
    • 15 体检报告
    • 16 病案首页
    • 17 手术记录单
  • coord_restore:调整各字段的返回坐标逻辑,选择是参照原图还是切图坐标系返回坐标,默认为0,以切图后转正图为基准。
    • 0 坐标以切图后转正图为基准
    • 1 坐标以原图为基准
  • is_same_file:当结构化多页pdf时,选择是否将多页pdf文件作为一个整体进行识别,来保证这一套票的信息结构化完整性(如你可能会遇到一份多页的出院小结票据),默认为0,将多页pdf进行拆分后,逐个进行识别。
    注:该参数与crop_image功能效果冲突,因此,开启该参数,crop_image将默认失效。
    • 0 将多页pdf进行拆分后,逐个进行识别
    • 1 将多页pdf作为一个份文件,整体进行识别

返回结果示例

票据信息结构化后的结果数据将按照以下JSON格式返回,下面为您提供了一段节选的返回示例。如果您想了解最全面的返回结果说明,可以在返回JSON结构说明中查看,也可以在API(API)中查看和调试。

错误码说明