🪪 OCR บัตรประจำตัวประชาชนไทย

1.25 ICต่อการเรียกใช้ (ด้านหน้า)|0.75 ICต่อการเรียกใช้ (ด้านหลัง)

v3.5 เปิดใช้งาน พ.ย. 2022 POST /v3/store/ekyc/thai-national-id-card

มี Mobile & Web SDK ให้ใช้งาน

ข้ามขั้นตอนการจัดการกล้อง — eKYC SDK แบบโอเพนซอร์สฟรีของเรา (Web, Flutter, iOS, Android & React Native) จะจับภาพเอกสารและใบหน้าโดยอัตโนมัติ และเรียกใช้ API นี้ให้คุณ ดูบน GitHub ได้ที่ GitHub

ยินดีต้อนรับสู่ API OCR บัตรประจำตัวประชาชนไทย เวอร์ชัน 3.5 ผลิตภัณฑ์ AI พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราออกแบบมาเพื่อแยกข้อมูลข้อความจากบัตรประจำตัวประชาชนไทยทั้งด้านหน้าและด้านหลังด้วยความแม่นยำและความเร็วสูง API ของเรารองรับไฟล์รูปแบบ JPEG, JPG, PNG, HEIC, HEIF และ PDF และสามารถประมวลผลภาพบัตรประชาชนได้ใน 1-2 วินาที

ทดลองใช้ Demo

ทดลองใช้ AI Demo

เข้าสู่ระบบหรือสร้างบัญชีฟรีเพื่อใช้งาน AI Demo และสำรวจ API ที่ทรงพลังของเรา

รับ 50 เครดิตฟรี (IC) เมื่อสมัครสมาชิก!

โปรโมชันหมดเขต 31 ธันวาคม 2568

สร้างบัญชีฟรีเข้าสู่ระบบ

Example Images (Click to try)

Try Demo

API Key

Log in to use your API keys or Create an account

Choose Endpoint URL

Endpoint URL

cURL Command

Upload Image

ทดลองใช้ SDK (กล้องสด)

ไม่ต้องการอัปโหลดไฟล์ใช่ไหม? iApp eKYC Web SDK แบบโอเพนซอร์สฟรี จะจับภาพบัตรโดยอัตโนมัติจากกล้องของคุณ — ระบบจะตรวจจับขอบเขตของบัตร รอเฟรมที่คมชัดและเสถียร ปรับมุมมองของภาพให้ถูกต้อง และส่งไปยัง API นี้ ดูขั้นตอนเพิ่มเติมได้ที่ หน้าเดโมสด SDK แบบเต็ม

Loading live demo…

Loading live demo…

เริ่มต้นใช้งาน

1. ข้อกำหนดเบื้องต้น

   • คีย์ API จาก ไอแอพพ์เทคโนโลยี
   • รูปภาพบัตรประจำตัวประชาชนไทย (ด้านหน้า/ด้านหลัง)
   • รูปแบบไฟล์ที่รองรับ: JPEG, JPG, PNG, HEIC, HEIF, PDF
   • ขนาดไฟล์สูงสุด: 10MB

2. เริ่มต้นใช้งานอย่างรวดเร็ว

   • การประมวลผลรวดเร็ว (1-2 วินาทีต่อบัตร)
   • การแยกข้อความที่มีความแม่นยำสูง (98.13% ที่ระดับอักขระ)
   • รองรับรูปแบบไฟล์หลากหลาย

3. คุณสมบัติหลัก

   • การแยกข้อมูลรายละเอียด รวมถึง:
     • เลขประจำตัวประชาชน
     • ชื่อ-นามสกุล (ไทยและอังกฤษ)
     • วันเกิด
     • ศาสนา
     • ที่อยู่
     • วันออกบัตรและวันหมดอายุ
   • รองรับทั้งด้านหน้าและด้านหลังของบัตรประชาชน
   • ตัวเลือกในการส่งคืนข้อความ OCR ดั้งเดิมและรูปภาพที่ประมวลผลแล้ว
   • รูปแบบการตอบกลับ JSON ที่ยืดหยุ่น

