API Keys
所有 LemonData API 請求都需要 API key。
對於 OpenAI 相容端點,請這樣傳送:
Authorization: Bearer sk-your-api-key
對於與 Anthropic 相容的 /v1/messages 請求,您也可以使用:
x-api-key: sk-your-api-key
取得您的 API Key
- 登入您的 LemonData Dashboard
- 開啟 API Keys
- 建立新的 key
- 為它指定一個具描述性的名稱
- 立即複製它,因為它只會顯示一次
- 絕對不要在 client-side 程式碼中暴露 API keys
- 絕對不要將 API keys 提交到版本控制系統
- 使用環境變數或 secret manager
- 定期輪替 keys
- 刪除未使用的 keys
使用 API Keys
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!"
}'
API Key 功能
使用限制
您可以為每個 API key 設定使用限制:
| Setting | Description |
|---|
| No Limit | key 使用您的帳戶餘額,沒有任何限制 |
| Fixed Limit | key 在達到指定金額後將停止運作 |
Key Prefix
所有 LemonData API keys 都以 sk- 開頭。
Anthropic 相容性
對於 /v1/messages 端點,Anthropic 風格的 header 可如預期運作:
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!"}]
}'
對於 OpenAI 相容端點,例如 /v1/responses、/v1/chat/completions、/v1/models 以及大多數其他 LemonData 路由,請使用 Authorization: Bearer ...。
錯誤回應
| Status Code | Type | Code | Description |
|---|
| 401 | invalid_request_error | invalid_api_key | API key 缺失或無效 |
| 401 | invalid_request_error | expired_api_key | API key 已被撤銷 |
| 402 | insufficient_quota | insufficient_quota | 帳戶餘額不足 |
| 402 | insufficient_quota | quota_exceeded | 已達到 API key 使用限制 |
範例:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}