车辆登记证 OCR

读取泰国车辆登记证，返回车辆及所有权信息。

POST/ocr/v3/vehicle-registration/file试一试

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

• v1.0
• 运行中

输入

输出POST /ocr/v3/vehicle-registration/file

registration_date

27 มิถุนายน 2562

license_plate

1กข 1234

province

กรุงเทพมหานคร

vehicle_type

รถยนต์นั่งส่วนบุคคลไม่เกิน 7 คน

brand

ISUZU

model

mu-X

year

2019

color

ขาว

body_number

MP1TFR85XKT000000

engine_number

4JJ1XX0000

fuel_type

ดีเซล

seating_capacity

7

owner_name

นายสมชาย ตัวอย่าง

owner_id

1100000000001

owner_address

123 ถนนพหลโยธิน แขวงจตุจักร เขตจตุจักร กรุงเทพมหานคร

occupant_name

—

occupant_id

—

全部字段见“响应”一节

请求

curl -X POST "https://api.iapp.co.th/ocr/v3/vehicle-registration/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": {
                        "registration_date": "27 มิถุนายน 2562",
                        "license_plate": "1กข 1234",
                        "province": "กรุงเทพมหานคร",
                        "vehicle_type": "รถยนต์นั่งส่วนบุคคลไม่เกิน 7 คน",
                        "brand": "ISUZU",
                        "model": "mu-X",
                        "year": 2019,
                        "color": "ขาว",
                        "body_number": "MP1TFR85XKT000000",
                        "engine_number": "4JJ1XX0000",
                        "fuel_type": "ดีเซล",
                        "seating_capacity": 7,
                        "owner_name": "นายสมชาย ตัวอย่าง",
                        "owner_id": "1100000000001",
                        "owner_address": "123 ถนนพหลโยธิน แขวงจตุจักร เขตจตุจักร กรุงเทพมหานคร",
                        "occupant_name": null,
                        "occupant_id": null
            },
            "confidence": {
                        "registration_date": 0.95,
                        "license_plate": 0.95,
                        "province": 0.95,
                        "vehicle_type": 0.95,
                        "brand": 0.95,
                        "model": 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/vehicle-registration 是 store 前缀下的同一端点。

响应

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

docsarray

每份读取的文档一项

docs.processedobject

从文档读取的字段

docs.processed.registration_datedocs.processed.license_platedocs.processed.province

登记日期、车牌，以及登记府

docs.processed.vehicle_typedocs.processed.branddocs.processed.modeldocs.processed.yeardocs.processed.color

车辆：类型、品牌、型号、年款（公元）、颜色

docs.processed.body_numberdocs.processed.engine_numberdocs.processed.fuel_typedocs.processed.seating_capacity

车架号、发动机号、燃料、座位数

docs.processed.owner_namedocs.processed.owner_iddocs.processed.owner_address

最近登记的所有人：姓名、身份证或法人号、地址

docs.processed.occupant_namedocs.processed.occupant_id

占有人（如有）

docs.messagestring

状态信息

docs.rawobject

原始 OCR 文本，按需返回

docs.confidenceobject

各字段置信度，0 到 1

docs.confidence.registration_datenumber

docs.confidence.license_platenumber

docs.confidence.provincenumber

docs.confidence.vehicle_typenumber

docs.confidence.brandnumber

docs.confidence.modelnumber

docs.process_msinteger

处理耗时，毫秒

docs_countinteger

读取的文档数

process_msinteger

处理耗时，毫秒

状态码

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

详情

实测

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

指标	结果
车辆登记证，2 份文档，13 个字段	92.3%
全部六种文档类型，25 份文档，147 个字段	98.6%

限制

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

数据处理

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