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ık	Anlamı
*-Limit-Requests	Periyot başına izin verilen istek sayısı
*-Remaining-Requests	Kalan istek hakkı
*-Reset-Requests	Sayaçların sıfırlanacağı zaman (Unix saniye)
*-Limit-Tokens / *-Remaining-Tokens / *-Reset-Tokens	Aynı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:

# 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:

"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ış).