Platform

Anahtar sınırları ve kuralları

Her API anahtarını amacına göre sınırlandırın: ne kadar harcayabileceğini, istek hızını, hangi modelleri kullanabileceğini, nereden ve ne kadar süreyle erişebileceğini belirleyin. Bu kuralları anahtar oluştururken veya istediğiniz zaman API anahtarları → Düzenle bölümünden ayarlayın.

Kurallar

KuralSınır aşılıncaHata
Aylık bütçe (USD)İstekler bir sonraki aya kadar reddedilir (UTC)402 key_budget_exceeded
Günlük bütçe (USD)İstekler UTC gece yarısına kadar reddedilir402 key_daily_budget_exceeded
Hız sınırı (dakika başına istek)İstekler kısa süreliğine retry-after ile reddedilir429 rate_limit_exceeded
Son kullanma tarihiAnahtar çalışmayı durdurur401 expired_api_key
İzin verilen modellerDiğer modeller reddedilir403 model_not_allowed
İzin verilen IP adresleriDiğer adreslerden gelen istekler reddedilir403 ip_not_allowed

Reddedilen istekler asla ücretlendirilmez. Bütçe hesabına, anahtarın devam eden istekleri için ayrılan tutarlar da dahildir (bkz. Faturalandırma), bu yüzden anahtarın bütçesini aşabilecek bir istek başlamadan reddedilir, yanıt üretilirken bütçeye ulaşılırsa yanıt o noktada bütçe hatasıyla durur. Değişiklikler her yerde 15 saniye içinde uygulanır. Çalışma alanı bakiyeniz tüm anahtarlar için geçerlidir: bakiye bir isteği karşılayamazsa istek 402 insufficient_quota hatası alır.

İzin verilen modeller

Metin, görsel veya video modellerinden istediklerinizi seçin. Örneğin yalnızca gpt-6-sol ve gemini-3.7-flash ile sınırlandırılmış bir anahtar başka hiçbir modeli çağıramaz, akıllı yönlendirme de yalnızca bu listedeki alternatifleri kullanır. Zurelay Auto için izin verirseniz anahtar, Auto tarafından seçilen herhangi bir modeli kullanabilir.

İzin verilen IP adresleri

Tekil adresler ve CIDR aralıkları, IPv4 ve IPv6, anahtar başına en fazla 100 kayıt. Kontrol edilen adres, isteğinizin internete çıktığı adrestir (proxy veya NAT arkasındaysa proxy adresidir).

Örnekler
203.0.113.7 one address
198.51.100.0/24 a range of 256 addresses
2001:db8::/32 an IPv6 range
Sunucusuz platformlar ve bazı bulut hizmetleri, istekleri değişen adreslerden gönderir. Sağlayıcınızın dışa giden trafik için yayımladığı bir aralığı kullanın veya bu anahtarlarda IP kısıtlaması koymadan diğer kurallara güvenin.

Pratikte bütçeler

  • Her uygulama veya ortama ayrı bir anahtar ve bütçe verin, böylece kontrolden çıkan tek bir döngü bakiyenizi tüketemez.
  • Günlük bütçe bir hatayı aynı gün yakalar; aylık bütçe ise faturayı sınırlar.
  • API anahtarları sayfası, her anahtarın bugünkü ve bu ayki harcamasını bütçelerinin yanında gösterir.

Sorunuz mu var, yoksa bir şey mi eksik? Destek ekibimize sorun, genellikle bir dakika içinde e-postayla yanıtlayalım.