Sıklık sınırları, belirli bir zaman aralığında Gemini API'ye gönderebileceğiniz istek sayısını düzenler. Bu sınırlar, adil kullanımı sürdürmeye, kötüye kullanıma karşı korumaya ve tüm kullanıcılar için sistem performansını korumaya yardımcı olur.
AI Studio'da etkin kullanım sınırlarınızı görüntüleme
Sıklık sınırlarının işleyiş şekli
Sıklık sınırları genellikle üç boyutta ölçülür:
- Dakikada gönderilen istek sayısı (RPM)
- Dakika başına jeton sayısı (giriş) (TPM)
- Günlük istek sayısı (RPD)
Kullanımınız her sınıra göre değerlendirilir ve herhangi bir sınırı aşmanız durumunda sıklık sınırlaması hatası tetiklenir. Örneğin, RPM sınırınız 20 ise bir dakika içinde 21 istek gönderdiğinizde TPM veya diğer sınırlarınızı aşmamış olsanız bile hata alırsınız.
Sıklık sınırları API anahtarı başına değil, proje başına uygulanır. Günlük istek sayısı (RPD) kotaları, Pasifik Saati'ne göre gece yarısında sıfırlanır.
Sınırlar, kullanılan modele göre değişir ve bazı sınırlar yalnızca belirli modeller için geçerlidir. Örneğin, dakikada görüntü sayısı (IPM) yalnızca görüntü oluşturabilen modeller (Nano Banana) için hesaplanır ancak kavramsal olarak TPM'ye benzer. Diğer modellerde günlük jeton sınırı (TPD) olabilir.
Deneysel ve önizleme modellerinde kullanım sınırları daha kısıtlıdır.
Harcamaya dayalı sıklık sınırları
Gemini API, dakika başına istek (RPM) ve dakika başına jeton (TPM) sınırlarına ek olarak beklenmedik ücretlere karşı koruma sağlamak için harcamaya dayalı sıklık sınırları uygular. Bu sınırların hesabınız için geçerli olup olmadığı, faturalandırma geçmişinize ve kullanım katmanınıza bağlıdır.
Aşağıdaki tabloda, her kullanım katmanı için harcamaya dayalı sıklık sınırları gösterilmektedir. Bu sınırlar, 10 dakikalık bir süre içinde değerlendirilir. Bu sınırların hesabınız için geçerli olup olmadığı, faturalandırma geçmişinize ve hesabınızın durumuna bağlıdır.
| Kullanım katmanı | Harcama sıklık sınırlaması (10 dakikada bir) |
|---|---|
| Ücretsiz | Yok |
| 1. Katman | 10 Hong Kong doları |
| 2. Katman | 50 Hong Kong doları |
| 3. Katman | 200 ABD doları |
Harcamaya dayalı bir sıklık sınırlamasına ulaşırsanız API, 429 RESOURCE_EXHAUSTED hatası döndürür. Bu sorunu çözmek için:
- Kısa bir süre sonra bekleyip tekrar deneyin.
- Örneğin, daha küçük bağlam pencereleri veya daha kısa çıktılar kullanarak pahalı isteklerin oranını azaltın.
- Normal kullanım sırasında bu sınıra sürekli olarak ulaşıyorsanız sıklık sınırlaması artışı isteğinde bulunun.
Kullanım katmanları
Sıklık sınırları, projenin kullanım katmanına bağlıdır. API kullanımınız ve harcamanız arttıkça, hız sınırları artırılmış daha yüksek bir katmana otomatik olarak yükseltilirsiniz.
2. ve 3. katmanların koşulları, projenize bağlı faturalandırma hesabında Google Cloud hizmetlerine (Gemini API dahil ancak bununla sınırlı olmamak üzere) yapılan toplam harcamaya göre belirlenir.
| Kullanım katmanı | Eleme | Faturalandırma katmanı sınırı |
|---|---|---|
| Ücretsiz | Etkin proje veya ücretsiz deneme | Yok |
| 1. Katman | Etkin bir faturalandırma hesabı oluşturma ve bağlama | 250 ABD Doları |
| 2. Katman | 100 ABD doları ödendi + ilk başarılı ödemeden sonraki 3 gün | 2.000 ABD doları |
| 3. Katman | 1.000 ABD doları ödeme yapıldıktan sonra + ilk başarılı ödemeden itibaren 30 gün | 20.000 - 100.000 ABD doları+ |
Belirtilen uygunluk ölçütlerini karşılamak genellikle onay için yeterli olsa da nadir durumlarda, inceleme süreci sırasında belirlenen diğer faktörlere bağlı olarak yükseltme isteği reddedilebilir.
Bu sistem, Gemini API platformunun tüm kullanıcılar için güvenliğini ve bütünlüğünü korumaya yardımcı olur.
Gemini API kullanım sınırları
Sıklık sınırları, kullanım katmanınız gibi çeşitli faktörlere bağlıdır ve Google AI Studio'da görüntülenebilir. Zaman içinde katmanınız ve hesap durumunuz değiştikçe sıklık sınırlarınız otomatik olarak güncellenir.
AI Studio'da etkin kullanım sınırlarınızı görüntüleme
Belirtilen sıklık sınırlamaları garanti edilmez ve gerçek kapasite değişiklik gösterebilir.
Öncelikli çıkarım sıklık sınırları
Öncelikli tüketim, genel etkileşimli trafik sıklık sınırlarına dahil edilse de kendi sıklık sınırlarına sahiptir. Varsayılan sıklık sınırları: Her model ve katman için standart sıklık sınırının 0,3 katı
Batch API sıklık sınırları
Batch API istekleri, toplu olmayan API çağrılarından ayrı olarak kendi sıklık sınırlarına tabidir.
- Eşzamanlı toplu istekler: 100
- Giriş dosyası boyutu sınırı: 2 GB
- Dosya depolama alanı sınırı: 20 GB
- Model başına sıraya alınan jeton sayısı: Sıraya alınan toplu jeton sayısı tablosunda, belirli bir model için tüm etkin toplu işlerinizde toplu işleme için sıraya alınabilecek maksimum jeton sayısı listelenir.
Katman 1
| Model | Sıraya alınan toplu jetonlar | |||
|---|---|---|---|---|
| Metin çıkışı modelleri | ||||
| Gemini 4 Argon | 5.000.000 | |||
| Gemini 3.1 Pro Preview | 5.000.000 | |||
| Gemini 3.5 Flash-Lite | 10.000.000 | |||
| Gemini 3.8 Flash | 3.000.000 | |||
| Gemini 3.1 Flash Lite | 10.000.000 | |||
| Gemini 3.1 Flash Lite Önizlemesi | 10.000.000 | |||
| Gemini 3.6 Flash | 3.000.000 | |||
| Gemini 2.5 Pro | 5.000.000 | |||
| Gemini 2.5 Pro TTS | 25.000 | |||
| Gemini 2.5 Flash | 3.000.000 | |||
| Gemini 2.5 Flash Preview | 3.000.000 | |||
| Gemini 2.5 Flash Image Önizlemesi | 3.000.000 | |||
| Gemini 2.5 Flash TTS | 100.000 | |||
| Gemini 2.5 Flash Lite | 10.000.000 | |||
| Gemini 2.5 Flash Lite Önizlemesi | 10.000.000 | |||
| Gemini 2.0 Flash | 10.000.000 | |||
| Gemini 2.0 Flash Image | 3.000.000 | |||
| Gemini 2.0 Flash Lite | 10.000.000 | |||
| Çok formatlı üretim modelleri | ||||
| Gemini 3.1 Flash Image Preview 🍌 | 1.000.000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 2.000.000 | |||
| Gemini 3 Pro Görüntü Önizleme 🍌 | 2.000.000 | |||
| Yerleştirme modelleri | ||||
| Gemini Embedding | 500.000 | |||
Katman 2
| Model | Sıraya alınan toplu jetonlar | |||
|---|---|---|---|---|
| Metin çıkışı modelleri | ||||
| Gemini 4 Argon | 500.000.000 | |||
| Gemini 3.1 Pro Önizlemesi | 500.000.000 | |||
| Gemini 3.5 Flash-Lite | 500.000.000 | |||
| Gemini 3.1 Flash Lite | 500.000.000 | |||
| Gemini 3.1 Flash Lite Önizlemesi | 500.000.000 | |||
| Gemini 3.8 Flash | 400.000.000 | |||
| Gemini 3.6 Flash | 400.000.000 | |||
| Gemini 2.5 Pro | 500.000.000 | |||
| Gemini 2.5 Pro TTS | 100.000 | |||
| Gemini 2.5 Flash | 400.000.000 | |||
| Gemini 2.5 Flash Preview | 400.000.000 | |||
| Gemini 2.5 Flash Image Önizleme | 400.000.000 | |||
| Gemini 2.5 Flash TTS | 100.000 | |||
| Gemini 2.5 Flash Lite | 500.000.000 | |||
| Gemini 2.5 Flash Lite Önizlemesi | 500.000.000 | |||
| Gemini 2.0 Flash | 1.000.000.000 | |||
| Gemini 2.0 Flash Image | 400.000.000 | |||
| Gemini 2.0 Flash Lite | 1.000.000.000 | |||
| Çok formatlı üretken modeller | ||||
| Gemini 3.1 Flash Image Preview 🍌 | 250.000.000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 270.000.000 | |||
| Gemini 3 Pro ile görüntü önizlemesi 🍌 | 270.000.000 | |||
| Yerleştirme modelleri | ||||
| Gemini Embedding | 5.000.000 | |||
3. Katman
| Model | Sıraya alınan toplu jetonlar | |||
|---|---|---|---|---|
| Metin çıkışı modelleri | ||||
| Gemini 4 Argon | 1.000.000.000 | |||
| Gemini 3.1 Pro Preview | 1.000.000.000 | |||
| Gemini 3.5 Flash-Lite | 1.000.000.000 | |||
| Gemini 3.1 Flash Lite | 1.000.000.000 | |||
| Gemini 3.1 Flash Lite Önizlemesi | 1.000.000.000 | |||
| Gemini 3.8 Flash | 1.000.000.000 | |||
| Gemini 3.6 Flash | 1.000.000.000 | |||
| Gemini 2.5 Pro | 1.000.000.000 | |||
| Gemini 2.5 Pro TTS | 1.000.000 | |||
| Gemini 2.5 Flash | 1.000.000.000 | |||
| Gemini 2.5 Flash Önizlemesi | 1.000.000.000 | |||
| Gemini 2.5 Flash Image Önizleme | 1.000.000.000 | |||
| Gemini 2.5 Flash TTS | 4.000.000 | |||
| Gemini 2.5 Flash Lite | 1.000.000.000 | |||
| Gemini 2.5 Flash Lite Önizleme | 1.000.000.000 | |||
| Gemini 2.0 Flash | 5.000.000.000 | |||
| Gemini 2.0 Flash Image | 1.000.000.000 | |||
| Gemini 2.0 Flash Lite | 5.000.000.000 | |||
| Çok formatlı üretken modeller | ||||
| Gemini 3.1 Flash Image Preview 🍌 | 750.000.000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 1.000.000.000 | |||
| Gemini 3 Pro ile görüntü önizlemesi 🍌 | 1.000.000.000 | |||
| Yerleştirme modelleri | ||||
| Gemini Embedding | 10.000.000 | |||
Bir sonraki katmana nasıl geçilir?
Ücretsiz katmandan ücretli katmana geçmek için öncelikle AI Studio'da faturalandırmayı ayarlamanız gerekir.
Projeniz belirtilen ölçütleri karşıladığında otomatik olarak bir sonraki katmana yükseltilir. Ücretsiz katmandan 1. katmana yükseltme işlemleri genellikle anında geçerlilik kazanır. Sonraki katman yükseltme işlemleri ise 10 dakika içinde geçerlilik kazanır. Katmanlarınızı kontrol etmek için AI Studio'daki Projeler sayfasına gidin.
Sıklık sınırlaması artışı talep etme
Her model varyasyonunun ilişkili bir sıklık sınırı (dakika başına istek, RPM) vardır. Bu sıklık sınırlarıyla ilgili ayrıntılar için AI Studio Sıklık Sınırı sayfasına bakın.
Ücretli katman sıklık sınırlamasının artırılmasını talep etme
Sıklık sınırınızı artırma konusunda garanti veremeyiz ancak isteğinizi incelemek için elimizden geleni yaparız.