Kimlik Doğrulama

Qevron'a yapılan her istek bir API anahtarı ile doğrulanır. Bu sayfa anahtarın nasıl alınacağını ve gönderileceğini anlatır.

API anahtarı nedir?

API anahtarı, isteğin sizin adınıza yapıldığını kanıtlayan gizli bir metindir ve sk- ile başlar. Her anahtar bir gruba bağlıdır; grup, anahtarın hangi modellere erişebileceğini ve kotasını belirler (bkz. API Anahtarları ve Kota).

Anahtar oluşturma

1. Qevron yönetim paneline giriş yapın.
2. Anahtarlar / Tokens bölümüne gidin.
3. Yeni anahtar oluştur deyin; bir ad verin ve (varsa) erişebileceği model kümesi / grubu seçin.
4. Üretilen sk-... değerini hemen kopyalayın — anahtar yalnızca bir kez tam olarak gösterilir.
5. Anahtarı bir ortam değişkeninde saklayın (aşağıya bakın).

TIP

Farklı uygulamalar/ortamlar (geliştirme, üretim) için ayrı anahtarlar oluşturun. Böylece birini iptal etmek diğerlerini etkilemez.

Anahtarı ortam değişkeninde saklama

macOS / Linux

export QEVRON_API_KEY="sk-..."
# kalıcı olması için ~/.bashrc veya ~/.zshrc dosyanıza ekleyin

Windows (PowerShell)

$Env:QEVRON_API_KEY = "sk-..."
# kalıcı: [Environment]::SetEnvironmentVariable("QEVRON_API_KEY","sk-...","User")

.env dosyası

# .env  — bu dosyayı .gitignore'a EKLEYİN
QEVRON_API_KEY=sk-...

Kodda okuma: Python os.environ["QEVRON_API_KEY"], Node.js process.env.QEVRON_API_KEY.

Anahtarı gönderme

Standart yöntem Authorization başlığında Bearer öneki ile göndermektir:

Authorization: Bearer sk-aBcD1234...

Qevron, uyumluluk için birkaç alternatif başlığı da kabul eder:

Başlık	Biçim	Kullanım
Authorization	Bearer sk-...	Önerilen. OpenAI/Anthropic standardı.
Authorization	sk-...	Bearer öneki olmadan da çalışır.
x-api-key	sk-...	Anthropic SDK uyumluluğu.
x-goog-api-key	sk-...	Google Gemini SDK uyumluluğu.

TIP

Çoğu SDK (Python/JS openai, anthropic) doğru başlığı sizin için otomatik gönderir; yalnızca anahtarı ve base_url'i ayarlamanız yeterlidir.

Belirli bir sağlayıcıyı seçme (opsiyonel)

Varsayılan olarak Qevron, istediğiniz model için en uygun kanalı kendisi seçer. Belirli bir kanalı zorlamak isterseniz Qevron-Channel başlığını ekleyin:

curl https://app.qevron.ai/v1/chat/completions \
  -H "Authorization: Bearer $QEVRON_API_KEY" \
  -H "Qevron-Channel: openai" \
  -H "Content-Type: application/json" \
  -d '{ "model": "verinova", "messages": [{"role":"user","content":"selam"}] }'

Değer, kanalın adı veya sayısal kimliği olabilir.

Yanıt başlıkları

Başarılı isteklerde Qevron bazı bilgilendirici başlıklar döndürür:

Başlık	Anlamı
Group	İsteğin işlendiği grubun kimliği.
X-RateLimit-Limit-Requests	Periyot başına izin verilen istek sayısı.
X-RateLimit-Remaining-Requests	Kalan istek hakkı.
X-RateLimit-Reset-Requests	Limitin sıfırlanacağı zaman (Unix).
X-RateLimit-Limit-Tokens / -Remaining-Tokens / -Reset-Tokens	Token bazlı limitler.

Güvenlik

WARNING

• Anahtarı istemci tarafı (tarayıcı, mobil uygulama) koduna gömmeyin — herkes görebilir. İstekleri kendi sunucunuz üzerinden geçirin.
• Anahtarı ortam değişkeninde saklayın; depoya commit etmeyin.
• Sızdığından şüphelenirseniz panelden anahtarı iptal edip yenisini oluşturun.

Geçersiz veya eksik anahtar 401 Unauthorized döndürür. Ayrıntılar için Hatalar sayfasına bakın.