Sıklık sınırlamaları, belirli bir zaman aralığında Gemini API'ye yapabileceğ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 sıklık 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ırlamaları genellikle üç boyutta ölçülür:
- Dakikada gönderilen istek sayısı (RPM)
- Dakikada 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 TPM veya diğer sınırlarınızı aşmamış olsanız bile bir dakika içinde 21 istekte bulunmanız hataya neden olur.
Sıklık sınırlamaları 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.
Hız sınırları, deneysel ve önizleme modellerinde 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 hareketli 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 hesap durumunuza 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ırlamaları, 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ı + ilk başarılı ödemeden itibaren 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 ABD doları - 100.000 ABD doları ve üzeri |
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 sıklık sınırlamaları
Sıklık sınırlamaları, 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ırlamalarınız otomatik olarak güncellenir.
AI Studio'da etkin sıklık 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.
Öncelik çıkarımı sıklık sınırları
Öncelikli tüketim, genel etkileşimli trafik sıklık sınırlamalarına dahil edilse de kendi sıklık sınırlamaları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ırlamaları
Batch API istekleri, toplu olmayan API çağrılarından ayrı olarak kendi hız sınırlarına tabidir.
- Eşzamanlı toplu istekler: 100
- Giriş dosyasının boyut sınırı: 2 GB
- Dosya depolama alanı sınırı: 20 GB
- Model başına sıraya alınan jetonlar: Toplu işleme için sıraya alınan jetonlar tablosunda, belirli bir model için tüm etkin toplu işleme işlerinizde toplu işleme için sıraya alınabilecek maksimum jeton sayısı listelenir.
Katman 1
| Model | Toplu olarak sıraya alınan jetonlar | |||
|---|---|---|---|---|
| Metin çıkışı modelleri | ||||
| Gemini 3.1 Pro Önizlemesi | 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 Önizlemesi | 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 Görüntüsü | 3.000.000 | |||
| Gemini 2.0 Flash Lite | 10.000.000 | |||
| Çok formatlı üretken modeller | ||||
| Gemini 3.1 Flash Image Preview 🍌 | 1.000.000 | |||
| Gemini 3.1 Flash Lite Image 🍌 | 2.000.000 | |||
| Gemini 3 Pro ile görüntü önizlemesi 🍌 | 2.000.000 | |||
| Yerleştirme modelleri | ||||
| Gemini Embedding | 500.000 | |||
Katman 2
| Model | Toplu olarak sıraya alınan jetonlar | |||
|---|---|---|---|---|
| Metin çıkışı modelleri | ||||
| 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 Önizlemesi | 400.000.000 | |||
| Gemini 2.5 Flash Image Önizlemesi | 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 Görüntüsü | 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 | Toplu olarak sıraya alınan jetonlar | |||
|---|---|---|---|---|
| Metin çıkışı modelleri | ||||
| Gemini 3.1 Pro Önizlemesi | 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 Önizlemesi | 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 Önizlemesi | 1.000.000.000 | |||
| Gemini 2.0 Flash | 5.000.000.000 | |||
| Gemini 2.0 Flash Görüntüsü | 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 yükseltme
Ücretsiz katmandan ücretli bir 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. Katman'a yükseltme genellikle anında, sonraki katman yükseltmeleri ise 10 dakika içinde geçerlilik kazanır. Katmanlarınızı kontrol etmek için AI Studio'da Projeler sayfasına gidin.
Sıklık sınırlaması artışı isteğinde bulunma
Her model varyasyonunun ilişkili bir sıklık sınırı (dakikadaki istek sayısı, 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ı artışı talep etme
Sıklık sınırlamanızı artıracağımız konusunda garanti vermiyoruz ancak isteğinizi incelemek için elimizden geleni yapacağız.