Lọc từ ngữ thô tục API

Phát hiện và che từ thô tục, xúc phạm tiếng Việt (và tiếng Anh thông dụng), kể cả viết không dấu, teencode, l33t và chèn ký tự kiểu đ.ị.t.

GETPOSThttps://apibox.io.vn/v1/profanity-vi

Văn bản▶ Dùng thử online

API lọc từ thô tục tìm các từ xúc phạm trong bình luận, tin nhắn, đánh giá tiếng Việt và trả về bản đã che. Bộ từ điển gồm từ tục tĩu, chửi thề, xúc phạm và viết tắt teencode (đm, vcl, dmm, clgt…) cùng các từ chửi thề, miệt thị tiếng Anh thông dụng, mỗi từ có nhóm (sexual, vulgar, insult, slur) và mức độ (mild, moderate, severe).

API được thiết kế cho các mẹo thường gặp: bỏ dấu khi vẫn không gây nhầm (dit me), kéo dài chữ (đụuuu), thay chữ bằng số và ký hiệu (sh1t, f@ck), chèn ký tự giữa từ (đ.ị.t, l-ồ-n). Các từ chỉ tục khi có dấu (lồn, cặc, buồi) chỉ được so khớp khi có dấu, nên “lon bia”, “các bạn”, “buổi sáng” không bao giờ bị đánh dấu; từ dễ nhầm (cc, đù, cave) chỉ được kiểm tra khi strict=true.

Phản hồi gồm mức độ tổng, điểm, từng kết quả kèm vị trí và văn bản đã che censored (ký tự mask, keep_first=true để giữ chữ cái đầu). Thêm từ riêng bằng extra_words và loại trừ bằng allow.

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 100.000 ký tự).
`mask`	body\|query	string	không	`*`	Ký tự dùng để che.
`keep_first`	body\|query	boolean	không	`false`	Giữ chữ cái đầu của từ bị che.
`strict`	body\|query	boolean	không	`false`	Bắt cả các từ dễ nhầm (cc, đù, cave…).
`extra_words`	body\|query	string	không		Các từ thêm vào, phân cách bằng dấu phẩy.
`allow`	body\|query	string	không		Các từ bỏ qua, phân cách bằng dấu phẩy.

Ví dụ

curl -X POST "https://apibox.io.vn/v1/profanity-vi" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Đm, cái này vcl thật","keep_first":true}'

const res = await fetch('https://apibox.io.vn/v1/profanity-vi', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "text": "Đm, cái này vcl thật",
    "keep_first": true
  }),
});
const data = await res.json();
console.log(data);

import requests

res = requests.post(
    "https://apibox.io.vn/v1/profanity-vi",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"text": "Đm, cái này vcl thật", "keep_first": True},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/profanity-vi');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"text":"Đm, cái này vcl thật","keep_first":true}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Kết quả trả về

{
  "profane": true,
  "severity": "moderate",
  "score": 60,
  "count": 2,
  "categories": [
    "vulgar"
  ],
  "matches": [
    {
      "text": "Đm",
      "start": 0,
      "end": 2,
      "word": "dm",
      "category": "vulgar",
      "severity": "moderate"
    },
    {
      "text": "vcl",
      "start": 12,
      "end": 15,
      "word": "vcl",
      "category": "vulgar",
      "severity": "moderate"
    }
  ],
  "censored": "Đ*, cái này v** thật",
  "strict": false
}

Ứng dụng

Kiểm duyệt bình luận, đánh giá, tin nhắn chat
Lọc tên người dùng, tên hiển thị khi đăng ký
Đánh dấu tin nhắn cần người kiểm tra trong công cụ hỗ trợ khách hàng
Giữ chat trong bot, game lành mạnh

Hỏi đáp

Từ bình thường viết không dấu có bị bắt nhầm không?

Không. Các từ như lồn / cặc / buồi chỉ tính khi có dấu, vì lon, cac, buoi không dấu là từ bình thường.

Có tuỳ chỉnh danh sách được không?

Có: extra_words thêm từ hoặc cụm từ (phân cách bằng dấu phẩy), allow bỏ bớt, strict=true bật các từ dễ nhầm.

Văn bản có bị lưu không?

Không, chỉ xử lý trong bộ nhớ.

Lọc từ ngữ thô tục API

Tham số

Ví dụ

Kết quả trả về

Ứng dụng

Hỏi đáp

API liên quan

So sánh văn bản

Tạo slug

Thống kê văn bản