ภาพถ่ายสำเนาบัตรประชาชนไทยพร้อมการตรวจจับลายเซ็น

1.25 ICต่อหน้า

v1.1.1-20260822 ใช้งานอยู่ ตั้งแต่ปี 2023 อัปเดตล่าสุด 22 ส.ค. 2026 10,500 ใบ/ชั่วโมง ความแม่นยำ 97.1% Whitepaper (PDF) POST /v3/store/ekyc/thai-national-id-card-with-signature

มี SDK สำหรับ Mobile และ Web

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

API ภาพถ่ายสำเนาบัตรประชาชนไทยพร้อมการตรวจจับลายเซ็น แยกข้อมูลที่มีโครงสร้างจากสำเนาภาพถ่ายบัตรประชาชนไทย ทั้งแบบสีและขาวดำ และตรวจจับว่าสำเนานั้นได้รับการลงลายมือชื่อแล้วหรือไม่ ระบบจะค้นหาตำแหน่งบัตรในภาพโดยอัตโนมัติ และส่งคืนหมายเลขบัตรประชาชน ชื่อ-นามสกุล วันเกิด ที่อยู่ และวันหมดอายุในรูปแบบ JSON พร้อมคะแนนความเชื่อมั่นรายฟิลด์ บริการบนระบบ production ประมวลผลบัตรหนึ่งใบใน 0.7 วินาที (ค่ามัธยฐาน) และรองรับปริมาณงานต่อเนื่องมากกว่า 10,500 ใบต่อชั่วโมง ความแม่นยำระดับฟิลด์ที่วัดได้อยู่ที่ 97.1% เมื่อเทียบกับข้อมูลอ้างอิงที่ตรวจสอบโดยมนุษย์ โดยหมายเลขบัตรประชาชน 13 หลักมีความแม่นยำ 100% ดูรายละเอียดที่ ความแม่นยำ

เดโมสด

อัปโหลดสำเนาภาพถ่ายบัตรประชาชนไทย หรือเลือกภาพตัวอย่างด้านล่าง ภาพตัวอย่างเป็นบัตรตัวอย่างที่สังเคราะห์ขึ้น ไม่ใช่เอกสารจริง

ทดลองใช้ AI Demo

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

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

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

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

Example Images (Click to try)

Try Demo

Try Demo

API Key

Log in to use your API keys or Create an account

Endpoint URL

cURL Command

อัปโหลดภาพถ่ายสำเนาบัตรประชาชนไทย

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

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

Loading live demo…

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

คุณต้องมีคีย์ API จากหน้า การจัดการคีย์ API จากนั้นส่งรูปภาพในรูปแบบ multipart/form-data:

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"

{
    "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
}

โครงสร้างการตอบสนองฉบับเต็มอยู่ใน เอกสารอ้างอิงทางเทคนิค

Endpoint และราคา

Endpoint	ผลลัพธ์	ราคา
POST /v3/store/ekyc/thai-national-id-card-with-signature	JSON ประกอบด้วยฟิลด์ข้อมูลที่แยกได้ ผลการตรวจจับลายเซ็น และคะแนนความเชื่อมั่น	1.25 IC ต่อหน้า

เส้นทางแบบ legacy /thai-national-id-card-with-signature/front และ /thai-national-id-card/copy ยังคงใช้งานได้ในราคาเดียวกัน API นี้ได้รับการปรับแต่งสำหรับสำเนาภาพถ่ายของบัตรประชาชน สำหรับ OCR โดยตรงจากบัตรประชาชนจริง โปรดใช้ OCR บัตรประชาชนไทย สำหรับการติดตั้งแบบ on-premise ดูที่ ความปลอดภัยของข้อมูล

ประสิทธิภาพ

วัดจากบริการบนระบบ production เดือนสิงหาคม 2026

ตัวชี้วัด	ค่า
เวลาประมวลผลมัธยฐาน	0.7 วินาทีต่อใบ
ปริมาณงานต่อเนื่อง	2.9 ใบต่อวินาที (10,500 ใบต่อชั่วโมง)
ขนาดไฟล์สูงสุด	2 MB
รูปแบบไฟล์นำเข้าที่รองรับ	JPEG, JPG, PNG, HEIC, HEIF
ขนาดบัตรขั้นต่ำในภาพ	600 × 400 px

ความแม่นยำ

ความแม่นยำวัดเทียบกับข้อมูลอ้างอิง (ground truth) ที่ตรวจสอบโดยมนุษย์: บัตรประชาชนไทยที่ติดป้ายกำกับ 33 ใบ รวม 594 รายการข้อมูลระดับฟิลด์ ชุดข้อมูลอ้างอิงประกอบด้วยบัตรประชาชนจริงจึงถูกเก็บเป็นความลับด้วยเหตุผลด้านความเป็นส่วนตัว ระเบียบวิธีการวัดระบุไว้อย่างครบถ้วนใน whitepaper ด้านล่าง

