Skip to content

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 ​

bash
export QEVRON_API_KEY="sk-..."
# kalıcı olması için ~/.bashrc veya ~/.zshrc dosyanıza ekleyin
powershell
$Env:QEVRON_API_KEY = "sk-..."
# kalıcı: [Environment]::SetEnvironmentVariable("QEVRON_API_KEY","sk-...","User")
bash
# .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:

bash
Authorization: Bearer sk-aBcD1234...

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

BaşlıkBiçimKullanım
AuthorizationBearer sk-...Önerilen. OpenAI/Anthropic standardı.
Authorizationsk-...Bearer öneki olmadan da çalışır.
x-api-keysk-...Anthropic SDK uyumluluğu.
x-goog-api-keysk-...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:

bash
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ıkAnlamı
Groupİsteğin işlendiği grubun kimliği.
X-RateLimit-Limit-RequestsPeriyot başına izin verilen istek sayısı.
X-RateLimit-Remaining-RequestsKalan istek hakkı.
X-RateLimit-Reset-RequestsLimitin sıfırlanacağı zaman (Unix).
X-RateLimit-Limit-Tokens / -Remaining-Tokens / -Reset-TokensToken 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.

Qevron — AI gateway. Arpanet / OpenAI / Anthropic / Gemini uyumlu.