跳轉到主要內容

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

  1. 登入您的 LemonData Dashboard
  2. 開啟 API Keys
  3. 建立新的 key
  4. 為它指定一個具描述性的名稱
  5. 立即複製它,因為它只會顯示一次
  • 絕對不要在 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 設定使用限制:
SettingDescription
No Limitkey 使用您的帳戶餘額,沒有任何限制
Fixed Limitkey 在達到指定金額後將停止運作

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 CodeTypeCodeDescription
401invalid_request_errorinvalid_api_keyAPI key 缺失或無效
401invalid_request_errorexpired_api_keyAPI key 已被撤銷
402insufficient_quotainsufficient_quota帳戶餘額不足
402insufficient_quotaquota_exceeded已達到 API key 使用限制
範例:
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}