API Key
API Key (khóa API) là "tấm vé thông hành" để gọi model của trang này. Phần này trình bày toàn bộ nội dung từ tạo, quản lý đến bảo vệ khóa.
Khái niệm cơ bản
- Mỗi khóa gắn với một nhóm (dịch vụ), nhóm quyết định bạn có thể gọi những model nào
- Định dạng khóa thường là
sk-xxxxxxxx - Khóa chỉ hiển thị một lần khi tạo, nhất định phải lưu lại ngay
Đọc theo thứ tự
| Tài liệu | Nội dung |
|---|---|
| Tạo API Key đầu tiên | Tạo lần đầu, cấu hình bắt buộc, lưu ngay |
| Quản lý khóa: sao chép / vô hiệu hóa / xóa | Quản lý hằng ngày, xử lý khi lộ, thực hành tốt nhất |
| Hạn mức khóa, thời hạn và giới hạn IP | Đặt giới hạn cho thiết bị dùng chung / mục đích tạm thời |
Cách làm được khuyến nghị
- Tách Key theo mục đích: mỗi thiết bị, mỗi client một khóa, đừng dùng chung
- Tạo xong là kiểm tra ngay: dùng "kiểm tra lần gọi đầu tiên" để xác minh nhóm/model/số dư/địa chỉ
- Lộ là dừng: vô hiệu hóa hoặc xóa tạo lại ngay, đừng chờ
- Dùng chung thì đặt giới hạn: đặt hạn mức và giới hạn tốc độ cho Key chia sẻ người khác dùng
Gặp vấn đề?
- 401/403 → Lỗi xác thực và quyền
- Báo số dư không đủ → Kiểm tra lỗi hạn mức
- Model 404 → Kiểm tra model và giới hạn tốc độ