Tạo API key đầu tiên
API key là "giấy thông hành" để bạn gọi model. Khuyến nghị tách tạo theo mục đích sử dụng (mỗi thiết bị, mỗi client một khóa), thuận tiện quản lý, giới hạn hạn mức và cắt lỗ.
Các bước tạo
- Đăng nhập bảng điều khiển, vào trang API Keys
- Nhấn Create New API Key
- Điền cấu hình:
| Mục cấu hình | Giải thích | Khuyến nghị |
|---|---|---|
| Tên | Định danh mục đích sử dụng | Ví dụ laptop-main, codex-cli, cherry-studio |
| Nhóm đã gán | Nhóm dịch vụ mà khóa này có thể gọi | Chọn theo model bạn muốn dùng |
| Giới hạn hạn mức | Giới hạn trên tổng hạn mức gọi (tùy chọn) | Nên đặt cho thiết bị dùng chung |
| Giới hạn tốc độ | Giới hạn trên số yêu cầu mỗi phút (tùy chọn) | Chống lạm dụng |
| Thời gian hết hạn | Tự động vô hiệu khi hết hạn (tùy chọn) | Nên đặt cho mục đích tạm thời |
- Nhấp vào «Tạo»
Quan trọng: lưu khóa ngay lập tức
WARNING
Khóa chỉ hiển thị một lần khi tạo, sau khi đóng trang sẽ không thể xem lại
- Sau khi tạo, sao chép ngay và lưu vào trình quản lý mật khẩu
- Nếu chưa lưu đã đóng trang → xóa khóa đó, tạo lại một khóa mới
Định dạng khóa
- Khóa nền tảng thường bắt đầu bằng
sk-(ví dụsk-xxxxxxxx) - Trong một số trường hợp là
s2a-, đều là định dạng bình thường
Sau khi tạo, kiểm tra một lần trước
Nên dùng chức năng «Kiểm tra lần gọi đầu tiên» ở trang khóa để xác minh một lần:
- ✅ Khóa có hợp lệ không
- ✅ Nhóm đã liên kết có dùng được không
- ✅ Model đã chọn có tồn tại không
- ✅ Số dư/hạn mức đăng ký có đủ không
- ✅ Địa chỉ API có đúng không
Sau khi tất cả đều đạt, bạn có thể vào Cấu hình client.
