メインコンテンツへスキップ

APIキー

すべてのAPIリクエストには、APIキーを使用した認証が必要です。Authorizationヘッダーにキーを含めてください:
Authorization: Bearer sk-your-api-key

APIキーの取得方法

  1. LemonDataダッシュボードにログインします
  2. API Keysセクションに移動します
  3. Create New Keyをクリックします
  4. キーに分かりやすい名前を付けます
  5. すぐにキーをコピーしてください。一度しか表示されません
セキュリティのベストプラクティス:
  • クライアント側のコードで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ヘッダーが必要です。

エラーレスポンス

ステータスコードタイプコード説明
401invalid_request_errorinvalid_api_keyAPIキーが不足しているか無効です
401invalid_request_errorexpired_api_keyAPIキーが失効しています
402insufficient_quotainsufficient_quotaアカウント残高が不足しています
402insufficient_quotaquota_exceededAPIキーの使用制限に達しました
エラーレスポンスの例:
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}