🪪 การจดจำข้อความจากบัตรประชาชนไทยด้วย (Thai National ID Card OCR)

🪪 บัตรประชาชนไทย

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

Try Demo

Visit our API Portal to test the Thai National ID Card OCR API with your own images.

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

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

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

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

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

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

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

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

   • ปฏิบัติตาม GDPR และ PDPA
   • ไม่มีการเก็บรักษาข้อมูลหลังจากการประมวลผล

วิธีรับ API Key?

กรุณาเยี่ยมชม API Portal เพื่อดู API key ที่มีอยู่ของคุณหรือขอ API key ใหม่

ตัวอย่าง

ด้านหน้า

คำขอ:

curl -X POST https://api.iapp.co.th/thai-national-id-card/v3.5/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 of photo's image
    "gender": "Female",
    "home_address": "XXXXX XXX",
    "house_no": "XXXXXX",
    "id_number": "34117XXXXXX334",
    "id_number_status": 1,
    "lane": "",
    "postal_code": "20150", # Automatic Retrieve from Database
    "process_time": 1.3018648624420166, # Seconds
    "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"
}

ด้านหลัง

คำขอ:

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

การตอบสนอง:

{
    "back_number": "JT0-1740123-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	ชื่อและนามสกุล (ภาษาไทย)

ด้านหลัง

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

ช่องข้อมูลการตอบสนองทั่วไป

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

ข้อมูลอ้างอิง API

การจดจำบัตรประชาชนไทย

จุดสิ้นสุดนี้จะประมวลผลภาพบัตรประชาชนไทยและส่งคืนข้อมูลที่ดึงออกมาในรูปแบบที่มีโครงสร้าง

ด้านหน้า

POST https://api.iapp.co.th/thai-national-id-card/v3.5/front

ส่วนหัวของคำขอ

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

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

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

ด้านหลัง

POST https://api.iapp.co.th/thai-national-id-card/v3.5/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: (มากกว่า 2 MB)	ขนาดไฟล์ใหญ่เกินไป
427	LONG_TIME_TO_PROCESS	เซิร์ฟเวอร์ประมวลผลนานเกินไป
428	LONG_TIME_TO_REQUEST	ไคลเอ็นต์กำลังรอคิวอยู่นานเกินไป
461	NO_FILE_ATTACHED	ไม่มีไฟล์แนบ
560	SERVER_IS_BUSY: (โปรดลองใหม่อีกครั้งในอีกไม่กี่วินาที)	เซิร์ฟเวอร์กำลังประมวลผลคำขอจำนวนมาก
563	ID_CARD_API_NOT_SUPPORT_THIS_IMAGE	API มีข้อผิดพลาดในการประมวลผล

ราคา

ชื่อบริการ AI API	จุดสิ้นสุด	IC ต่อคำขอ	On-Premise
Thai National ID Card OCR (v3.5)	iapp_thai_national_id_card_ocr_v3.5_back	0.75 IC/Request	ติดต่อ
	iapp_thai_national_id_card_ocr_v3.5_front	1.25 IC/Request

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

Python

    import requests

    url = "https://api.iapp.co.th/thai-national-id-card/v3.5/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/thai-national-id-card/v3.5/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/thai-national-id-card/v3.5/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/thai-national-id-card/v3.5/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/thai-national-id-card/v3.5/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/thai-national-id-card/v3.5/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/thai-national-id-card/v3.5/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 DPS)
   • แสงสว่าง
   • โฟกัส
2. สภาพของบัตร
   • ความเสียหายทางกายภาพ
   • การสะท้อนแสง
   • ความชัดเจนของข้อความ

ประวัติ

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

ราคา

ชื่อบริการ AI API	จุดสิ้นสุด	IC ต่อคำขอ	On-Premise
Thai National ID Card OCR (v3.5)	iapp_thai_national_id_card_ocr_v3.5_back	0.75 IC/Request	ติดต่อ
	iapp_thai_national_id_card_ocr_v3.5_front	1.25 IC/Request