ฟิลด์	ตรงตามข้อมูลอ้างอิงทุกอักขระ
หมายเลขบัตรประชาชน (13 หลัก)	100%
ที่อยู่: บ้านเลขที่	97.0%
ที่อยู่ (เต็ม)	93.9%
ทุกฟิลด์ (โดยรวม)	97.1%
การตรวจจับลายเซ็น	96.5%

เอนจินการรู้จำเวอร์ชัน v1.1.1 เพิ่มความแม่นยำระดับฟิลด์โดยรวมจาก 96.3% เป็น 97.1% เมื่อเทียบกับเอนจินรุ่นก่อนหน้า โดยมีการปรับปรุงมากที่สุดในส่วนบ้านเลขที่และที่อยู่ ระเบียบวิธีฉบับเต็ม ผลลัพธ์รายฟิลด์ และการเปรียบเทียบกับบริการ OCR แบบคลาวด์ชั้นนำระดับโลก เผยแพร่ใน whitepaper ผลการทดสอบเปรียบเทียบ:

ดาวน์โหลด whitepaper ผลการทดสอบเปรียบเทียบ (PDF)

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

• บริการเป็นไปตามข้อกำหนด GDPR และ PDPA
• รูปภาพที่อัปโหลดจะถูกประมวลผลในหน่วยความจำ และไม่มีการเก็บรักษาไว้หลังจากส่งผลลัพธ์กลับแล้ว
• มีบริการติดตั้งแบบ on-premise ที่ทำงานได้ครบถ้วนในตัวเอง ซึ่งข้อมูลบัตรจะไม่ออกจากโครงสร้างพื้นฐานของคุณ ติดต่อเรา เพื่อขอรายละเอียด

เอกสารอ้างอิงทางเทคนิค

คำขอ

POST ด้วย multipart/form-data และส่วนหัว apikey

พารามิเตอร์	จำเป็น	คำอธิบาย
file	ใช่	สำเนาภาพถ่ายบัตรประชาชนไทย (ด้านหน้า)

การตอบสนอง

{
    "national_id": "3411700830334",
    "init_th": "นาง",
    "init_en": "Mrs.",
    "name_th": "บุญยัง",
    "name_en": "Bunyang",
    "surname_th": "โลเปช",
    "surname_en": "Lopez",
    "fullname_th": "นาง บุญยัง โลเปช",
    "fullname_en": "Mrs. Bunyang Lopez",
    "date_of_birth": "22 มี.ค. 2500",
    "date_of_expire": "21 มี.ค. 2568",
    "address_full": "33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "address_number": "33/349 หมู่ที่ 7",
    "address_subdistrict": "ต.หนองปรือ",
    "address_district": "บางละมุง",
    "address_province": "ชลบุรี",
    "address_postal_code": "20150",
    "file_name_id_card": "idcard.jpg",
    "process_time": 0.7,
    "reason_code_api": 200,
    "reason_code_id_card": 1,
    "reason_code_id_card_national_id": 1,
    "reason_code_id_card_signature": 1,
    "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "confidence": {
        "national_id": 0.95,
        "fullname_th": 0.95,
        "date_of_birth": 0.9,
        "address_full": 0.95
    }
}

ฟิลด์การตอบสนอง

ฟิลด์	ประเภท	คำอธิบาย
national_id	String	หมายเลขบัตรประชาชน 13 หลัก
init_th / init_en	String	คำนำหน้าชื่อ (ไทย / อังกฤษ)
name_th / name_en	String	ชื่อ (ไทย / อังกฤษ)
surname_th / surname_en	String	นามสกุล (ไทย / อังกฤษ)
fullname_th / fullname_en	String	ชื่อ-นามสกุลเต็ม (ไทย / อังกฤษ)
date_of_birth	String	วันเกิด รูปแบบภาษาไทย
date_of_expire	String	วันหมดอายุของบัตร รูปแบบภาษาไทย
address_full	String	ที่อยู่เต็มตามที่พิมพ์บนบัตร
address_number	String	บ้านเลขที่และหมู่ที่
address_subdistrict / address_district / address_province	String	องค์ประกอบของที่อยู่
address_postal_code	String	รหัสไปรษณีย์ (อนุมานจากที่อยู่)
file_name_id_card	String	ชื่อไฟล์ที่อัปโหลด
process_time	Float	เวลาประมวลผล (วินาที)
reason_code_api	Integer	รหัสสถานะการตอบสนอง (ดูด้านล่าง)
reason_code_id_card	Integer	1 หากพบบัตรประชาชนในภาพ, 0 หากไม่พบ
reason_code_id_card_national_id	Integer	1 หากพบหมายเลขบัตรประชาชน, 0 หากไม่พบ
reason_code_id_card_signature	Integer	1 หากพบลายเซ็นบนกระดาษ, 0 หากไม่พบ
request_id	String	รหัสคำขอจาก API gateway
confidence	Object	คะแนนความเชื่อมั่น (0–1) สำหรับแต่ละฟิลด์ที่แยกได้

รหัสการตอบสนอง

