🛂 แกะข้อมูลผู้ถือพาสปอร์ต (Passport OCR)

🛂 พาสปอร์ต

ยินดีต้อนรับสู่ iApp Passport OCR API ผลิตภัณฑ์ AI ที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราได้รับการออกแบบมาเพื่อจดจำและดึงข้อมูลจากภาพพาสปอร์ตที่สแกนโดยอัตโนมัติด้วยความแม่นยำและความเร็วสูง ระบบมุ่งเน้นไปที่การอ่านเขตข้อมูลที่อ่านได้ด้วยเครื่อง (MRZ) ที่ด้านล่างของหน้าพาสปอร์ต โดยดึงข้อมูลสำคัญ เช่น ชื่อผู้ถือสัญชาติ วันเกิด และอื่นๆ

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

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

Endpoint URL

cURL Command

อัพโหลดรูปภาพเอกสารที่รับรองสัญชาติ

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

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

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

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

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

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

   • ดึงข้อมูลจาก MRZ ชนิด TD3
   • การให้คะแนนและการตรวจสอบความถูกต้องของ OCR
   • การดึงภาพใบหน้าในรูปแบบ base64
   • รองรับเอกสาร PDF หลายหน้า
   • จัดการกับภาพที่หมุนและเอียง
   • การประมวลผลล่วงหน้าการแบ่งส่วนภาพสำหรับภาพที่เอียง
   • รองรับภาษาไทยและภาษาอังกฤษ

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

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

วิธีรับ API Key?

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

ตัวอย่าง

หน้ารูปถ่าย

คำขอ:

curl -X POST https://api.iapp.co.th/passport-ocr/v2/ocr \
-H "apikey: YOUR_API_KEY" \
-F "file=@/path/to/passport.jpg"

การตอบสนอง:

{
    "check_composite": "4",
    "check_date_of_birth": "4",
    "check_expiration_date": "4",
    "check_number": "6",
    "check_personal_number": "3",
    "country": "THA",
    "date_of_birth": "930710",
    "expiration_date": "250304",
    "method": "direct",
    "mrz_type": "TD3",
    "names": "MATHANIDA",
    "nationality": "THA",
    "number": "AC1062346",
    "personal_number": "0012345678913",
    "raw_text": "P<THAPOSHNASWADIWONG<<MATHANIDA<<<<<<<<<<<<<\nAC10623466THA9307104F25030440012345678913<34",
    "sex": "F",
    "surname": "POSHNASWADIWONG",
    "type": "P",
    "valid_composite": true,
    "valid_date_of_birth": true,
    "valid_expiration_date": true,
    "valid_number": true,
    "valid_personal_number": true,
    "valid_score": 100,
    "face": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
}

คำอธิบายฟิลด์การตอบสนอง

ฟิลด์	คำอธิบาย	รูปแบบ	ตัวอย่าง
check_composite	ตัวเลขตรวจสอบโดยรวมสำหรับบรรทัดที่อ่านได้ด้วยเครื่องด้านบนและกลาง	หลักเดียว	"4"
check_date_of_birth	ตัวเลขตรวจสอบสำหรับฟิลด์วันเกิด	หลักเดียว	"4"
check_expiration_date	ตัวเลขตรวจสอบสำหรับฟิลด์วันหมดอายุ	หลักเดียว	"4"
check_number	ตัวเลขตรวจสอบสำหรับหมายเลขเอกสาร	หลักเดียว	"6"
check_personal_number	ตัวเลขตรวจสอบสำหรับหมายเลขประจำตัว	หลักเดียว	"3"
country	รหัสประเทศของการออกพาสปอร์ต	3 ตัวอักษร	"THA"
date_of_birth	วันเกิด	YYMMDD	"930710"
expiration_date	วันหมดอายุของเอกสาร	YYMMDD	"250304"
method	วิธีการอ่านที่ใช้	ข้อความ	"direct"
mrz_type	ชนิดของเขตข้อมูลที่อ่านได้ด้วยเครื่อง	ข้อความ	"TD3"
names	ชื่อ/ชื่อจริง	ข้อความ	"MATHANIDA"
nationality	สัญชาติของผู้ถือ	3 ตัวอักษร	"THA"
number	หมายเลขพาสปอร์ต	ข้อความ	"AC1062346"
personal_number	หมายเลขประจำตัวประชาชน	ข้อความ	"0012345678913"
raw_text	ข้อความ MRZ ดิบจากพาสปอร์ต	ข้อความ	"P<THAPOSHNASWADIWONG..."
sex	เพศ	ตัวอักษรเดียว	"F"
surname	นามสกุล	ข้อความ	"POSHNASWADIWONG"
type	ชนิดเอกสาร	ข้อความ	"P"
valid_composite	การตรวจสอบความถูกต้องของ MRZ โดยรวม	บูลีน	true
valid_date_of_birth	ความถูกต้องของตัวเลขตรวจสอบวันเกิด	บูลีน	true
valid_expiration_date	ความถูกต้องของตัวเลขตรวจสอบวันหมดอายุ	บูลีน	true
valid_number	ความถูกต้องของตัวเลขตรวจสอบหมายเลขเอกสาร	บูลีน	true
valid_personal_number	ความถูกต้องของตัวเลขตรวจสอบหมายเลขประจำตัว	บูลีน	true
valid_score	คะแนนความถูกต้องโดยรวม	จำนวนเต็ม 0-100	100
face	ภาพใบหน้าที่ดึงออกมา	ข้อความ Base64	"/9j/4AAQSkZJRgABA..."

