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

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

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

ทดลองใช้เลย!

Example Images (Click to try)

API Key

Demo key is limited to 10 requests per day per IP
Click here to get your API key

Choose Endpoint URL

Endpoint URL

cURL Command

Upload Image

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

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