Kiểm tra chính tả tiếng Việt API
Kiểm tra chính tả tiếng Việt: âm tiết sai, quy tắc c/k, g/gh, ng/ngh, lỗi hay gặp (xử dụng, sử lý, nghành) và dấu câu, kèm gợi ý sửa.
API kiểm tra chính tả đọc văn bản theo từng âm tiết. API báo các âm tiết không có trong tiếng Việt (phát triễn → triển), lỗi sai quy tắc chính tả (kon → con, ghà → gà, ngiệp → nghiệp, âm tiết tận cùng p, t, c, ch mang sai dấu), và danh sách các lỗi hay gặp như xử dụng, sử lý, nghành, chuẩn đoán, bổ xung, sát nhập.
Lỗi trình bày cũng được kiểm tra: dấu cách trước dấu câu, thiếu dấu cách sau dấu phẩy, thừa dấu cách và chữ thường ở đầu câu. Mỗi lỗi có vị trí (start, end), loại, mức độ (error, warning, info), thông báo tiếng Việt và tiếng Anh cùng gợi ý; corrected là văn bản đã áp dụng gợi ý đầu tiên cho từng lỗi. Chấp nhận cả hai kiểu đặt dấu (hoà / hòa), bỏ qua từ tiếng Anh và chữ viết tắt, ignore để liệt kê các từ cần bỏ qua.
API dựa trên kho âm tiết và quy tắc chính tả, không dùng mô hình AI nên nhanh và ổn định; ngữ pháp và cách dùng từ (dành / giành) không được kiểm tra.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
text | body|query | string | có | Văn bản cần kiểm tra (tối đa 50.000 ký tự). | |
ignore | body|query | string | không | Các từ bỏ qua, ngăn cách bằng dấu phẩy (tên thương hiệu, thuật ngữ). |
Ví dụ
curl -X POST "https://apibox.io.vn/v1/vn-spellcheck" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."}'const res = await fetch('https://apibox.io.vn/v1/vn-spellcheck', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"text": "Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-spellcheck",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"text": "Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-spellcheck');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"text":"Chúng tôi xử dụng công nghệ để sử lý dữ liệu ,giúp doanh nghiệp phát triễn. kết quả rất tốt."}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"errors": 3,
"warnings": 0,
"info": 2,
"issues": [
{
"start": 10,
"end": 17,
"text": "xử dụng",
"type": "common_misspelling",
"severity": "error",
"message_vi": "Viết đúng là \"sử dụng\"",
"message_en": "The correct spelling is \"sử dụng\"",
"suggestions": [
"sử dụng"
]
},
{
"start": 31,
"end": 36,
"text": "sử lý",
"type": "common_misspelling",
"severity": "error",
"message_vi": "Viết đúng là \"xử lý\"",
"message_en": "The correct spelling is \"xử lý\"",
"suggestions": [
"xử lý"
]
},
{
"start": 44,
"end": 46,
"text": " ,",
"type": "punctuation",
"severity": "info",
"message_vi": "Không đặt dấu cách trước dấu câu",
"message_en": "No space before punctuation",
"suggestions": [
", "
]
},
{
"start": 69,
"end": 74,
"text": "triễn",
"type": "unknown_syllable",
"severity": "error",
"message_vi": "Âm tiết không tồn tại trong tiếng Việt",
"message_en": "Not a Vietnamese syllable",
"suggestions": [
"triển",
"triền",
"tiền"
]
},
{
"start": 76,
"end": 77,
"text": "k",
"type": "capitalization",
"severity": "info",
"message_vi": "Viết hoa chữ cái đầu câu",
"message_en": "Capitalise the first letter of the sentence",
"suggestions": [
"K"
]
}
],
"corrected": "Chúng tôi sử dụng công nghệ để xử lý dữ liệu, giúp doanh nghiệp phát triển. Kết quả rất tốt.",
"note": "Spelling check: syllables, spelling rules and frequent mistakes. Grammar and word choice (e.g. dành / giành) are not checked."
}
Ứng dụng
- Soát chính tả mô tả sản phẩm, bài viết trước khi đăng
- Kiểm tra e-mail, thông báo gửi khách hàng
- Làm sạch nội dung người dùng nhập trong form, đánh giá
- Kiểm tra chất lượng văn bản dịch hoặc do AI viết
Hỏi đáp
Có kiểm tra ngữ pháp không?
Không, chỉ kiểm tra chính tả, các lỗi hay gặp và cách trình bày. Những cặp như dành / giành phụ thuộc nghĩa nên không được kiểm tra.
Từ tiếng Anh có bị báo lỗi không?
Chữ viết tắt và từ không thể là tiếng Việt được bỏ qua; từ còn nghi ngờ chỉ bị cảnh báo (warning), không tính là lỗi. Thêm thuật ngữ riêng bằng ignore.
Viết hoà hay hòa mới đúng?
Cả hai cách đặt dấu đều được chấp nhận.
API liên quan
So sánh văn bản
So sánh hai đoạn văn bản theo dòng, từ, ký tự, câu hoặc JSON; nhận danh sách thay đổi, tỉ lệ giống nhau và bản diff dạng unified.
a-bTạo slug
Chuyển tiêu đề thành slug URL gọn gàng: bỏ dấu tiếng Việt (cả chữ đ), tuỳ chọn ký tự phân cách, giữ chữ hoa và giới hạn độ dài.
123Thống kê văn bản
Đếm số từ, ký tự, câu, đoạn và dòng; ước tính thời gian đọc và thời gian nói; liệt kê các từ xuất hiện nhiều nhất trong văn bản.