4. ความปลอดภัยและการปฏิบัติตามข้อกำหนด

   • สอดคล้องกับ GDPR และ PDPA
   • ไม่มีการเก็บข้อมูลหลังจากประมวลผล

วิธีรับ API Key?

กรุณาไปที่หน้า การจัดการ API Key เพื่อดู API Key ที่มีอยู่ หรือขอใหม่

ตัวอย่าง

ด้านหน้า

คำขอ:

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

การตอบกลับ:

{
    "address": "XXXXXX XXXX X ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "alley": "",
    "detection_score": 0.981011797984441,
    "district": "บางละมุง",
    "en_dob": "XX Mar 1957",
    "en_expire": "XX Mar 2025",
    "en_fname": "XXXXXX",
    "en_init": "Mrs.",
    "en_issue": "26 Jul 2016",
    "en_lname": "Lopez",
    "en_name": "Mrs. XXXXXX Lopez",
    "error_message": "",
    "face": "/9j/4AAQ...UAFFFFAH/9k=", # Base64 ของรูปภาพ
    "gender": "Female",
    "home_address": "XXXXX XXX",
    "house_no": "XXXXXX",
    "id_number": "34117XXXXXX334",
    "id_number_status": 1,
    "lane": "",
    "postal_code": "20150", # ดึงจากฐานข้อมูลอัตโนมัติ
    "process_time": 1.3018648624420166, # วินาที
    "province": "ชลบุรี",
    "religion": "",
    "request_id": null,
    "road": "",
    "sub_district": "หนองปรือ",
    "th_dob": "XX มี.ค. 2500",
    "th_expire": "XX มี.ค. 2568",
    "th_fname": "XXXXX",
    "th_init": "นาง",
    "th_issue": "XX ก.ค. 2559",
    "th_lname": "โลเปซ",
    "th_name": "นาง XXXXX โลเปซ",
    "village": "",
    "village_no": "7",
    "confidence": {
        "id_number": 0.95,
        "th_name": 0.95,
        "th_fname": 0.95,
        "th_lname": 0.95,
        "en_name": 0.95,
        "en_fname": 0.95,
        "en_lname": 0.95,
        "th_dob": 0.9,
        "en_dob": 0.9,
        "th_issue": 0.9,
        "en_issue": 0.9,
        "th_expire": 0.9,
        "en_expire": 0.9,
        "address": 0.95,
        "gender": 0.95,
        "religion": 0.9
    }
}

ด้านหลัง

คำขอ:

curl --location --request POST 'https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/back' \
    --header 'apikey: {Your API Key}' \
    --form 'file=@"path/to/id-card-back.jpg"'

การตอบกลับ:

{
    "back_number": "JT0-XXXXXXX-05",
    "detection_score": 0.99846746524175,
    "process_time": 1.370201416015625
}

คุณสมบัติและความสามารถ

คุณสมบัติหลัก

• การแยกข้อความที่มีความแม่นยำสูง (98.13% ที่ระดับอักขระ)
• ความเร็วในการประมวลผลรวดเร็ว (1-3 วินาทีต่อบัตร)
• รองรับรูปแบบไฟล์หลากหลาย (JPEG, JPG, PNG, HEIC, HEIF, PDF)
• การครอบตัดและหมุนบัตรอัตโนมัติ
• ส่งคืนกล่องขอบเขตและคะแนนสำหรับฟิลด์
• ส่งคืนรูปภาพ base64 ของบัตรและฟิลด์
• ส่งคืนข้อความ OCR ดิบ
• รองรับด้านหลังบัตรที่ไม่มีชิป

ฟิลด์ที่รองรับ

ด้านหน้า

