带签名检测的泰国民众身份证照片识别

1.25 IC每页

v1.1.1-20260822 运行中自 2023 年起最近更新 2026-08-22 10,500 张/小时准确率 97.1% 白皮书 (PDF) POST /v3/store/ekyc/thai-national-id-card-with-signature

提供移动端与网页版 SDK

无需自行开发摄像头功能——我们免费开源的 eKYC SDK（Web、Flutter、iOS、Android 与 React Native）可自动拍摄证件与面部，并为您调用此 API。在 GitHub 上查看。

带签名检测的泰国民众身份证照片识别 API 可从拍摄的泰国民众身份证复印件（彩色或黑白均可）中提取结构化数据，并检测复印件上是否已签名。系统会自动在图像中定位证件，并以 JSON 格式返回身份证号码、姓名、出生日期、地址和有效期，每个字段均附有置信度分数。生产服务处理一张证件的中位耗时为 0.7 秒，可持续处理每小时超过 10,500 张。以人工核验的基准数据衡量，字段级准确率为 97.1%，其中 13 位国民身份证号码的准确率为 100%；详见准确率。

在线演示

请上传泰国民众身份证复印件照片，或选择下方示例。示例均为合成样本证件，并非真实证件。

试用 AI 演示

登录或创建免费账户来使用此 AI 服务演示并探索我们强大的 API。

注册即可获得 100 积分 (IC) 免费赠送！

优惠截止至 2025 年 12 月 31 日

免费创建账户登录

Example Images (Click to try)

Try Demo

Try Demo

API Key

Endpoint URL

cURL Command

上传泰国民众身份证复印件照片

试用 SDK（实时摄像头）

若您不希望上传文件，免费开源的 iApp eKYC Web SDK 可通过您的摄像头自动拍摄身份证复印件照片——它会检测证件边界、等待清晰稳定的画面、对图像进行透视校正，然后提交至此 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
}

完整的响应结构见技术参考。

端点与定价

端点	输出	价格
`POST /v3/store/ekyc/thai-national-id-card-with-signature`	包含提取字段、签名检测结果与置信度分数的 JSON	每页 1.25 IC

旧版路径 /thai-national-id-card-with-signature/front 与 /thai-national-id-card/copy 仍受支持，价格相同。本 API 针对拍摄的复印件进行了优化；如需直接对实体身份证进行 OCR，请使用泰国民众身份证 OCR。本地部署方案见数据安全。

性能

以下数据于 2026 年 8 月在生产服务上实测。

指标	数值
处理时间中位数	每张 0.7 s
持续吞吐量	每秒 2.9 张（每小时 10,500 张）
最大文件大小	2 MB
支持的输入格式	JPEG、JPG、PNG、HEIC、HEIF
图像中证件的最小尺寸	600 × 400 px

准确率

准确率以人工核验的基准数据衡量：33 张已标注的泰国民众身份证，共计 594 条字段观测。基准数据集包含真实身份证，出于隐私原因不对外公开；完整方法论详见下方白皮书。

字段	完全匹配率
国民身份证号码（13 位）	100%
地址：门牌号	97.0%
地址（完整）	93.9%
全部字段（总体）	97.1%
签名检测	96.5%

v1.1.1 识别引擎将总体字段级准确率由 96.3% 提升至 97.1%，其中门牌号与地址的提升最为显著。完整方法论、逐字段结果以及与某领先国际云 OCR 服务的对比已发布于基准白皮书：

下载基准白皮书（PDF）

数据安全与合规

本服务符合 GDPR 与 PDPA 要求。
上传的图像仅在内存中处理，响应返回后不予保留。
提供完全自包含的本地部署方案，证件数据不会离开您的基础设施。详情请联系我们。

技术参考

请求

使用 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	门牌号与村（moo）编号
`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 网关的请求 ID
`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 -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"

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())

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
$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;
?>

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()

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())
}

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());
}

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());

使用限制

本 API 针对拍摄的身份证复印件进行了优化；实体证件请使用泰国民众身份证 OCR。
图像中的证件尺寸不得小于 600 × 400 px；300 dpi 或更高分辨率的扫描件效果最佳。
超过 2 MB 的文件将被拒绝。
字段区域分辨率过低会降低识别质量；请确保证件对焦清晰，并在画面中占据合理比例。

更新日志

版本	日期	变更内容
v1.1.1-20260822	2026-08-22	升级识别引擎：以人工核验的基准数据衡量，字段级准确率由 96.3% 提升至 97.1%，其中国民身份证号码达到 100%。处理时间中位数为每张 0.7 s。提供完全自包含的本地部署方案。
v1.0	2023	首次发布，包含签名检测。

带签名检测的泰国民众身份证照片识别

在线演示

试用 AI 演示

Example Images (Click to try)

试用 SDK（实时摄像头）

快速开始

端点与定价

性能

准确率

数据安全与合规

技术参考

请求

响应

响应字段

响应代码

代码示例

使用限制

更新日志

ChindaX

SpeechFlow

ChindaGO

在线演示​

试用 AI 演示

Example Images (Click to try)

试用 SDK（实时摄像头）​

快速开始​

端点与定价​

性能​

准确率​

数据安全与合规​

技术参考​

请求​

响应​

响应字段​

响应代码​

代码示例​

使用限制​

更新日志​

在线演示

试用 SDK（实时摄像头）

快速开始

端点与定价

性能

准确率

数据安全与合规

技术参考

请求

响应

响应字段

响应代码

代码示例

使用限制

更新日志