Giao diện
Token AI theo workspace
Mọi thao tác AI trong TKHQ (trợ lý chat, trích xuất chứng từ, gợi ý mã HS…) đều trừ token của workspace. Xem số dư, mua thêm và tra lịch sử tại /tokens.
Khái niệm
Token là đơn vị đo lượng chữ mà mô hình AI xử lý cho bạn — tính cả phần gửi đi (nội dung tài liệu, câu hỏi) lẫn phần AI trả về. Một trang chứng từ thường tốn khoảng 5.000 token.
Workspace có 2 nguồn token, hệ thống luôn trừ hạn mức của gói trước, hết mới trừ token đã mua thêm:
| Nguồn | Đến từ đâu | Hết hạn |
|---|---|---|
| Hạn mức gói | 500.000 token / thành viên / tháng | Reset mỗi kỳ, không cộng dồn |
| Token mua thêm | Các gói token mua lẻ tại /tokens | Không hết hạn, dùng đến hết |
Trong lúc gói tạm dừng
Khi bạn tạm dừng gói, hạn mức gói không dùng được — thao tác AI chỉ trừ vào token đã mua thêm. Hết token mua thêm thì thao tác AI báo lỗi thiếu token.
Dùng thử
Workspace đang trong 30 ngày dùng thử nhận 50.000 token (khoảng 10 trang chứng từ). Xem Gói dịch vụ & Thanh toán.
Theo dõi
Số token còn lại hiển thị ngay trên thanh tiêu đề, theo workspace đang mở. Bấm vào để mở trang /tokens.
Trang /tokens xếp dọc một mạch, không chia tab:
- Thẻ số dư — 2 con số lớn tách riêng: token gói (hết hạn theo kỳ, reset khi gia hạn) và token đã mua (không hết hạn, dùng tới khi hết), cùng thanh hạn mức tháng hiện % đã dùng và "reset sau N ngày"
- Mua thêm token — grid 3 gói mua lẻ, xem mục Mua thêm token bên dưới
- Banner "Tháng nào cũng phải mua thêm? Tăng số thành viên để có thêm token mỗi tháng" dẫn sang
/billing - Biểu đồ tiêu thụ theo thời gian
- Lịch sử giao dịch — bảng liệt kê từng lần token vào/ra, xem mục Lịch sử giao dịch bên dưới
Khi tài khoản hết token, thẻ số dư hiện cảnh báo đỏ "Bạn đã hết token AI"; khi sắp hết hiện cảnh báo vàng "Token sắp hết" kèm số còn lại. Cả 2 ngưỡng lấy từ /me/account-status — cùng nguồn với banner cảnh báo real-time toàn app, không tính lại riêng ở trang này.
Mua thêm token
Trên /tokens, khối mua thêm nằm ngay dưới thẻ số dư (không phải tab riêng). Mua thêm khi hạn mức của gói sắp hết. Token mua thêm không reset hàng tháng — dùng đến hết.
Các gói token mua thêm:
| Gói | Token | Giá | Đơn giá / trang chứng từ |
|---|---|---|---|
| Nhỏ | 500.000 | 129.000 ₫ | ~1.290 ₫ |
| Vừa | 2.500.000 | 499.000 ₫ | ~1.000 ₫ |
| Lớn | 10.000.000 | 1.690.000 ₫ | ~845 ₫ |
Token mua thêm không hết hạn và không bị reset theo kỳ — trang hiển thị nhãn "Không hết hạn" để phân biệt với hạn mức gói.
Các bước mua:
Chọn gói → QR SePay → Chuyển khoản → Token cộng vào wallet
Xác nhận trước khi mua
Trước khi chuyển sang thanh toán, hệ thống hiện hộp xác nhận: tên gói, số token, giá, số dư hiện tại và số dư dự kiến sau khi mua. Nhấn Xác nhận & Thanh toán mới chuyển sang trang thanh toán. Mỗi gói đều có nhãn "Không hết hạn" để phân biệt với hạn mức của gói (reset mỗi kỳ).
Nếu danh sách gói không tải được, trang hiện thông báo lỗi kèm nút Thử lại.
Chia hạn mức theo thành viên
Hiện token dùng chung cho cả workspace — mọi thành viên tiêu vào một hạn mức. Chưa có cách đặt trần riêng cho từng người.
Bù lại, mọi lần trừ token đều được ghi vào lịch sử giao dịch kèm thao tác đã sinh ra nó, nên chủ workspace luôn truy được token đã chảy vào đâu (xem mục dưới).
Lịch sử giao dịch
Phần Lịch sử giao dịch ở cuối trang /tokens liệt kê từng lần token vào/ra, mới nhất trước, 20 dòng mỗi trang:
| Cột | Nội dung |
|---|---|
| Thời gian | Thời điểm ghi nhận |
| Loại | Cấp quota · Mua token · Tiêu thụ · Hoàn tiền · Hết hạn · Tặng · Điều chỉnh |
| Số lượng | Dấu + là cộng vào, không dấu là trừ đi |
| Số dư sau | Số token còn lại ngay sau giao dịch đó |
| Tham chiếu | Thao tác/đơn hàng đã sinh ra giao dịch |
Đây là nơi đối chiếu khi thấy token tụt nhanh hơn dự kiến: xem dòng Tiêu thụ có số lớn và lần theo cột tham chiếu.
Mỗi thao tác tốn bao nhiêu token
Không có bảng giá cố định cho từng thao tác: số token trừ đi đúng bằng lượng token mô hình AI thực dùng cho lần gọi đó (phần gửi đi + phần trả về), không nhân thêm hệ số. Tài liệu càng dài, câu hỏi càng nhiều ngữ cảnh thì càng tốn.
Ước lượng theo kinh nghiệm:
| Thao tác | Mức tiêu thụ |
|---|---|
| Trích xuất chứng từ | ~5.000 token / trang |
| Chat trợ lý — câu hỏi ngắn | Thấp, vài trăm đến vài nghìn token |
| Chat trợ lý — hỏi kèm tài liệu dài | Cao, tỉ lệ theo độ dài tài liệu đính |
| Phân loại mã HS, gợi ý chi cục | Thấp |
Muốn biết con số chính xác của một lần chạy, mở /tokens → phần Lịch sử giao dịch: mỗi dòng ghi đúng số token đã trừ cho thao tác đó.
Tiết kiệm token
- Upload PDF có sẵn lớp chữ (không phải ảnh scan) — AI đọc ít hơn hẳn so với ảnh
- Cùng một file trích xuất lại trong vòng 7 ngày dùng kết quả đã lưu, không trừ token lần hai
- Hỏi súc tích, chỉ đính kèm tài liệu thật sự cần
Khi nào token bị trừ
Token chỉ bị trừ sau khi thao tác AI chạy xong thành công — gọi thất bại, quá thời gian chờ hoặc bị huỷ giữa chừng đều không mất token.
Mỗi lần trừ đều được ghi vào sổ giao dịch. Hệ thống đối soát định kỳ giữa số dư hiển thị và sổ giao dịch, tự sửa nếu phát hiện lệch.
Giới hạn tần suất
Ngoài token, mỗi tài khoản còn có giới hạn số lần gọi AI để tránh lạm dụng:
| Thao tác | Giới hạn |
|---|---|
| Chat trợ lý | 20 tin nhắn / giờ / người |
| Trích xuất chứng từ | 1.000 lượt / ngày / người |
| Phân loại mã HS | 100 lượt / ngày / người |
Vượt giới hạn, hệ thống báo lỗi và không trừ token. Chờ hết khung giờ (hoặc sang ngày mới) là dùng lại được.