ฟิลด์	ประเภท	คำอธิบาย
address	String	ที่อยู่บนบัตรประชาชน
detection_score	float	คะแนนการตรวจจับของฟิลด์ที่เกี่ยวข้อง
district	String	ชื่อเขตบนบัตรประชาชน
en_dob	String	วันเกิด เป็นภาษาอังกฤษ
en_expire	String	วันหมดอายุ เป็นภาษาอังกฤษ
en_fname	String	ชื่อจริงภาษาอังกฤษ
en_init	String	คำนำหน้าชื่อ เป็นภาษาอังกฤษ
en_issue	String	วันออกบัตร เป็นภาษาไทย
en_lname	String	นามสกุลภาษาอังกฤษ
en_name	String	ชื่อจริงและนามสกุลภาษาอังกฤษ
error_message	String	ข้อความแสดงข้อผิดพลาด
face	String	สตริงอักขระ Base64 ที่แปลงจากรูปภาพ
gender	String	เพศ
home_address	String	ที่อยู่ตามทะเบียนบ้านบนบัตรประชาชน
id_number	String	เลขประจำตัวประชาชน
postal_code	String	รหัสไปรษณีย์
process_time	String	เวลาประมวลผล (วินาที)
province	String	ชื่อจังหวัดบนบัตรประชาชน
religion	String	ศาสนาบนบัตรประชาชน
sub_district	String	ชื่อตำบลบนบัตรประชาชน
th_dob	String	วันเกิด เป็นภาษาไทย
th_expire	String	วันหมดอายุ เป็นภาษาไทย
th_fname	String	ชื่อจริงภาษาไทย
th_init	String	คำนำหน้าชื่อ เป็นภาษาไทย
th_issue	String	วันออกบัตร
th_lname	String	นามสกุลภาษาไทย
th_name	String	ชื่อจริงและนามสกุลภาษาไทย
confidence	Object	คะแนนความมั่นใจ (0-1) สำหรับแต่ละฟิลด์ที่ดึงมาได้

ด้านหลัง

ฟิลด์	ประเภท	คำอธิบาย
back_number	String	เลขเลเซอร์ด้านหลังบัตรประชาชน

ฟิลด์การตอบกลับทั่วไป

ฟิลด์	ประเภท	คำอธิบาย
detection_score	Float	คะแนนความมั่นใจ (0-1)
error_message	String	ข้อความแสดงข้อผิดพลาดหากคำขอไม่สำเร็จ
process_time	Float	เวลาประมวลผลเป็นวินาที

จุดปลาย API

จุดปลาย	เมธอด	คำอธิบาย	ค่าใช้จ่าย
POST /v3/store/ekyc/thai-national-id-card/front เก่า: /thai-national-id-card/v3.5/front	POST	แยกข้อมูลรายละเอียดจากด้านหน้าของบัตรประชาชนไทย	1.25 IC ต่อการเรียกใช้
POST /v3/store/ekyc/thai-national-id-card/back เก่า: /thai-national-id-card/v3.5.1/back	POST	แยกข้อมูลจากด้านหลังของบัตรประชาชนไทย	0.75 IC ต่อการเรียกใช้

เอกสารอ้างอิง API

จุดปลาย API บัตรประจำตัวประชาชนไทย

1. บัตรประจำตัวประชาชนไทย - ด้านหน้า

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

แยกข้อมูลรายละเอียดจากด้านหน้าของบัตรประจำตัวประชาชนไทย

ส่วนหัวคำขอ

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
apikey	string	ใช่	API key ของคุณ

เนื้อหาคำขอ (multipart/form-data)

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
file	File	ใช่	ข้อมูลไบนารีของรูปภาพ (ด้านหน้า)
fields	String	ไม่	ตัวเลือกในการเลือกฟิลด์ในผลลัพธ์
options	String	ไม่	ตัวเลือกในการเลือกเครื่องมือและตั้งค่าการประมวลผล

---

2. บัตรประจำตัวประชาชนไทย - ด้านหลัง

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

แยกข้อมูลจากด้านหลังของบัตรประจำตัวประชาชนไทย

ส่วนหัวคำขอ

ชื่อ	ประเภท	จำเป็น	คำอธิบาย
apikey	string	ใช่	API key ของคุณ

เนื้อหาคำขอ (multipart/form-data)

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
file	File	ใช่	ข้อมูลไบนารีของรูปภาพ (ด้านหลัง)
options	String	ไม่	ตัวเลือกในการเลือกเครื่องมือและตั้งค่าการประมวลผล

ตัวเลือกที่มีให้ใช้งาน

