APIキー
すべてのAPIリクエストには、APIキーを使用した認証が必要です。Authorizationヘッダーにキーを含めてください:
Authorization: Bearer sk-your-api-key
APIキーの取得方法
- LemonDataダッシュボードにログインします
- API Keysセクションに移動します
- Create New Keyをクリックします
- キーに分かりやすい名前を付けます
- すぐにキーをコピーしてください。一度しか表示されません
セキュリティのベストプラクティス:
- クライアント側のコードでAPIキーを公開しないでください
- バージョン管理システムにキーをコミットしないでください
- キーの保存には環境変数を使用してください
- 定期的にキーをローテーションしてください
- 未使用のキーは削除してください
APIキーの使用方法
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!"}]}'
APIキーの機能
使用制限
支出を管理するために、各APIキーに使用制限を設定できます:
| 設定 | 説明 |
|---|
| 制限なし | キーは制限なくアカウント残高を使用します |
| 固定制限 | 指定された金額に達するとキーは機能しなくなります |
キーのプレフィックス
すべてのLemonData APIキーはsk-プレフィックスで始まります。キーの形式は以下の通りです:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Anthropic APIの互換性
/v1/messagesエンドポイントでは、x-api-keyヘッダー(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!"}]
}'
x-api-keyヘッダーは、/v1/messagesおよび/v1/messages/count_tokensエンドポイントでのみサポートされています。その他のエンドポイントではAuthorization: Bearerヘッダーが必要です。
エラーレスポンス
| ステータスコード | タイプ | コード | 説明 |
|---|
| 401 | invalid_request_error | invalid_api_key | APIキーが不足しているか無効です |
| 401 | invalid_request_error | expired_api_key | APIキーが失効しています |
| 402 | insufficient_quota | insufficient_quota | アカウント残高が不足しています |
| 402 | insufficient_quota | quota_exceeded | APIキーの使用制限に達しました |
エラーレスポンスの例:
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}