API Key
Tất cả các yêu cầu API đều yêu cầu xác thực bằng API key. Hãy bao gồm key của bạn trong header Authorization:
Authorization: Bearer sk-your-api-key
Cách lấy API Key của bạn
- Đăng nhập vào LemonData Dashboard
- Đi tới phần API Keys
- Nhấp vào Create New Key
- Đặt tên mô tả cho key của bạn
- Sao chép key ngay lập tức - nó chỉ được hiển thị một lần duy nhất
Thực hành Bảo mật Tốt nhất:
- Không bao giờ để lộ API key trong mã nguồn phía client
- Không commit key lên hệ thống quản lý phiên bản (version control)
- Sử dụng biến môi trường để lưu trữ key
- Thay đổi (rotate) key định kỳ
- Xóa các key không sử dụng
Sử dụng API Key
curl https://api.lemondata.cc/v1/chat/completions \
-H "Authorization: Bearer $LEMONDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello!"}]}'
Các tính năng của API Key
Giới hạn sử dụng
Bạn có thể thiết lập giới hạn sử dụng cho mỗi API key để kiểm soát chi tiêu:
| Cài đặt | 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 sẽ ngừng hoạt động sau khi đạt đến số tiền được chỉ định |
Tiền tố Key
Tất cả các API key của LemonData đều bắt đầu bằng tiền tố sk-. Định dạng key là:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Khả năng tương thích với Anthropic API
Đối với endpoint /v1/messages, bạn có thể sử dụng header x-api-key (tương thích với Anthropic SDK):
curl https://api.lemondata.cc/v1/messages \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
Header x-api-key chỉ được hỗ trợ trên các endpoint /v1/messages và /v1/messages/count_tokens. Các endpoint khác yêu cầu header Authorization: Bearer.
Phản hồi lỗi
| Mã trạng thái | Loại | Mã | Mô tả |
|---|
| 401 | invalid_request_error | invalid_api_key | Thiếu hoặc API key không hợp lệ |
| 401 | invalid_request_error | expired_api_key | API key đã bị thu hồi |
| 402 | insufficient_quota | insufficient_quota | Số dư tài khoản không đủ |
| 402 | insufficient_quota | quota_exceeded | Đã đạt đến giới hạn sử dụng của API key |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