• not_crop_card - ข้ามการครอบตัดบัตร
• not_rotate_card - ข้ามการหมุนอัตโนมัติ
• get_bbox - ส่งคืนพิกัดกล่องขอบเขต
• get_image - ส่งคืนรูปภาพที่ประมวลผลแล้ว
• get_original - ส่งคืนรูปภาพดั้งเดิม

รูปแบบการตอบกลับสำหรับตัวเลือกที่มีให้ใช้งาน

เมื่อใช้ตัวเลือกที่มีให้ใช้งาน JSON การตอบกลับจะมีฟิลด์เพิ่มเติมตามตัวเลือกที่เลือก:

การตอบกลับพร้อมตัวเลือก get_bbox

ส่งคืนพิกัดกล่องขอบเขตสำหรับแต่ละฟิลด์ที่ตรวจพบในรูปแบบ [x1, y1, x2, y2] พร้อมคะแนนความมั่นใจ:

{
    "bbox": {
        "address": [
            [[119, 292, 376, 334], 0.991],
            [[75, 330, 255, 362], 0.999]
        ],
        "card": [[[0, 0, 713, 462], 0.99]],
        "en_dob": [[[370, 235, 526, 266], 0.999]],
        "face": [[[544, 218, 708, 407], 0.999]]
        // พิกัดฟิลด์อื่นๆ...
    }
}

การตอบกลับพร้อมตัวเลือก get_image

ส่งคืนรูปภาพที่ครอบตัดที่เข้ารหัส base64 สำหรับแต่ละฟิลด์ที่ตรวจพบ:

{
    "image": {
        "address": ["/9j/4AAQSk...", "/9j/4AAQSk..."],
        "card": ["/9j/4AAQSk..."],
        "face": ["/9j/4AAQSk..."],
        "id_number": ["/9j/4AAQSk..."]
        // รูปภาพฟิลด์อื่นๆ...
    }
}

การตอบกลับพร้อมตัวเลือก get_original

ส่งคืนค่าดั้งเดิมก่อนขั้นตอนการแก้ไขอัตโนมัติ (ซึ่งเกิดขึ้นในขั้นตอนการประมวลผลหลัง) ที่ตรวจพบจากบัตร:

{
    "original": {
        "address": "XXXXX XXXXX X ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
        "en_dob": "XX Mar. 1957",
        "en_expire": "XX Mar. 2025",
        "th_name": "นาง XXXXXX โลเปซ"
        // ค่าฟิลด์ดั้งเดิมอื่นๆ...
    }
}

การตอบกลับจะรวมฟิลด์มาตรฐานเสมอ เช่น detection_score, error_message และ process_time โดยไม่คำนึงถึงตัวเลือกที่ใช้

รหัสข้อผิดพลาด

ข้อความแสดงข้อผิดพลาดเฉพาะ

บัตรประจำตัวประชาชนไทย - ด้านหน้า

| รหัสสถานะ | ข้อความสถานะ | คำอธิบาย | | ----------- | ----------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | 420 | NO_ID_CARD_FOUND | ไฟล์รูปภาพไม่ใช่บัตรประชาชน | | 421 | IMAGE_ERROR_UNSUPPORTED_FORMAT | ไม่สามารถประมวลผลรูปภาพได้ รูปแบบไฟล์อาจไม่รองรับหรือไฟล์เสียหาย | | 422 | INVALID_IMAGE_SIZE | ขนาดของรูปภาพที่อัปโหลดไม่เป็นไปตามข้อกำหนด | | 424 | PLEASE_VERIFY_ID_CARD_NUMBER | เลขประจำตัวประชาชนมี 13 หลักแต่ไม่ถูกต้อง รหัสการตอบกลับ 424 จะแสดงเมื่อใช้ตัวเลือก id_check | | 425 | CANNOT_READ_ID_CARD_NUMBER_CLEARLY | เลขประจำตัวประชาชนมีน้อยกว่า 13 หลัก รหัสการตอบกลับ 425 จะแสดงเมื่อใช้ตัวเลือก id_check | | 426 | IMAGE_ERROR_UNSUPPORTED_BLACK_WHITE_IMAGE | ใช้ตัวเลือก gray_check เพื่อตรวจสอบรูปภาพขาวดำและสีเทา |

