银行对账单 OCR

读取泰国银行对账单，返回账户信息和完整的交易表。

POST/ocr/v3/bank-statement/file试一试

价格1 IC每页
累计调用21.8K次

v1.0
运行中

输入

输出POST /ocr/v3/bank-statement/file

bank_name: ธนาคารกสิกรไทย
account_holder_name: น.ส. สมหญิง ตัวอย่าง
account_number: XXX-2-48512-X
account_type: เงินฝากออมทรัพย์
branch: สาขาซีคอนสแควร์ 2
period_from: 01-04-2018
period_to: 20-09-2018
total_withdrawal_amount: 101797.39
total_deposit_amount: 101780.19
transactions: date: 10-09-2018 description: ฝากเงินสด ไม่มีสมุดคู่ฝาก withdrawal: — deposit: 100 balance: 206.14 channel: 0929

全部字段见“响应”一节

请求

curl -X POST "https://api.iapp.co.th/ocr/v3/bank-statement/file" \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "target_lang=th" \
  -F "include_confidence=true"

响应

200成功。字段在"响应"一节说明。

{
    "docs": [
        {
            "message": "success",
            "raw": {},
            "processed": {
                        "bank_name": "ธนาคารกสิกรไทย",
                        "account_holder_name": "น.ส. สมหญิง ตัวอย่าง",
                        "account_number": "XXX-2-48512-X",
                        "account_type": "เงินฝากออมทรัพย์",
                        "branch": "สาขาซีคอนสแควร์ 2",
                        "period_from": "01-04-2018",
                        "period_to": "20-09-2018",
                        "total_withdrawal_amount": 101797.39,
                        "total_deposit_amount": 101780.19,
                        "transactions": [
                                    {
                                                "date": "10-09-2018",
                                                "description": "ฝากเงินสด ไม่มีสมุดคู่ฝาก",
                                                "withdrawal": null,
                                                "deposit": 100.0,
                                                "balance": 206.14,
                                                "channel": "0929"
                                    }
                        ]
            },
            "confidence": {
                        "bank_name": 0.95,
                        "account_holder_name": 0.95,
                        "account_number": 0.95,
                        "account_type": 0.95,
                        "branch": 0.95,
                        "period_from": 0.95
            },
            "process_ms": 4120
        }
    ],
    "docs_count": 1,
    "process_ms": 4300
}

请求

multipart/form-data，仅支持文件上传，没有 Base64 形式。PDF 逐页读取，每页计费。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

对账单。PDF、JPEG、PNG 或 WEBP，最大 50 MB。可重复：一次请求多份文档。

return_ocrboolean

设为 true 时附带原始 OCR 文本。

target_langstring

提取值的语言：th（默认）、en 或 auto（与文档语言一致）。

include_confidenceboolean

默认 true：每个字段附 0.00 至 1.00 的置信度。

/v3/store/ocr/bank-statement 是 store 前缀下的同一端点。

响应

响应头 iapp-input-pages 为计费页数。

docsarray

每份读取的文档一项

docs.processedobject

从文档读取的字段

docs.processed.bank_namestring

银行

docs.processed.account_holder_namestring

账户持有人

docs.processed.account_numberstring

按印刷原样，含掩码 X

docs.processed.account_typestring

例如 เงินฝากออมทรัพย์

docs.processed.branchstring

支行

docs.processed.period_fromdocs.processed.period_to

对账期间

docs.processed.total_withdrawal_amountdocs.processed.total_deposit_amount

合计，泰铢

docs.processed.transactionsarray

每笔交易一行

docs.messagestring

状态信息

docs.rawobject

原始 OCR 文本，按需返回

docs.confidenceobject

各字段置信度，0 到 1

docs.process_msinteger

处理耗时，毫秒

docs_countinteger

读取的文档数

process_msinteger

处理耗时，毫秒

状态码

代码	含义
400	不支持的文件扩展名，或文件超过 50 MB
404	URL 中的文档类型未知
422	未附加文件
500	处理错误；响应中含可向支持团队引用的代码

详情

实测

在内部评估集上测得的字段级准确率：真实泰国文档，标注经人工复核，包含低分辨率照片和被手写部分遮盖的账单。

指标	结果
银行对账单，2 份文档，10 个字段	100%
全部六种文档类型，25 份文档，147 个字段	98.6%

限制

仅提取上述字段。
扫描质量差、反光或手写覆盖印刷内容会降低准确率。优先使用原始 PDF，或在均匀光线下正对拍摄、以 300 dpi 以上扫描，并将低置信度字段转人工复核。

数据处理

依 PDPA 与 GDPR 取得同意并告知当事人，由作为数据控制者的您负责。

请求​

响应​

详情​

请求

响应

详情