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 を作成します
- わかりやすい名前を付けます
- 表示されるのは一度だけなので、すぐにコピーします
- API key をクライアントサイドのコードに決して公開しないでください
- API key をバージョン管理に決してコミットしないでください
- 環境変数または secret manager を使用してください
- 定期的に key をローテーションしてください
- 使用していない key は削除してください
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!"
}'
API Key の機能
使用制限
各 API key に使用制限を設定できます:
| Setting | Description |
|---|
| No Limit | 制限なしで アカウント balance を使用して key が動作します |
| Fixed Limit | 指定した金額に達すると key は動作を停止します |
Key Prefix
すべての LemonData API key は sk- で始まります。
Anthropic 互換性
/v1/messages エンドポイントでは、Anthropic スタイルのヘッダーは想定どおりに動作します:
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!"}]
}'
/v1/responses、/v1/chat/completions、/v1/models、およびその他のほとんどの LemonData ルートなどの OpenAI 互換エンドポイントでは、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 | アカウント balance が不足しています |
| 402 | insufficient_quota | quota_exceeded | API key の使用制限に達しました |
例:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}