บัตรประจำตัวประชาชนไทย - ด้านหลัง

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
430	NO_ID_CARD_FOUND	ไฟล์รูปภาพไม่ใช่บัตรประชาชน
431	IMAGE_ERROR_UNSUPPORTED_FORMAT	ไม่สามารถประมวลผลรูปภาพได้ รูปแบบไฟล์อาจไม่รองรับหรือไฟล์เสียหาย
432	INVALID_IMAGE_SIZE	ขนาดของรูปภาพที่อัปโหลดไม่เป็นไปตามข้อกำหนด
434	LASER_NUMBER_NOT_FOUND	ตรวจจับหมายเลขเลเซอร์ที่ด้านหลังบัตรประชาชนไม่ได้
435	CANNOT_READ_LASER_NUMBER_CLEARLY	หมายเลขเลเซอร์มีน้อยกว่า 12 หลัก รหัสการตอบกลับ 435 จะแสดงเมื่อใช้ตัวเลือก id_check
436	IMAGE_ERROR_UNSUPPORTED_BLACK_WHITE_IMAGE	ใช้ตัวเลือก gray_check เพื่อตรวจสอบรูปภาพขาวดำและสีเทา

ข้อความแสดงข้อผิดพลาดทั่วไป

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
404	REQUESTED_URL_NOT_FOUND	ไม่พบเส้นทาง API ในคำขอ
405	METHOD_NOT_ALLOWED	ชื่อเมธอด (GET, POST) ใน URL ไม่ถูกต้อง
413	FILE_IS_TOO_LARGE: (more than 2 MB)	ขนาดไฟล์ใหญ่เกินไป
427	LONG_TIME_TO_PROCESS	เซิร์ฟเวอร์กำลังประมวลผลเป็นเวลานาน
428	LONG_TIME_TO_REQUEST	ไคลเอนต์กำลังรอคิวเป็นเวลานาน
461	NO_FILE_ATTACHED	ไม่ได้แนบไฟล์
560	SERVER_IS_BUSY: (Please try again in a few seconds.)	เซิร์ฟเวอร์กำลังทำงานกับคำขอจำนวนมาก
563	ID_CARD_API_NOT_SUPPORT_THIS_IMAGE	API มีข้อผิดพลาดในกระบวนการ

ตัวอย่างโค้ด

Curl

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

Python

import requests

url = "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front"

payload = {
    'options': 'get_bbox,get_image'
}

files = [
    ('file',('id-card.jpg',open('path/to/id-card.jpg','rb'),'image/jpeg'))
]

headers = {
    'apikey': 'YOUR_API_KEY'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.json())

JavaScript

const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")

const form = new FormData()
form.append("file", fs.createReadStream("path/to/id-card.jpg"))
form.append("options", "get_bbox,get_image")

const config = {
    method: "post",
    url: "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front",
    headers: {
        apikey: "YOUR_API_KEY",
        ...form.getHeaders(),
    },
    data: form,
}

axios(config)
    .then((response) => console.log(JSON.stringify(response.data)))
    .catch((error) => console.log(error))

PHP

<?php
$curl = curl_init();

$post_data = array(
    'file'=> new CURLFile('path/to/id-card.jpg'),
    'options' => 'get_bbox,get_image'
);

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $post_data,
    CURLOPT_HTTPHEADER => array(
        'apikey: YOUR_API_KEY'
    ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Swift

import Foundation

let headers = [
    "apikey": "YOUR_API_KEY"
]

let parameters = [
    [
        "name": "file",
        "fileName": "path/to/id-card.jpg"
    ],
    [
        "name": "options",
        "value": "get_bbox,get_image"
    ]
]

let boundary = "Boundary-\(UUID().uuidString)"
var body = ""
var error: Error? = nil

for param in parameters {
    if let fileName = param["fileName"] {
        let fileContent = try? String(contentsOfFile: fileName, encoding: .utf8)
        body += "--\(boundary)\r\n"
        body += "Content-Disposition:form-data; name=\"\(param["name"] ?? "")\""
        body += "; filename=\"\(fileName)\"\r\n"
        body += "Content-Type: image/jpeg\r\n\r\n"
        body += fileContent ?? ""
    } else {
        body += "--\(boundary)\r\n"
        body += "Content-Disposition:form-data; name=\"\(param["name"] ?? "")\"\r\n\r\n"
        body += param["value"] ?? ""
    }
}

let postData = body.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front")!,timeoutInterval: Double.infinity)
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data else {
        print(String(describing: error))
        return
    }
    print(String(data: data, encoding: .utf8)!)
}

