💧 水费账单 OCR

1 IC每页

v1.0 活跃 2026年7月 POST /ocr/v3/water-bill/file

欢迎使用水费账单 OCR API，它是 iApp Any Documents OCR（由艾艾普科技有限公司提供）的一部分。该 API 可从泰国都会供水局 (Metropolitan Waterworks Authority - การประปานครหลวง) 和泰国省供水局 (Provincial Waterworks Authority - การประปาส่วนภูมิภาค) 的账单中提取账单数据，包括仪表读数、消耗量和增值税。为了提高低质量图像的可靠性，金额会经过算术交叉检查（小计 + 增值税 = 总计）。

试用演示！

试用 AI 演示

登录或创建免费账户来使用此 AI 服务演示并探索我们强大的 API。

注册即可获得 100 积分 (IC) 免费赠送！

优惠截止至 2025 年 12 月 31 日

免费创建账户登录

Example Images (Click to try)

API Key

Endpoint URL

cURL Command

上传水费账单

入门指南

前提条件
- 来自艾艾普科技的 API 密钥
- 文档文件：水费账单 (ใบแจ้งค่าน้ำประปา)
- 支持的文件格式：PDF、JPG、JPEG、PNG、WEBP
- 最大文件大小：50MB
快速入门
- 单个 POST 请求，使用 multipart/form-data
- 结构化的 JSON 输出，每个字段都有置信度得分
- 每个输入页面在 docs 中都有自己的条目，因此可以在一次请求中发送一批文档。
主要功能
- 字段级提取，带置信度评分
- 通过 target_lang 提供泰语和英语输出
- 可选的原始 OCR 文本（通过 return_ocr）
- 处理照片和扫描的 PDF
安全与合规
- 符合 GDPR 和 PDPA
- 安全的 API 端点
- 处理后不保留数据

如何获取 API 密钥？

请访问 API 密钥管理页面查看您现有的 API 密钥或申请新密钥。

API 端点

端点	方法	描述	费用
`/ocr/v3/water-bill/file` /v3/store/ocr/water-bill	POST	从泰国水费账单（MWA / PWA）中提取账单数据	每页 1 IC

这两种形式是等效的。此端点没有 base64 变体 — 仅支持文件上传。

请求

请求头

标头	值	所需
`apikey`	您的 iApp API 密钥	是

请求正文 (multipart/form-data)

参数	类型	默认值	描述
`file`	文件（可重复）	—	必需。文档文件。PDF 页面将自动处理。
`return_ocr`	布尔值	`false`	在响应中包含原始 OCR 文本。
`target_lang`	字符串	`th`	提取值的语言：`th` 或 `en`。
`include_confidence`	布尔值	`true`	包含每个字段的置信度得分（0.00–1.00）。

cURL

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"

响应

{
    "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
}

iapp-input-pages 响应头报告了账单页数。

支持的字段

字段	类型	描述
provider	字符串	发行机构，例如：การประปานครหลวง
customer_name	字符串	水费客户姓名
customer_address	字符串	服务地址
account_number	字符串	水费客户注册号
invoice_number	字符串	账单号
invoice_date	字符串	账单开具日期
current_reading	数字	当前水表读数
previous_reading	数字	上一个水表读数
consumption_cubic_meter	数字	消耗的水量（立方米）
water_usage_charge	数字	水费（泰铢）
monthly_service_fee	数字	月服务费（泰铢）
discount	数字	折扣（泰铢）
subtotal_before_vat	数字	增值税前小计（泰铢）
vat_amount	数字	增值税金额（泰铢）
total_amount	数字	应付总金额（泰铢）
due_date	字符串	付款到期日

错误处理

状态	含义
400	不支持的文件扩展名，或文件大于 50MB
401	缺少或无效的 `apikey`
402	信用余额不足
404	URL 中不存在的文档类型
422	请求未附加文件
500	处理错误 — 响应包含一个错误代码，请在联系支持时引用

代码示例

Python

import requests

url = "https://api.iapp.co.th/ocr/v3/water-bill/file"
headers = {"apikey": "YOUR_API_KEY"}
files = {"file": open("document.pdf", "rb")}
data = {"target_lang": "th", "include_confidence": "true"}

response = requests.post(url, headers=headers, files=files, data=data)
result = response.json()
print(result["docs"][0]["processed"])
print(result["docs"][0]["confidence"])

JavaScript

const form = new FormData();
form.append("file", fileInput.files[0]);
form.append("target_lang", "th");
form.append("include_confidence", "true");

const res = await fetch("https://api.iapp.co.th/ocr/v3/water-bill/file", {
  method: "POST",
  headers: { apikey: "YOUR_API_KEY" },
  body: form,
});
const result = await res.json();
console.log(result.docs[0].processed);

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.iapp.co.th/ocr/v3/water-bill/file");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["apikey: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    "file" => new CURLFile("/path/to/document.pdf"),
    "target_lang" => "th",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Java

OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", "document.pdf",
        RequestBody.create(new File("/path/to/document.pdf"),
            MediaType.parse("application/pdf")))
    .addFormDataPart("target_lang", "th")
    .build();

Request request = new Request.Builder()
    .url("https://api.iapp.co.th/ocr/v3/water-bill/file")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

Swift

let url = URL(string: "https://api.iapp.co.th/ocr/v3/water-bill/file")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")

let boundary = UUID().uuidString
request.setValue("multipart/form-data; boundary=\(boundary)",
                 forHTTPHeaderField: "Content-Type")

var data = Data()
let fileData = try Data(contentsOf: URL(fileURLWithPath: "/path/to/document.pdf"))
data.append("--\(boundary)\r\n".data(using: .utf8)!)
data.append("Content-Disposition: form-data; name=\"file\"; filename=\"document.pdf\"\r\n\r\n".data(using: .utf8)!)
data.append(fileData)
data.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)

URLSession.shared.uploadTask(with: request, from: data) { responseData, _, _ in
    if let responseData, let json = String(data: responseData, encoding: .utf8) {
        print(json)
    }
}.resume()

Kotlin

val client = OkHttpClient()

val body = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file", "document.pdf",
        File("/path/to/document.pdf").asRequestBody("application/pdf".toMediaType())
    )
    .addFormDataPart("target_lang", "th")
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/ocr/v3/water-bill/file")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body?.string())
}

Dart

import 'package:http/http.dart' as http;

final request = http.MultipartRequest(
  'POST',
  Uri.parse('https://api.iapp.co.th/ocr/v3/water-bill/file'),
);
request.headers['apikey'] = 'YOUR_API_KEY';
request.fields['target_lang'] = 'th';
request.files.add(
  await http.MultipartFile.fromPath('file', '/path/to/document.pdf'),
);

final response = await request.send();
print(await response.stream.bytesToString());

限制与最佳实践

限制

每个请求最大文件大小为 50MB
支持的格式：PDF、JPG、JPEG、PNG、WEBP
准确性取决于图像质量 — 严重损坏的扫描件、眩光和覆盖在印刷值上的手写字会降低字段级别的准确性
提取仅限于上述字段

最佳实践

如果有原始 PDF，请优先使用原始 PDF 而非照片
拍摄整个文档，正面且光线均匀
扫描件请使用至少 300 DPI
检查每个字段的 confidence 分数，并将低置信度值发送给人工复核
在支持的情况下，一次请求发送多个文档以减少往返次数

准确性与性能

字段级提取准确性是在内部 ChindaOCR-M3 金色评估数据集上测量的 — 对真实泰国文档（包括低分辨率照片和部分被手写字遮挡的账单）进行视觉重新验证的标签。

文档类型	文档数	字段数	准确性
水费账单	5	25	100%
总体，所有六种文档类型	25	147	98.6%

支持

需要帮助？联系我们：

邮箱：sale@iapp.co.th
电话：086-322-5858
Discord：iApp Technology

💧 水费账单 OCR

试用演示！

试用 AI 演示

Example Images (Click to try)

入门指南

API 端点

请求

请求头

请求正文 (multipart/form-data)

cURL

响应

支持的字段

错误处理

代码示例

Python

JavaScript

PHP

Java

Swift

Kotlin

Dart

限制与最佳实践

限制

最佳实践

准确性与性能

支持

ChindaX

SpeechFlow

ChindaGO

试用演示！​

试用 AI 演示

Example Images (Click to try)

入门指南​

API 端点​

请求​

请求头​

请求正文 (multipart/form-data)​

cURL​

响应​

支持的字段​

错误处理​

代码示例​

Python​

JavaScript​

PHP​

Java​

Swift​

Kotlin​

Dart​

限制与最佳实践​

限制​

最佳实践​

准确性与性能​

支持​

试用演示！

入门指南

API 端点

请求

请求头

请求正文 (multipart/form-data)

cURL

响应

支持的字段

错误处理

代码示例

Python

JavaScript

PHP

Java

Swift

Kotlin

Dart

限制与最佳实践

限制

最佳实践

准确性与性能

支持