Skip to content

API Anahtarları ve Kota ​

Bu sayfa anahtarların nasıl organize edildiğini, kotaların ve hız limitlerinin nasıl çalıştığını açıklar.

Anahtarlar ve gruplar ​

Her API anahtarı bir gruba bağlıdır. Grup, anahtarın yetkilerini belirler:

  • Erişebileceği modeller — Grup yalnızca belirli model kümelerine erişebilir.
  • Kota — Toplam harcanabilir bakiye/kullanım.
  • Hız limitleri — Dakikada istek (RPM) ve token (TPM) sınırları.
  • IP kısıtlamaları (opsiyonel) — Anahtar yalnızca belirli IP aralıklarından kullanılabilir.

Bu yapı sayesinde bir ekipte farklı kullanıcı/uygulamalara, farklı kotalı ayrı anahtarlar verebilirsiniz.

Hız limitleri ​

Her yanıtta hız limiti durumunuzu gösteren başlıklar döner:

X-RateLimit-Limit-Requests: 1000
X-RateLimit-Remaining-Requests: 987
X-RateLimit-Reset-Requests: 1716200600
X-RateLimit-Limit-Tokens: 200000
X-RateLimit-Remaining-Tokens: 194300
X-RateLimit-Reset-Tokens: 1716200600
BaşlıkAnlamı
*-Limit-RequestsPeriyot başına izin verilen istek sayısı
*-Remaining-RequestsKalan istek hakkı
*-Reset-RequestsSayaçların sıfırlanacağı zaman (Unix saniye)
*-Limit-Tokens / *-Remaining-Tokens / *-Reset-TokensAynısının token bazlı karşılığı

Limiti aşarsanız 429 Too Many Requests alırsınız. Bu durumda kısa bir süre bekleyip yeniden deneyin (örnek olarak Reset zamanına kadar).

Kullanımı sorgulama ​

Mevcut kotanızı ve harcamanızı programatik olarak görebilirsiniz:

bash
# Kalan kota / abonelik
curl https://app.qevron.ai/v1/dashboard/billing/subscription \
  -H "Authorization: Bearer $QEVRON_API_KEY"

# Toplam kullanım
curl https://app.qevron.ai/v1/dashboard/billing/usage \
  -H "Authorization: Bearer $QEVRON_API_KEY"

Ayrıntı: Faturalama / Kullanım API.

Kullanım nasıl ölçülür? ​

Kullanım token bazlıdır. Her yanıttaki usage alanı harcamanızı gösterir:

json
"usage": {
  "prompt_tokens": 18,
  "completion_tokens": 16,
  "total_tokens": 34
}
  • prompt_tokens — Gönderdiğiniz girdinin token sayısı.
  • completion_tokens — Modelin ürettiği yanıtın token sayısı.
  • total_tokens — Toplam.

Akış (streaming) kullanırken token bilgisini almak için isteğe stream_options: { "include_usage": true } ekleyin (bkz. Akış).

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