API Anahtarları
Tüm API istekleri, bir API anahtarı kullanılarak kimlik doğrulaması gerektirir. Anahtarınızı Authorization başlığına (header) ekleyin:
Authorization: Bearer sk-your-api-key
API Anahtarınızı Alma
- LemonData Dashboard panelinizde oturum açın
- API Keys bölümüne gidin
- Create New Key düğmesine tıklayın
- Anahtarınıza açıklayıcı bir ad verin
- Anahtarı hemen kopyalayın - yalnızca bir kez gösterilir
Güvenlik En İyi Uygulamaları:
- API anahtarlarını asla istemci tarafı (client-side) kodunda açıkta bırakmayın
- Anahtarları sürüm kontrol sistemlerine göndermeyin
- Anahtarları saklamak için ortam değişkenlerini (environment variables) kullanın
- Anahtarları periyodik olarak yenileyin
- Kullanılmayan anahtarları silin
API Anahtarlarını Kullanma
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 Anahtarı Özellikleri
Kullanım Limitleri
Harcamaları kontrol etmek için her API anahtarı üzerinde bir kullanım limiti belirleyebilirsiniz:
| Ayar | Açıklama |
|---|
| Limit Yok | Anahtar, hesap bakiyenizi kısıtlama olmaksızın kullanır |
| Sabit Limit | Anahtar, belirtilen tutara ulaştıktan sonra çalışmayı durdurur |
Anahtar Öneki
Tüm LemonData API anahtarları sk- öneki ile başlar. Anahtar formatı şöyledir:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Anthropic API Uyumluluğu
/v1/messages uç noktası (endpoint) için x-api-key başlığını (Anthropic SDK uyumlu) kullanabilirsiniz:
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 başlığı yalnızca /v1/messages ve /v1/messages/count_tokens uç noktalarında desteklenir. Diğer uç noktalar Authorization: Bearer başlığını gerektirir.
Hata Yanıtları
| Durum Kodu | Tür | Kod | Açıklama |
|---|
| 401 | invalid_request_error | invalid_api_key | Eksik veya geçersiz API anahtarı |
| 401 | invalid_request_error | expired_api_key | API anahtarı iptal edilmiş |
| 402 | insufficient_quota | insufficient_quota | Hesap bakiyesi yetersiz |
| 402 | insufficient_quota | quota_exceeded | API anahtarı kullanım limitine ulaşıldı |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
