泰国身份证 OCR

读取泰国国民身份证正面的号码、姓名、地址和日期，以及背面的激光码，并附各字段置信度。

POST/v3/store/ekyc/thai-national-id-card/front

另有 1 个端点

试一试

• 价格1.25 IC每页
• 实测98.0%
• 承载5,000 张/小时
• 累计调用24.1M次

• v3.6.0-20260824
• 更新 2026 年 8 月 24 日
• 运行中
• 基准报告 (PDF)

输入

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

id_number

3411700830334

th_name

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

en_name

Mrs. Bunyang Lopez

en_dob

22 Mar. 1957

address

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

province

ชลบุรี

detection_score

0.979

全部字段见“响应”一节其他端点：/back 见请求

请求

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

响应

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

{
    "id_number": "3411700830334",
    "th_name": "นาง บุญยัง โลเปช",
    "en_name": "Mrs. Bunyang Lopez",
    "en_dob": "22 Mar. 1957",
    "address": "33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "province": "ชลบุรี",
    "detection_score": 0.979
}

请求

multipart/form-data，每次一张证件的一面。若是拍摄的复印件，请使用拍摄的泰国身份证复印件识别与签名检测。

请求头

apikeystring必填

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

请求体

filefile必填

证件图像。JPEG、PNG、HEIC、HEIF 或 PDF，最大 10 MB；证件在图像中至少 600 × 400 像素，建议 1,000 × 630 以上。

fieldsstring

以逗号分隔的响应字段子集。省略则返回全部。仅正面。

optionsstring

以逗号分隔。get_bbox 为每个字段附加 [x1, y1, x2, y2] 框与分数；get_image 附加每个字段的 Base64 裁剪图；get_original 附加自动校正前的值；not_crop_card 与 not_rotate_card 跳过裁剪和旋转；id_check 拒绝校验位不通过的身份证号；gray_check 拒绝黑白图像。

端点	返回	价格
/v3/store/ekyc/thai-national-id-card/front	正面全部字段	每页 1.25 IC
/v3/store/ekyc/thai-national-id-card/back	激光码	每页 0.75 IC

旧路径 /thai-national-id-card/v3.5/front 与 /thai-national-id-card/v3.5.1/back 仍可用，价格相同。

响应

正面，如右侧面板所示：

id_numberid_number_status

13 位号码，以及是否找到

th_initth_fnameth_lnameth_nameen_initen_fnameen_lnameen_name

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

th_dobth_issueth_expireen_doben_issueen_expire

出生、签发与到期日期，按各语言印刷格式

addresshouse_novillage_novillagealleylaneroadsub_districtdistrictprovincepostal_code

印刷地址及其组成部分；邮政编码由数据库查得

genderreligion

按印刷；证件未标注宗教时 religion 为空

face

照片，Base64 JPEG

confidence

各字段 0 至 1

detection_scoreerror_messageprocess_timerequest_id

证件检测分数、错误信息（如有）、秒

背面返回 back_number，即 12 位激光码，以及 detection_score 与 process_time。

状态码

代码	含义
420、430	图像中未找到身份证（正面、背面）
421、431	不支持或已损坏的图像
422、432	图像尺寸超出限制
424	身份证号有 13 位但校验位不通过，使用 id_check 时
425	身份证号不足 13 位，使用 id_check 时
426、436	黑白图像，使用 gray_check 时
434	背面未找到激光码
435	激光码不足 12 位，使用 id_check 时
413	文件过大
427、428	处理或排队超时
461	未附加文件
560	服务器繁忙，请重试
563	无法处理该图像

详情

实测

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

指标	结果
身份证号	100%
英文姓、称谓、性别、宗教	100%
子区、区、邮政编码、府、日期	100%
完整地址	98.3%
泰文全名	93.3%
全部字段	98.0%
中位耗时	正面每张 1.4 秒；背面 1.3 秒
持续吞吐	每小时 5,000 张，生产环境，2026 年 8 月

2026 年 8 月的引擎使泰文全名由 96.7% 降至 93.3%：若以泰文姓名而非号码或地址进行匹配，请检查该字段的置信度。方法、逐字段结果及与领先云 OCR 的对比：基准报告 (PDF)。

限制

• 以 300 dpi 及以上拍摄；建议 600 dpi、文件小于 5 MB。
• 请检查 detection_score，并在您的系统中校验身份证号格式。

数据处理

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

更新日志

版本	日期	变更
v3.6.0-20260824	2026 年 8 月 24 日	英文日期（en_dob、en_issue、en_expire）现与证件印刷一致：缩写月份带点（23 Apr. 1997），全拼的 May 不带点；日期解析需接受带点形式。
v3.5.3-20260824	2026 年 8 月 24 日	新引擎：字段级准确率由 97.8% 提升至 98.0%，地址、府和到期日提升最大；可本地部署。
3.5	2022 年 11 月	新 OCR 引擎，更快；字符准确率 98.13%。
3.4	2022 年 7 月	新增泰国军衔；93.25%。
3.0	2021 年 2 月	准确率 91.75%。
2.0	2020 年 2 月	支持背面；85%。
1.0	2019 年 11 月	首次发布；76%。