รหัสสถานะ	ข้อความสถานะ	คำอธิบาย
200	SUCCESS	คำขอสำเร็จ
404	REQUESTED_URL_NOT_FOUND	ไม่พบเส้นทาง API
405	METHOD_NOT_ALLOWED	ใช้วิธี HTTP ไม่ถูกต้อง
413	IMAGE_FILE_IS_TOO_LARGE	ไฟล์เกินขีดจำกัด 2 MB
414	NO_FILE_ATTACHED	ไม่มีไฟล์ในคำขอ
415	INVALID_IMAGE_SIZE	มิติของภาพไม่ถูกต้อง
420	NO_ID_CARD_FOUND	ตรวจไม่พบบัตรประชาชนในภาพ
421	IMAGE_ERROR_UNSUPPORTED_FORMAT	รูปแบบภาพไม่รองรับหรือไฟล์เสียหาย
422	INVALID_IMAGE_SIZE	ไม่เป็นไปตามข้อกำหนดขนาดภาพ
427	LONG_TIME_TO_PROCESS	หมดเวลาประมวลผลของเซิร์ฟเวอร์
428	LONG_TIME_TO_REQUEST	หมดเวลารอคิว
560	SERVER_IS_BUSY	เซิร์ฟเวอร์มีภาระงานสูงเกินไป โปรดลองใหม่
563	ID_CARD_API_NOT_SUPPORT_THIS_IMAGE	ข้อผิดพลาดในการประมวลผล

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

cURL

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"

Python

import requests

url = "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature"
headers = {"apikey": "YOUR_API_KEY"}
files = {"file": open("idcard.jpg", "rb")}

response = requests.post(url, headers=headers, files=files)
print(response.json())

JavaScript

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

const data = new FormData();
data.append("file", fs.createReadStream("idcard.jpg"));

axios.post("https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature", data, {
    headers: { apikey: "YOUR_API_KEY", ...data.getHeaders() },
})
    .then((response) => console.log(response.data))
    .catch((error) => console.log(error));

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => array(
        'file' => new CURLFILE('idcard.jpg')
    ),
    CURLOPT_HTTPHEADER => array(
        'apikey: YOUR_API_KEY'
    ),
));

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

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var body = Data()
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"idcard.jpg\"\r\n".data(using: .utf8)!)
body.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
if let fileData = try? Data(contentsOf: URL(fileURLWithPath: "idcard.jpg")) {
    body.append(fileData)
}
body.append("\r\n--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = body

URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8)!)
    }
}.resume()

Kotlin

import okhttp3.*
import okhttp3.MediaType.Companion.toMediaTypeOrNull
import okhttp3.RequestBody.Companion.asRequestBody
import java.io.File

val client = OkHttpClient()
val file = File("idcard.jpg")

val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.name, file.asRequestBody("image/jpeg".toMediaTypeOrNull()))
    .build()

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

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

Java

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

OkHttpClient client = new OkHttpClient();
File file = new File("idcard.jpg");

RequestBody requestBody = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("file", file.getName(),
        RequestBody.create(MediaType.parse("image/jpeg"), file))
    .build();

Request request = new Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build();

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

Dart

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

var request = http.MultipartRequest(
    'POST',
    Uri.parse('https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature'),
);
request.files.add(await http.MultipartFile.fromPath('file', 'idcard.jpg'));
request.headers.addAll({'apikey': 'YOUR_API_KEY'});

var response = await request.send();
print(await response.stream.bytesToString());

ข้อจำกัด

• ปรับแต่งสำหรับสำเนาภาพถ่ายของบัตรประชาชน สำหรับบัตรจริงโปรดใช้ OCR บัตรประชาชนไทย
• บัตรในภาพต้องมีขนาดอย่างน้อย 600 × 400 px การสแกนที่ความละเอียด 300 dpi ขึ้นไปให้ผลลัพธ์ดีที่สุด
• ไฟล์ที่มีขนาดเกิน 2 MB จะถูกปฏิเสธ
• ภาพฟิลด์ที่มีความละเอียดต่ำมากจะลดคุณภาพการรู้จำ โปรดตรวจสอบให้บัตรอยู่ในโฟกัสและมีขนาดเหมาะสมภายในเฟรมภาพ

ประวัติการเปลี่ยนแปลง

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
v1.1.1-20260822	22 ส.ค. 2026	อัปเกรดเอนจินการรู้จำ: ความแม่นยำระดับฟิลด์เพิ่มขึ้นจาก 96.3% เป็น 97.1% เมื่อเทียบกับข้อมูลอ้างอิงที่ตรวจสอบโดยมนุษย์ โดยหมายเลขบัตรประชาชนอยู่ที่ 100% เวลาประมวลผลมัธยฐาน 0.7 วินาทีต่อใบ มีบริการติดตั้งแบบ on-premise ที่ทำงานได้ครบถ้วนในตัวเอง
v1.0	2023	เปิดตัวครั้งแรกพร้อมการตรวจจับลายเซ็น