การประมวลผลไฟล์ PDF

เมื่อประมวลผลไฟล์ PDF รูปแบบการตอบสนองจะแตกต่างกันเล็กน้อย:

1. การตอบสนองจะเป็น JSON array ที่มีผลลัพธ์สำหรับแต่ละหน้า
2. ผลลัพธ์ของแต่ละหน้าประกอบด้วย:
   • page: หมายเลขหน้า
   • info: ประกอบด้วยฟิลด์มาตรฐานทั้งหมดตามที่แสดงไว้ข้างต้น
3. ฟิลด์ process_time แสดงระยะเวลาการประมวลผลทั้งหมด

ตัวอย่างโครงสร้างการตอบสนอง PDF:

[
    {
        "page": 1,
        "info": {
            "sex": "F",
            "number": "AC1062346",
            "expiration_date": "04/03/25",
            "raw_text": "P<THAPOSHNASWADIWONG<<MATHANIDA<<<<<<<<<<<<<\nAC10623466THA9307104F25030440012345678913<34",
            "personal_number": "0012345678913",
            "surname": "POSHNASWADIWONG",
            "nationality": "THA",
            "date_of_birth": "10/07/93",
            "names": "MATHANIDA",
            "country": "THA",
            "face": "iVBORw0...CYII=",
            "inference": "3.888",
            "file_name": "1676365480.3823211_thai_passport_page_1.png",
            "message": "Success",
            "status_code": 200
        }
    },
    {
        "process_time": "4.918s"
    }
]

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

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

• การดึงข้อความ MRZ (Machine Readable Zone)
• การดึงภาพใบหน้า
• รองรับ PDF หลายหน้า
• การแก้ไขทิศทางภาพอัตโนมัติ
• การแบ่งส่วนภาพสำหรับภาพที่เอียง
• การตรวจสอบความถูกต้องที่มีความแม่นยำสูง

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

• ชนิดเอกสาร
• ประเทศที่ออก
• หมายเลขเอกสาร
• ชื่อผู้ถือ
• สัญชาติ
• วันเกิด
• เพศ
• วันหมดอายุ
• หมายเลขประจำตัว
• ภาพใบหน้า (base64)
• ข้อความ MRZ ดิบ
• คะแนนการตรวจสอบความถูกต้อง

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

การจดจำพาสปอร์ต

POST https://api.iapp.co.th/passport-ocr/v2

ดำเนินการ OCR บนหน้ารูปถ่ายพาสปอร์ตและดึงข้อมูล MRZ

พารามิเตอร์:

• file (จำเป็น): ไฟล์รูปภาพ (JPG, PNG, PDF)
• apikey (จำเป็น): API key ของคุณ
• options: เปิดใช้งาน "segmentation" สำหรับการประมวลผลภาพที่เอียง

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

Python

import requests

url = "https://api.iapp.co.th/passport-ocr/v2/ocr"
headers = {
"apikey": "YOUR_API_KEY"
}
files = {
"file": open("passport.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")

let data = new FormData()
data.append("file", fs.createReadStream("passport.jpg"))

let config = {
    method: "post",
    url: "https://api.iapp.co.th/passport-ocr/v2/ocr",
    headers: {
        apikey: "YOUR_API_KEY",
        ...data.getHeaders(),
    },
    data: data,
}

axios(config)
    .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/passport-ocr/v2/ocr',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => array(
      'apikey: YOUR_API_KEY'
  ),
  CURLOPT_POSTFIELDS => array(
      'file'=> new CURLFILE('passport.jpg')
  )
  ));

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

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/passport-ocr/v2/ocr")!
let boundary = "Boundary-\(UUID().uuidString)"

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

let imageData = try! Data(contentsOf: URL(fileURLWithPath: "passport.jpg"))

var body = Data()
body.append("--\(boundary)\r\n")
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n")
body.append("Content-Type: image/jpeg\r\n\r\n")
body.append(imageData)
body.append("\r\n--\(boundary)--\r\n")

