Bắt đầu
Xác thực
Bảo mật các yêu cầu TokenLab API của bạn bằng API key
API Key
Lời gọi mô hình và tài nguyên riêng tư cần khóa API. Các endpoint công khai như GET /v1/models và GET /v1/models/{model} không cần khóa. Truy vấn khám phá thành công không xác minh khóa có hoạt động; hãy theo hướng dẫn bắt đầu nhanh để gửi yêu cầu đến mô hình. Hãy dùng khóa đầy đủ đã lưu, không dùng tiền tố trong danh sách.
Đối với các endpoint tương thích OpenAI, gửi nó dưới dạng:
Authorization: Bearer sk-your-api-keyĐối với các yêu cầu /v1/messages tương thích Anthropic, bạn cũng có thể sử dụng:
x-api-key: sk-your-api-keyToken quản lý
Các endpoint của API quản lý sử dụng một loại token riêng:
Authorization: Bearer mt-your-management-tokenChỉ dùng token quản lý với /v1/management/*. Mở API → Tokens của không gian làm việc đã chọn để tạo hoặc thay thế token. Hãy lưu token đầy đủ ở nơi an toàn khi nó xuất hiện; token chỉ hiển thị một lần sau khi tạo hoặc thay thế.
Token quản lý không dùng được để gọi mô hình, và khóa API thông thường sk-... không dùng được cho API quản lý.
Lấy API Key của bạn
- Đăng nhập vào TokenLab Dashboard của bạn
- Mở API Keys
- Tạo một key mới
- Đặt cho nó một tên mang tính mô tả
- Sao chép ngay lập tức vì nó chỉ được hiển thị một lần
- Không bao giờ để lộ API key trong mã phía client
- Không bao giờ commit API key vào hệ thống quản lý phiên bản
- Sử dụng biến môi trường hoặc trình quản lý secret
- Luân phiên key định kỳ
- Xóa các key không sử dụng
Sử dụng API Key
Xem bắt đầu nhanh để thiết lập biến môi trường và gửi yêu cầu đầu tiên. Dùng SDK phù hợp với định dạng API và chỉ giữ khóa ở phía máy chủ.
Tính năng của API Key
Giới hạn sử dụng
Bạn có thể đặt giới hạn sử dụng cho từng API key:
| Thiết lập | Mô tả |
|---|---|
| No Limit | Key sử dụng số dư tài khoản của bạn mà không có hạn chế |
| Fixed Limit | Key ngừng hoạt động sau khi đạt đến số tiền được chỉ định |
Tiền tố của Key
Tất cả API key của TokenLab đều bắt đầu bằng sk-.
Phản hồi lỗi
| Mã trạng thái | Kiểu | Mã | Mô tả |
|---|---|---|---|
| 401 | invalid_api_key | invalid_api_key | Khóa API bị thiếu, không hợp lệ, không hoạt động hoặc đã bị thu hồi |
| 401 | expired_api_key | expired_api_key | Khóa API đã hết hạn |
| 402 | insufficient_balance | insufficient_balance | Số dư tài khoản không đủ |
| 402 | quota_exceeded | quota_exceeded | Đã đạt đến giới hạn sử dụng của API key |
Ví dụ:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}