API Key
Tất cả các yêu cầu LemonData API đều yêu cầu một API key.
Đối với các endpoint tương thích OpenAI, gửi nó dưới dạng:
Authorization: Bearer sk-your-api-key
/v1/messages tương thích Anthropic, bạn cũng có thể sử dụng:
x-api-key: sk-your-api-key
Lấy API Key của bạn
- Đăng nhập vào LemonData 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
curl https://api.lemondata.cc/v1/responses \
-H "Authorization: Bearer $LEMONDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"input": "Hello!"
}'
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:
| Setting | Description |
|---|
| 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 LemonData đều bắt đầu bằng sk-.
Tương thích Anthropic
Đối với endpoint /v1/messages, header theo kiểu Anthropic hoạt động như mong đợi:
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-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
Sử dụng Authorization: Bearer ... cho các endpoint tương thích OpenAI như /v1/responses, /v1/chat/completions, /v1/models, và hầu hết các route LemonData khác.
Phản hồi lỗi
| Status Code | Type | Code | Description |
|---|
| 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"
}
}
