Credits AI: ví, gói, giá và hạn mức

Mỗi người dùng có một ví credits AI. Tính năng AI mà người học tự bấm (chatbot, chấm bài tự động, luyện tập, hội thoại…) trừ credits từ ví đó. Trang này nói cách đặt giá, cấp và bán credits, và cấu hình nhắc nhở. Phía người học xem ở Tín dụng AI.

Credits là giá tổ chức bán; số tiền tổ chức trả cho nhà cung cấp AI là chuyện khác, đọc ở Theo dõi chi phí AI.

Vào đâu

Màn hình	Nhóm menu	Dùng để
Các ví AI	AI	Xem số dư từng người, cấp thêm credits, cấp một gói
Giá credits theo tính năng	AI	Mỗi tính năng tốn bao nhiêu credits; bật/tắt từng tính năng
Lịch sử sử dụng AI	AI	Nhật ký từng lượt gọi: người dùng, tính năng, token, credits, chi phí USD
Các gói credits AI	AI	Tạo gói để bán, tặng cho một người hoặc cả nhóm
Tổng quan sử dụng AI	Báo cáo & Phân tích	Tổng hợp chi tiêu và chi phí → Theo dõi chi phí AI
Cài đặt → Trí tuệ nhân tạo → Hạn mức credits AI	Cài đặt	Giới hạn theo phút, credits tặng khi tạo tài khoản, nhắc nhở, hình thức nạp thêm

Module AiCredits phải bật. Muốn bán gói credits thì cần thêm module AiCreditsCommerce (và Ecommerce) — xem Bán gói credits.

Ai làm được gì

Vai trò mặc định	Có gì
Quản trị viên (admin)	Mọi màn hình trên, kể cả cấp credits và khối Hạn mức credits AI
Kế toán (finance)	Xem ví và gói credits

Cấp credits trên ví, tặng gói cho nhóm và cấp cho cả lớp đòi quyền update_ai_wallet.

Tặng gói cho một người chưa gác quyền

Thao tác Tặng cho người dùng trên màn hình gói credits hiện không kiểm update_ai_wallet: ai mở được danh sách gói (kể cả Kế toán) đều tặng được gói cho một người. Chỉ cấp quyền xem gói credits cho người bạn tin cậy. ::: Khối Hạn mức credits AI đòi configure_ai_credits — quyền này cố ý không gộp vào quyền của người soạn nội dung, vì hạn mức chi tiêu là quyết định của bên trả tiền.

Ba loại credits trong một ví

Loại (tên trong ví)	Đến từ đâu	Hết hạn?
Credits tặng / Được tặng	Credits tặng khi tạo tài khoản, khi có đặt hạn dùng	Có — ngày hết hạn hiện trong ví
Từ gói đăng ký	Gói thuê bao có kèm credits	Bị thay (không cộng dồn) mỗi lần gói được kích hoạt: dùng hay không cũng mất phần cũ
Credits đã mua / Mua thêm	Mua gói, quản trị viên cấp, credits tặng không đặt hạn	Không bao giờ hết hạn

Thứ tự tiêu: tặng → gói đăng ký → đã mua. Thứ sắp hết hạn được tiêu trước.

Khối "Hạn mức credits AI"

Cài đặt → Trí tuệ nhân tạo, tab Hạn mức credits AI (/admin/settings/ai?tab=ai_credits).

Giới hạn theo phút

Áp cho mỗi người dùng, chặn trước khi gọi tới nhà cung cấp AI.

Ô	Ý nghĩa
Số lượt gọi tối đa mỗi phút	Mặc định cho người chưa có giới hạn riêng (1–600)
Số credits tối đa mỗi phút	Trần chi tiêu ngắn hạn: chặn một vòng lặp hỏng đốt sạch ví trong vài giây

Người bị chặn vì giới hạn theo phút thấy câu bảo chờ ("Vui lòng chờ … giây…" hoặc "Bạn đang gửi quá nhiều yêu cầu AI…"), không thấy nút nạp thêm: chờ là đủ.

Ví credits

Ô	Ý nghĩa
Hạn mức credits mỗi tháng	Mặc định 0. Hiện chưa có tác dụng — đổi giá trị không ảnh hưởng ví nào. Xem lưu ý dưới.
Ngưỡng cảnh báo sắp hết (%)	Chỉ dùng cho ví có hạn mức tháng: còn dưới tỉ lệ này thì huy hiệu credits chuyển màu cảnh báo

Hạn mức tháng

