Tách họ tên tiếng Việt online
Tách họ tên người Việt thành họ, tên đệm, tên; chuẩn hoá viết hoa, đoán giới tính kèm xác suất, gợi ý xưng hô anh / chị và địa chỉ email.
Kết quả
Bấm “Chạy” để xem kết quả.
Tên người Việt viết họ trước (Nguyễn Văn Hùng) và được gọi bằng chữ cuối. API chuẩn hoá khoảng trắng và viết hoa (nguyễn văn HÙNG → Nguyễn Văn Hùng), tách họ, tên đệm, tên, kể cả họ nhiều chữ (Tôn Nữ, Tôn Thất, Âu Dương, Nguyễn Phước, Công Tằng Tôn Nữ), và nhận ra tên viết theo kiểu phương Tây (Hung Van Nguyen). Kết quả có first_name / last_name cho form quốc tế, dạng không dấu và VIẾT HOA KHÔNG DẤU cho thẻ ngân hàng, chữ viết tắt, slug URL và các kiểu tên email doanh nghiệp hay dùng (hungnv, hung.nguyen).
Giới tính được đoán kèm xác suất từ tên đệm (Thị, Văn) và thống kê khoảng 2.500 tên có nhãn nam / nữ (duyet/vietnamese-namedb, giấy phép MIT, cập nhật hằng tuần). API gợi ý cách xưng hô (anh / chị, ông / bà, Chào chị Hương, Kính gửi Bà …); tên trung tính như Anh, Linh có độ tin cậy thấp hơn hoặc unknown. Gửi names (mảng hoặc mỗi dòng một tên, tối đa 1.000) để xử lý danh sách, thêm sort=true để sắp xếp kiểu Việt Nam (theo tên, rồi tên đệm, rồi họ, đúng thứ tự bảng chữ cái tiếng Việt).
Giới tính chỉ là dự đoán thống kê, chỉ nên dùng để chọn cách xưng hô, không dùng để ra quyết định về một người. Không lưu dữ liệu.
Dùng trong code của bạn
curl "https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-name?name=nguy%E1%BB%85n%20%20th%E1%BB%8B%20thu%20H%C6%AF%C6%A0NG');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Tài liệu API → Nhận API key miễn phí
Hỏi đáp
Đoán giới tính chính xác đến đâu?
Rất cao khi có Thị hoặc Văn và với tên rõ nam / nữ; thấp hơn với tên trung tính (Anh, Linh, Minh), khi đó xác suất gần 0,5 và có thể trả về unknown.
Nhận diện được những họ nào?
Khoảng 150 họ phổ biến cùng các họ nhiều chữ (Tôn Nữ, Tôn Thất, Âu Dương, Nguyễn Phước…). Họ lạ vẫn được giữ nguyên và có cảnh báo.
Sắp xếp kiểu Việt Nam là thế nào?
Theo tên trước, rồi tên đệm và họ, dùng thứ tự chữ cái tiếng Việt (a ă â … d đ …) và dấu thanh, như cách xếp danh sách lớp.