task.resume()

Kotlin

import okhttp3.*
import java.io.File

val client = OkHttpClient()

val mediaType = MediaType.parse("image/jpeg")
val file = File("path/to/id-card.jpg")
val body = MultipartBody.Builder().setType(MultipartBody.FORM)
    .addFormDataPart("file", file.name, RequestBody.create(mediaType, file))
    .addFormDataPart("options", "get_bbox,get_image")
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build()

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

Java

import java.io.File;
import okhttp3.*;

public class Main {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient().newBuilder().build();

        MediaType mediaType = MediaType.parse("image/jpeg");
        RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
            .addFormDataPart("file", "id-card.jpg",
                RequestBody.create(mediaType, new File("path/to/id-card.jpg")))
            .addFormDataPart("options", "get_bbox,get_image")
            .build();

        Request request = new Request.Builder()
            .url("https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front")
            .method("POST", body)
            .addHeader("apikey", "YOUR_API_KEY")
            .build();

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

Dart

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

void main() async {
    var request = http.MultipartRequest('POST',
        Uri.parse('https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front'));

    request.files.add(await http.MultipartFile.fromPath(
        'file', 'path/to/id-card.jpg'));

    request.fields['options'] = 'get_bbox,get_image';

    request.headers.addAll({
        'apikey': 'YOUR_API_KEY'
    });

    http.StreamedResponse response = await request.send();

    if (response.statusCode == 200) {
        print(await response.stream.bytesToString());
    } else {
        print(response.reasonPhrase);
    }
}

ข้อจำกัดและแนวทางปฏิบัติที่ดีที่สุด

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• รูปแบบที่รองรับ: JPEG, JPG, PNG, HEIC, HEIF, PDF

แนวทางปฏิบัติที่ดีที่สุด

1. ตรวจสอบให้แน่ใจว่าคุณภาพของรูปภาพดี
2. ตรวจสอบ detection_score ในการตอบกลับ
3. จัดการข้อความแสดงข้อผิดพลาดอย่างเหมาะสม
4. ตรวจสอบรูปแบบหมายเลขบัตรประชาชน
5. พิจารณาใช้พารามิเตอร์ options สำหรับความต้องการเฉพาะ

ความแม่นยำและประสิทธิภาพ

ความแม่นยำโดยรวม

• คะแนนการตรวจจับโดยทั่วไปสูงกว่า 96%
• ความแม่นยำของฟิลด์เฉพาะแตกต่างกันไป

ความเร็วในการประมวลผล

• โดยเฉลี่ย: 1-2 วินาที
• อาจแตกต่างกันไปขึ้นอยู่กับขนาดและคุณภาพของรูปภาพ

ปัจจัยที่ส่งผลต่อความแม่นยำ

1. คุณภาพรูปภาพ
   • ความละเอียด (อย่างน้อย 300 DPI)
   • แสง
   • ความคมชัด
2. สภาพบัตร
   • ความเสียหายทางกายภาพ
   • แสงสะท้อน
   • ความชัดเจนของข้อความ

ข้อมูลจำเพาะของบัตรประจำตัวประชาชนไทย

การทำความเข้าใจคุณสมบัติทางกายภาพของบัตรประจำตัวประชาชนไทยจะช่วยให้มั่นใจได้ว่าการจับภาพจะเหมาะสมที่สุดสำหรับการประมวลผล OCR

ขนาดบัตร (ขนาดบัตรประชาชน)

คุณสมบัติ	หน่วยวัด	นิ้ว
ความกว้าง	85.60 มม	3.370 นิ้ว (3⅜")
ความสูง	53.98 มม	2.125 นิ้ว (2⅛")
ความหนา	0.76 มม	0.030 นิ้ว
รัศมีมุม	3.18 มม	0.125 นิ้ว

ขนาดบัตรประชาชน นิ้ว

บัตรประชาชนไทยมีขนาด 3.370 × 2.125 นิ้ว (85.60 × 53.98 มม.) ตามมาตรฐาน ISO/IEC 7810 ID-1 ซึ่งเป็นขนาดเดียวกับบัตรเครดิตทั่วโลก

มาตรฐานรูปแบบบัตร

มาตรฐาน	คำอธิบาย
รูปแบบ	ISO/IEC 7810 ID-1 (ขนาดบัตรเครดิต)
วัสดุ	พลาสติกโพลีคาร์บอเนต (PC)
ประเภทชิป	ชิปสมาร์ทการ์ดแบบสัมผัส (ตั้งแต่ปี 2005)
การจัดเก็บข้อมูล	ข้อมูลชีวมิติ, ใบรับรองดิจิทัล, แม่แบบลายนิ้วมือ

คุณสมบัติของบัตร

• ด้านหน้า: รูปถ่าย, ชื่อ (ไทย/อังกฤษ), เลขประจำตัวประชาชน, วันเกิด, ที่อยู่, วันที่ออกบัตร/หมดอายุ, บาร์โค้ด
• ด้านหลัง: รหัสเลเซอร์ (ตัวอักษรและตัวเลข 12 หลัก)
• คุณสมบัติด้านความปลอดภัย: โฮโลแกรม, การพิมพ์ UV, จุลายัน, การแกะสลักด้วยเลเซอร์
• ชิปสมาร์ทการ์ด: บรรจุข้อมูลชีวมิติที่เข้ารหัสและลายเซ็นดิจิทัล

ข้อกำหนดรูปภาพสำหรับ OCR

เพื่อให้ได้ความแม่นยำ OCR ที่ดีที่สุด ตรวจสอบให้แน่ใจว่ารูปภาพที่ถ่ายของคุณเป็นไปตามข้อกำหนดเหล่านี้:

ข้อกำหนด	แนะนำ	ขั้นต่ำ
ความละเอียด	600 DPI	300 DPI
ความกว้างรูปภาพ	1000+ พิกเซล	600 พิกเซล
ความสูงรูปภาพ	630+ พิกเซล	400 พิกเซล
ขนาดไฟล์	< 5 MB	< 10 MB
รูปแบบ	JPEG, PNG	JPEG, PNG, HEIC, PDF

ประวัติ

เวอร์ชัน	วันที่เผยแพร่	ความแม่นยำ	การปรับปรุงที่สำคัญ
3.5	พ.ย. 2022	98.13%	Engine OCR ใหม่, การประมวลผลเร็วขึ้น
3.4	ก.ค. 2022	93.25%	เพิ่มยศทหารไทย
3.1-3.3	พ.ค.-ก.ค. 2021	92.75%	รุ่น Beta ภายใน
3.0	ก.พ. 2021	91.75%	การปรับปรุงความแม่นยำครั้งใหญ่
2.0	ก.พ. 2020	85%	เพิ่มการรองรับบัตรด้านหลัง
1.0	พ.ย. 2019	76%	การเปิดตัวครั้งแรก

ราคา

การดำเนินการ	เส้นทาง Production	เส้นทางเก่า	ค่าใช้จ่าย IC	หน่วย	On-Premise
บัตรประจำตัวประชาชนไทย - ด้านหน้า	/v3/store/ekyc/thai-national-id-card/front	/thai-national-id-card/v3.5/front	1.25 IC	ต่อ 1 คำขอ	ติดต่อเรา
บัตรประจำตัวประชาชนไทย - ด้านหลัง	/v3/store/ekyc/thai-national-id-card/back	/thai-national-id-card/v3.5.1/back	0.75 IC	ต่อ 1 คำขอ	ติดต่อเรา