Gần như mọi ví không có hạn mức tháng, và khi đó ngưỡng cảnh báo lấy từ ô Ngưỡng cảnh báo (credits) ở khối nhắc nhở bên dưới. Để tặng credits cho người mới, dùng Credits tặng khi tạo tài khoản, không dùng ô hạn mức tháng. Hạn mức tháng của một ví sửa được trên màn hình Các ví AI.

Cấp credits cho tài khoản mới

Ô	Ý nghĩa
Credits tặng khi tạo tài khoản	Số credits tặng một lần cho mỗi tài khoản. 0 = tắt.
Hạn dùng credits tặng (ngày)	0 = không hết hạn (credits vào phần đã mua). Lớn hơn 0 = credits vào phần được tặng, kèm ngày hết hạn, và được tiêu trước.
Chỉ cấp khi email đã xác thực	Chặn tạo tài khoản ảo để lấy credits. Chỉ áp cho tài khoản tự đăng ký: người chưa xác thực được cấp sau, lúc họ xác thực email. Học viên do quản trị nhập từ Excel/CSV được cấp ngay, không cần xác thực.

Người nhận được thông báo "Chào mừng! Bạn được tặng … credits AI…", kèm ngày hết hạn nếu có.

Lớp đã nhập TRƯỚC khi bật credits tặng thì không tự có credits

Ngoại lệ "nhập từ Excel thì cấp ngay" chỉ có hiệu lực tại lúc nhập. Ba trường hợp sau ra một lớp không có credits, và đó không phải lỗi:

• Nhập lớp trước, bật credits tặng sau (thứ tự hay gặp nhất). Khi đó tài khoản chưa xác thực email bị ô Chỉ cấp khi email đã xác thực chặn như tài khoản tự đăng ký.
• Tài khoản đã có sẵn trước khi nhập, chỉ được gắn vào lớp.
• Module AiCredits đang tắt lúc nhập.

Cách cấp cho cả lớp bất kể lý do: mở lớp học trong Đào tạo → Lớp học, bấm Cấp Credits AI ở đầu trang, chọn gói → xác nhận. Ví của người chưa có ví được tạo luôn. Muốn cấp cho một vài học viên: chọn họ trong bảng học viên của lớp → hành động hàng loạt Cấp gói credits AI.

Tài khoản do quản trị tạo tay từng người chỉ được cấp credits tặng khi đã xác thực email (trừ khi phanh xác thực email đang tắt); tài khoản đến qua kênh nhập danh sách được miễn điều kiện này. Việc cấp cũng lười: ví (và credits tặng) chỉ được tạo khi người đó chạm vào tính năng AI lần đầu. Vì thế màn hình Các ví AI chỉ liệt kê người đã có ví — không thấy ai đó trong danh sách không có nghĩa là họ bị lỗi.

Nhắc nhở & nạp thêm

Ô	Ý nghĩa
Ngưỡng cảnh báo (credits)	Số dư dưới mức này thì người học nhận cảnh báo sắp hết. Nên đặt cao hơn chi phí của một lượt gọi AI đắt nhất, không thì cảnh báo chỉ đến sau khi đã hết.
Khoảng cách giữa hai lần nhắc (giờ)	Tính riêng cho "sắp hết" và "đã hết". Bộ đếm reset khi người học được nạp thêm.
Hình thức nạp thêm	Xem bảng dưới
Đường dẫn yêu cầu cấp thêm	Chỉ hiện khi chọn Học viên yêu cầu quản trị viên cấp. Trang hoặc biểu mẫu để học viên gửi yêu cầu.

Hình thức nạp thêm	Người học thấy
Học viên tự mua gói credits	Nút Nạp thêm dẫn tới trang mua gói. Chỉ có tác dụng khi tổ chức bán gói; không bán thì không nút nào hiện — ô chọn cảnh báo điều này ngay trên form.
Học viên yêu cầu quản trị viên cấp	Nút Yêu cầu cấp thêm dẫn tới Đường dẫn yêu cầu cấp thêm. Để trống đường dẫn thì không có nút. Hợp với trường/doanh nghiệp trả tiền tập trung.
Không hiện kêu gọi nạp thêm	Không có nút nào

Người học nhận nhắc ở: ngay chỗ bị chặn, huy hiệu số dư trong chatbot, banner trên trang chủ học tập, thông báo trong hệ thống (thư điện tử chỉ gửi mặc định cho thông báo đã hết), và email nhắc ngày thứ 3 và thứ 10 sau cảnh báo đầu tiên nếu họ vẫn chưa nạp và có dùng AI.

Giá credits theo tính năng

AI → Giá credits theo tính năng. Mỗi dòng là một tính năng; cột Mã tính năng hiện mã kỹ thuật (vd chatbot.message, speech.pronunciation).