let task = URLSession.shared.uploadTask(with: request, from: body) { data, response, error in
    if let data = data {
        let json = try? JSONSerialization.jsonObject(with: data)
        print(json ?? "")
    }
}
task.resume()

Kotlin

import okhttp3.*
import java.io.File

val client = OkHttpClient()

val file = File("passport.jpg")
val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file",
        file.name,
        RequestBody.create(MediaType.parse("image/jpeg"), file)
    )
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/passport-ocr/v2/ocr")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build()

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

Java

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.file.*;

public class PassportOCR {
    public static void main(String[] args) throws IOException {
        String boundary = "Boundary-" + System.currentTimeMillis();
        URL url = new URL("https://api.iapp.co.th/passport-ocr/v2/ocr");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();

        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setRequestProperty("apikey", "YOUR_API_KEY");
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);

        try (OutputStream os = conn.getOutputStream()) {
            byte[] fileBytes = Files.readAllBytes(Paths.get("passport.jpg"));

            os.write(("--" + boundary + "\r\n").getBytes());
            os.write(("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n").getBytes());
            os.write(("Content-Type: image/jpeg\r\n\r\n").getBytes());
            os.write(fileBytes);
            os.write(("\r\n--" + boundary + "--\r\n").getBytes());
        }

        try (BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {
            String line;
            while ((line = br.readLine()) != null) {
                System.out.println(line);
            }
        }
    }
}

Dart

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

Future<void> scanPassport() async {
    var url = Uri.parse('https://api.iapp.co.th/passport-ocr/v2/ocr');
    var request = http.MultipartRequest('POST', url);

    request.headers['apikey'] = 'YOUR_API_KEY';

    request.files.add(
    await http.MultipartFile.fromPath(
        'file',
        'passport.jpg',
    ),
    );

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

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

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• รูปแบบที่รองรับ: JPG, PNG, PDF
• พาสปอร์ตหนึ่งเล่มต่อภาพหนึ่งภาพ
• จำเป็นต้องใช้ภาพที่ชัดเจนและโฟกัส

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

• ตรวจสอบให้แน่ใจว่าสภาพแสงสว่างดี
• หลีกเลี่ยงแสงสะท้อนและแสงจ้า
• จัดวางพาสปอร์ตให้ตรงกลางเฟรม
• วางพาสปอร์ตให้เรียบ
• ใช้ภาพความละเอียดสูง
• เปิดใช้งานตัวเลือกการแบ่งส่วนสำหรับภาพที่เอียง

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

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

• เวอร์ชันปัจจุบัน (2.0): 95.51%
• เวอร์ชันก่อนหน้า (1.1): 88.86%

ความแม่นยำในระดับฟิลด์ (เวอร์ชัน 1.1)

• ชื่อ: 81.93%
• นามสกุล: 90.26%
• หมายเลขเอกสาร: 84.03%
• สัญชาติ: 88.09%
• การตรวจจับใบหน้า: 100%

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

• ภาพเดียว: 1-2 วินาที
• เอกสาร PDF: 2-3 วินาทีต่อหน้า
• เวลาเพิ่มเติมเมื่อใช้การแบ่งส่วน

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

• คุณภาพของภาพ
• สภาพแสงสว่าง
• ตำแหน่งของเอกสาร
• ความละเอียดของภาพ
• สภาพของเอกสาร
• มุมเอียงของภาพ

ประวัติ

เวอร์ชัน 2.0 (กุมภาพันธ์ 2023)

• เพิ่มความแม่นยำโดยรวมจาก 88.86% เป็น 95.51%
• อัปเกรดเครื่องมือ OCR ทั้งหมด
• เพิ่มการประมวลผลล่วงหน้าการแบ่งส่วนภาพสำหรับภาพที่เอียง

เวอร์ชัน 1.1 (มกราคม 2023)

• เพิ่มการดึงใบหน้าเป็น base64
• เพิ่มการรองรับภาพที่เอียงเล็กน้อย
• เพิ่มการรองรับไฟล์ PDF
• เพิ่มการรองรับ PDF หลายหน้า

เวอร์ชัน 1.0 (กุมภาพันธ์ 2022)

• การเปิดตัวครั้งแรก
• รองรับพาสปอร์ตของทุกประเทศที่ใช้ MRZ
• รองรับรูปแบบไฟล์พื้นฐาน (PNG, JPG, JPEG)

ราคา

ชื่อบริการ AI API	Endpoint	IC ต่อคำขอ	On-Premise
Passport OCR [v2.0]	passport_ocr_v1	0.75 IC/Request	ติดต่อเรา
	passport_ocr_v2	0.75 IC/Request