水费账单 OCR

读取 MWA 或 PWA 的泰国水费账单，返回用户、读数和费用。

POST/ocr/v3/water-bill/file试一试

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

• v1.0
• 运行中

输入

输出POST /ocr/v3/water-bill/file

provider

การประปานครหลวง

customer_name

—

customer_address

32/14 ม.3 ตำบลท่าจีน อำเภอสามพราน จังหวัดนครปฐม 11130

account_number

67983262

invoice_number

192011-5

invoice_date

12/02/2567

current_reading

606

previous_reading

567

consumption_cubic_meter

39

water_usage_charge

430.39

monthly_service_fee

25

discount

0

subtotal_before_vat

461.24

vat_amount

32.29

total_amount

493.53

due_date

22/02/2567

全部字段见“响应”一节

请求

curl -X POST "https://api.iapp.co.th/ocr/v3/water-bill/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": {
                        "provider": "การประปานครหลวง",
                        "customer_name": null,
                        "customer_address": "32/14 ม.3 ตำบลท่าจีน อำเภอสามพราน จังหวัดนครปฐม 11130",
                        "account_number": "67983262",
                        "invoice_number": "192011-5",
                        "invoice_date": "12/02/2567",
                        "current_reading": 606,
                        "previous_reading": 567,
                        "consumption_cubic_meter": 39,
                        "water_usage_charge": 430.39,
                        "monthly_service_fee": 25.0,
                        "discount": 0.0,
                        "subtotal_before_vat": 461.24,
                        "vat_amount": 32.29,
                        "total_amount": 493.53,
                        "due_date": "22/02/2567"
            },
            "confidence": {
                        "provider": 0.95,
                        "customer_name": 0.95,
                        "customer_address": 0.95,
                        "account_number": 0.95,
                        "invoice_number": 0.95,
                        "invoice_date": 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/water-bill 是 store 前缀下的同一端点。

响应

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

docsarray

每份读取的文档一项

docs.processedobject

从文档读取的字段

docs.processed.providerstring

签发机构，例如 การประปานครหลวง

docs.processed.customer_namedocs.processed.customer_address

用户及用水地址

docs.processed.account_numberdocs.processed.invoice_numberdocs.processed.invoice_date

用水户登记号、账单号及开具日期

docs.processed.current_readingdocs.processed.previous_readingdocs.processed.consumption_cubic_meter

本次与上次读数，以及用水量（立方米）

docs.processed.water_usage_chargedocs.processed.monthly_service_feedocs.processed.discount

各项费用，泰铢

docs.processed.subtotal_before_vatdocs.processed.vat_amountdocs.processed.total_amount

合计，泰铢

docs.processed.due_datestring

缴费截止日

docs.messagestring

状态信息

docs.rawobject

原始 OCR 文本，按需返回

docs.confidenceobject

各字段置信度，0 到 1

docs.process_msinteger

处理耗时，毫秒

docs_countinteger

读取的文档数

process_msinteger

处理耗时，毫秒

状态码

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

详情

实测

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

指标	结果
水费账单，5 份文档，25 个字段	100%
全部六种文档类型，25 份文档，147 个字段	98.6%

限制

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

数据处理

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