Ô	Ý nghĩa
Credits / lần gọi	Giá phẳng mỗi lượt
Credits / 1000 token đầu vào, Credits / 1000 token đầu ra	Giá theo độ dài; đắt bao nhiêu tính bấy nhiêu
Tối đa / lần gọi	Trần một lượt, kể cả khi tính theo token
Bật	Tắt thì tính năng ngừng; người học thấy "Tính năng AI này hiện đang tắt."

Dòng nào chưa từng được dùng có thể chưa có trong bảng; nó tự hiện với giá mặc định ở lượt dùng đầu tiên.

Một số tính năng tiêu ví người học (danh sách đầy đủ là bảng trên):

Tính năng	Mã
Tin nhắn chatbot (cả chatbot trong trang học lẫn trang Trợ giúp)	chatbot.message
Chấm tự động bài đọc / bài tập nộp	reading.grading, assignment.grading
Sinh câu hỏi luyện tập	practice_generation
Hoạt động hội thoại, phản biện code	dialogue.*, code_inspection.*
Trò chuyện lộ trình học	roadmap.chat
Chấm phát âm một bản ghi	speech.pronunciation — xem Giọng đọc và chấm phát âm
Hỏi kho tri thức (ví người hỏi), trợ lý soạn bài tri thức (ví người soạn)	knowledge.ask, knowledge.authoring — xem AI của kho tri thức

Không trừ ví ai: các tính năng soạn nội dung của quản trị (nhãn có chữ "(admin)" ở báo cáo), lập chỉ mục, sinh giọng đọc cho người soạn, và trợ lý tư vấn khoá học cho khách. Chúng chỉ ghi vào sổ chi phí của tổ chức.

Cấp credits tay

Cách	Ở đâu	Ghi chú
Cấp một số credits cho một người	Các ví AI → dòng của người đó → Cấp thêm credits	Nhập số và lý do
Cấp một gói cho một người	Các ví AI → Cấp một gói, hoặc Các gói credits AI → Tặng cho người dùng	Người nhận được thông báo "Bạn vừa được tặng…"
Cấp một gói cho cả nhóm	Các gói credits AI → Tặng cho nhóm người dùng	Chạy nền cho từng thành viên của nhóm; ví cập nhật sau ít giây
Cấp một gói cho cả lớp	Trang lớp học → Cấp Credits AI	Như trên, theo danh sách học viên của lớp

Credits cấp theo gói cộng cả Credits thưởng của gói, và vào phần đã mua (không hết hạn). Cấp theo gói không tạo đơn hàng.

Gói credits và bán gói

AI → Các gói credits AI: tên, mô tả, Số credits, Credits thưởng, Giá, Đơn vị tiền tệ, Đang hoạt động, Thứ tự hiển thị. Gói dùng được để tặng ngay cả khi tổ chức không bán gì.

Để bán:

1. Nhờ nhà cung cấp bật module AiCreditsCommerce (cần Ecommerce).
2. Tạo gói, bật Đang hoạt động. Gói tự xuất hiện thành một sản phẩm trong Thương mại điện tử → Sản phẩm — xem Đơn hàng và sản phẩm.
3. Ở khối Hạn mức credits AI, chọn Học viên tự mua gói credits.

Người học mua từ trang ví Credits AI → nút Mua thêm credits. Trang mua gói không có mục menu riêng.

Tắt bán gói

Tắt AiCreditsCommerce thì trang mua và mọi link thanh toán cũ của gói đều đóng. Nhưng sản phẩm đã đồng bộ vẫn hiện "Đang bán" trong Thương mại điện tử → Sản phẩm và vẫn chọn được khi giới hạn voucher theo sản phẩm. Muốn tránh nhầm, tắt Đang hoạt động của các gói trước khi tắt module.

Câu hỏi thường gặp

Học viên vừa nhập Excel không có credits. Xem khung Lớp đã nhập TRƯỚC khi bật credits tặng. Cách nhanh nhất: Cấp Credits AI trên trang lớp.

Đã chọn "Học viên tự mua gói credits" mà không ai thấy nút Nạp thêm. Tổ chức chưa bật bán gói (module AiCreditsCommerce). Ô Hình thức nạp thêm có ghi chú cảnh báo đúng trường hợp này.

Học viên bị chặn dù ví còn credits. Có thể họ chạm giới hạn theo phút (câu báo là "chờ", không phải "hết credit"), hoặc tính năng đó đang tắt ở Giá credits theo tính năng.

Muốn biết tổ chức đã tiêu bao nhiêu tiền thật cho AI. Đó là chi phí, không phải credits → Theo dõi chi phí AI.