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.

POSTGEThttps://apibox.io.vn/v1/vn-spellcheck

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ênVị tríKiểuBắt buộcMặc định
textbody|querystringcóVăn bản cần kiểm tra (tối đa 50.000 ký tự).
ignorebody|querystringkhôngCá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."}'

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →