拍摄的泰国身份证复印件识别与签名检测

读取拍摄或复印的泰国国民身份证（彩色或黑白），返回号码、姓名、日期和地址及各字段置信度，并判断复印件是否已签名。

POST/v3/store/ekyc/thai-national-id-card-with-signature试一试

• 价格1.25 IC每页
• 实测97.1%
• 承载10,500 张/小时
• 累计调用49.6K次

• v1.1.1-20260822
• 更新 2026 年 8 月 22 日
• 运行中
• 基准报告 (PDF)

输入

输出POST /v3/store/ekyc/thai-national-id-card-with-signature

national_id

3411700830334

fullname_th

นาง บุญยัง โลเปช

fullname_en

Mrs. Bunyang Lopez

date_of_birth

22 มี.ค. 2500

address_full

33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี

reason_code_id_card_signature

1

process_time

0.7

全部字段见“响应”一节

请求

curl -X POST https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@idcard.jpg"

响应

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

{
    "national_id": "3411700830334",
    "fullname_th": "นาง บุญยัง โลเปช",
    "fullname_en": "Mrs. Bunyang Lopez",
    "date_of_birth": "22 มี.ค. 2500",
    "address_full": "33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "reason_code_id_card_signature": 1,
    "process_time": 0.7
}

请求

multipart/form-data，每次一张证件。若是实体证件的照片，请使用泰国身份证 OCR。

请求头

apikeystring必填

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

请求体

filefile必填

证件正面的照片或复印件。JPEG、PNG、HEIC 或 HEIF，最大 2 MB；证件在图像中至少 600 × 400 像素。

旧路径 /thai-national-id-card-with-signature/front 与 /thai-national-id-card/copy 仍可用，价格相同。

响应

national_idstring

13 位号码

init_thinit_enname_thname_ensurname_thsurname_enfullname_thfullname_en

称谓、名、姓与全名，泰文和英文

date_of_birthdate_of_expire

泰式格式，按印刷

address_fulladdress_numberaddress_subdistrictaddress_districtaddress_provinceaddress_postal_code

印刷地址及其组成部分；邮政编码为推导值

reason_code_id_cardreason_code_id_card_national_idreason_code_id_card_signature

找到证件、号码和签名时为 1，否则为 0

confidence

各字段 0 至 1：national_id、fullname_th、date_of_birth、address_full

process_timerequest_idfile_name_id_cardreason_code_api

秒、网关请求 id、文件名、状态码

状态码

代码	含义
200	成功
413	文件超过 2 MB
414	未附加文件
415、422	图像尺寸超出限制
420	图像中未找到身份证
421	不支持或已损坏的图像
427、428	处理或排队超时
560	服务器繁忙，请重试
563	无法处理该图像

详情

实测

以人工核对的数据为基准：33 张真实证件，594 个字段观测。数据集不公开。

指标	结果
身份证号	100%
门牌号	97.0%
完整地址	93.9%
全部字段	97.1%
签名检测	96.5%
中位耗时	每张 0.7 秒
持续吞吐	每小时 10,500 张，生产环境，2026 年 8 月

方法、逐字段结果及与领先云 OCR 的对比：基准报告 (PDF)。

限制

• 300 dpi 及以上的扫描效果最佳。
• 证件模糊或在画面中占比过小时识别效果较差。

数据处理

图像在内存中处理，响应返回后不保留。服务符合 GDPR 与 PDPA。如需证件数据不出您网络的本地部署，请联系我们。

更新日志

版本	日期	变更
v1.1.1-20260822	2026 年 8 月 22 日	新引擎：字段级准确率由 96.3% 提升至 97.1%，门牌号和地址提升最大；可本地部署。
v1.0	2023 年	首次发布，含签名检测。