Tóm tắt văn bản API
Tóm tắt bài viết tiếng Việt hoặc tiếng Anh bằng cách chọn các câu quan trọng nhất (TextRank), kèm từ khoá và điểm số; nhanh, ổn định, không tốn phí AI.
API tóm tắt tạo bản tóm tắt trích xuất: API tách văn bản thành câu, biểu diễn mỗi câu bằng các từ (tiếng Việt được tách từ trước, nên “ngân hàng” là một từ), dựng đồ thị độ tương đồng giữa các câu với trọng số TF-IDF và xếp hạng bằng TextRank, thuật toán tương tự PageRank. Các câu tốt nhất (sentences, hoặc tỷ lệ ratio của văn bản) được trả về theo thứ tự gốc, kèm điểm, từ khoá chính và tỷ lệ rút gọn.
Vì các câu được giữ nguyên từ văn bản, bản tóm tắt không bao giờ bịa ra thông tin, và cùng một văn bản luôn cho cùng kết quả. Chữ viết tắt như “TP.” và số thập phân được xử lý khi tách câu, ngôn ngữ được tự nhận diện (hoặc đặt bằng lang).
Tóm tắt trích xuất phù hợp nhất với tin tức, báo cáo và tài liệu. Muốn tóm tắt viết lại câu chữ thì cần mô hình AI; API này chủ động không dùng AI để luôn nhanh và rẻ.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
text | body | string | có | Văn bản (tối đa 200.000 ký tự). | |
sentences | body | number | không | Số câu (1–50; mặc định khoảng 25%, tối đa 5). | |
ratio | body | number | không | Tỷ lệ câu giữ lại (0,05–0,9), thay cho sentences. | |
lang | body | string | không | vi hoặc en (mặc định: tự nhận). |
Ví dụ
curl -X POST "https://apibox.io.vn/v1/summarize" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Ngân hàng Nhà nước vừa công bố giảm lãi suất điều hành thêm 0,5 điểm phần trăm… (8 câu)","sentences":3}'const res = await fetch('https://apibox.io.vn/v1/summarize', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"text": "Ngân hàng Nhà nước vừa công bố giảm lãi suất điều hành thêm 0,5 điểm phần trăm… (8 câu)",
"sentences": 3
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/summarize",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"text": "Ngân hàng Nhà nước vừa công bố giảm lãi suất điều hành thêm 0,5 điểm phần trăm… (8 câu)", "sentences": 3},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/summarize');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"text":"Ngân hàng Nhà nước vừa công bố giảm lãi suất điều hành thêm 0,5 điểm phần trăm… (8 câu)","sentences":3}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"lang": "vi",
"sentences_total": 8,
"sentences_selected": 3,
"summary": "Ngân hàng Nhà nước vừa công bố giảm lãi suất điều hành thêm 0,5 điểm phần trăm, áp dụng từ ngày 15/11. Các ngân hàng thương mại dự kiến sẽ giảm lãi suất cho vay trong tháng tới. Ngân hàng Nhà nước cho biết sẽ theo dõi chặt chẽ diễn biến thị trường để điều hành linh hoạt.",
"sentences": [
"…"
],
"keywords": [
"ngân hàng",
"lãi suất",
"…"
],
"compression": 0.4,
"method": "Extractive (TextRank over TF-IDF sentence similarity); …"
}
Ứng dụng
- Bản tin tổng hợp, đoạn xem trước bài viết
- Tóm tắt ticket hỗ trợ, báo cáo dài
- Sinh meta description từ nội dung bài
- Đọc nhanh tài liệu trong công cụ nội bộ
Hỏi đáp
Đây có phải AI không?
Không dùng mô hình ngôn ngữ lớn: TextRank là thuật toán đồ thị. Kết quả ổn định và chỉ tốn như mọi request khác.
Văn bản cần dài bao nhiêu?
Từ vài đoạn trở lên; dưới 3 câu thì trả về nguyên văn bản.
Có dùng được cho tiếng Việt không?
Có, có tách từ và danh sách từ dừng tiếng Việt.
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.