⭐ Nền tảng Kandes AI Studio & Web (Ưu tiên hàng đầu)
Hướng dẫn Tạo, Cấu hình Hạn mức & Quản lý Khóa API
Đọc ~5 phút
Khóa API (API Key) là gì?
Khóa API là chuỗi ký tự bí mật bắt đầu bằng tiền tố
ks-.... Đây là chiếc "chìa khóa" để các công cụ bên ngoài (như Cursor, Claude Code, Cline, Python script) chứng minh quyền truy cập và trừ tiền từ ví của bạn.1
Quy trình tạo khóa API mới
Thao tác nhanhTạo khóa mới trong vòng chưa đầy 20 giây.
- Mở mục Bảng điều khiển → Khóa API.
- Bấm vào nút Tạo khóa mới ở góc trên bên phải.
- Đặt tên gợi nhớ: Đặt tên mô tả nơi bạn sẽ dán khóa này (ví dụ:
cursor-laptop,claude-code-macbook,project-website). - Hạn mức chi tiêu:
- Hạn mức ngày (Daily Limit): Số tiền tối đa khóa được tiêu trong 1 ngày (để trống = không giới hạn). Khuyên dùng: đặt 50.000 ₫ hoặc 100.000 ₫ cho các khóa test.
- Hạn mức tháng (Monthly Limit): Số tiền tối đa khóa được tiêu trong 1 tháng.
- Bấm nút Tạo khóa.
- Một bảng thông báo sẽ hiện ra chứa mã khóa dạng
ks-xxxxxxxxxxxxxxxxxxxxxxxx. Bấm nút Sao chép và lưu vào nơi an toàn.
Mã khóa chỉ xuất hiện 1 lần duy nhất
Vì lý do an ninh, hệ thống Kandes chỉ lưu chuỗi băm (hash) mật mã của khóa. Khi bạn đóng cửa sổ lại, bạn sẽ không thể xem lại toàn bộ chuỗi ký tự này. Nếu làm mất khóa, bạn chỉ cần xóa khóa cũ và tạo khóa mới.
2
Cơ chế Ngắt khẩn cấp (Kill Switch)
An toàn tuyệt đốiVô hiệu hóa khóa ngay lập tức khi nghi ngờ lộ lọt mã.
Nếu bạn vô tình đẩy (commit) file cấu hình chứa API key lên GitHub công khai hoặc chia sẻ màn hình làm lộ key:
- Mở danh sách Khóa API.
- Tìm khóa đó và bấm vào Công tắc Trạng thái (Nút nguồn) để chuyển sang màu xám (Tắt / Disabled).
- Ngay lập tức, cổng Kandes Gateway sẽ từ chối mọi yêu cầu gửi đến từ khóa này với lỗi
401 Unauthorized. Kẻ xấu không thể tiêu một đồng nào trong ví của bạn. - Sau đó bạn có thể bấm icon Thùng rác để xóa vĩnh viễn khóa đó.
3
Xem thống kê sử dụng riêng theo từng khóa
Minh bạchPhân tích công cụ nào đang tiêu tốn nhiều chi phí nhất.
Tại danh sách khóa, mỗi dòng đều hiển thị rõ ràng:
- Tổng lượt gọi: Tổng số request mà khóa đó đã thực hiện.
- Chi phí đã tiêu: Số tiền khóa đó đã tiêu thụ từ ngày tạo.
- Lần gọi gần nhất: Thời gian gần nhất khóa phát sinh yêu cầu.
- Nút Thử nghiệm cURL: Mở sẵn mẫu lệnh cURL chứa khóa đó để bạn copy chạy thử trong terminal.