Gemini Decisions API Ücretsiz Olarak Nasıl Kullanılır?

Gemini Decisions API'yi bugün ücretsiz kullanabilirsiniz. gemini-decision-1 modeli için Google'ın ücretsiz katmanı girdi için hiçbir ücret almaz, çıktı token'ı faturalandırmaz ve proje başına dakikada 200 istek, dakikada 50.000 token ve günde 10.000 istek limiti tanır. Bir AI Studio API anahtarına ihtiyacınız var; faturalandırma hesabına gerek yoktur. Püf noktası şu: ücretsiz katmanda Google, içeriğinizi ürünlerini geliştirmek için kullanabilir.

Aşağıda: bu limitlerin gerçek iş yüklerinde ne anlama geldiği, milyon token başına 0,10 $ olan ücretli fiyatın arkasındaki token matematiği, diğer 0 $ 'lık yollar ve testleri ile CI'ı günlük kotanızın dışında tutma yöntemleri bulunuyor. Tüm kotalar ve fiyatlar 12 Kasım 2026'da Google'ın resmi sayfalarından alınmıştır. API v1beta olarak yayınlanmaktadır, bu yüzden bütçelemeden önce tekrar kontrol edin. Soru türlerinin kendileri (noul, choice, score) için Google'ın Decisions API kılavuzuna bakın.

Gemini Decisions API ücretsiz katmanı neleri kapsıyor

Gemini Decisions API ücretsiz katmanı, Google'ın Gemini Developer API'sinin gemini-decision-1 modeline uygulanmış maliyetsiz kullanım katmanıdır. Her Google Cloud projesine ücretsiz girdi işleme, sıfır çıktı ücreti ve 200 RPM, 50.000 TPM ve 10.000 RPD sabit hız limitleri sunar; faturalandırma kurulumu gerekmez.

Google'ın fiyatlandırma sayfası ve hız limitleri sayfasının söyledikleri, yan yana:

Ana rakamlardan daha önemli üç detay:

• Limitler API anahtarı başına değil, proje başınadır. Tek bir projede beş anahtar oluşturmak size beş kota kazandırmaz.
• Günlük üst sınır Pasifik saatiyle gece yarısı sıfırlanır. Pasifik saatiyle akşam 11'de başlayan bir toplu iş, bir günün kotasının bir saatini kullanır ve gece yarısından sonra taze 10.000 alır.
• Ücretsiz katman verileri Google tarafından kullanılabilir. Fiyatlandırma tablosunda "Ürünlerimizi geliştirmek için kullanılır" alanı ücretsiz katmanda Evet, ücretlide Hayır olarak işaretlenmiştir. Müşteri PII'lerini, sözleşmeleri veya tıbbi görüntüleri ücretsiz bir anahtarla göndermeyin.

Ücretsiz Gemini Decisions API anahtarı nasıl alınır

Yaklaşık beş dakika içinde ücretsiz aramalar yapmaya başlayabilirsiniz:

1. Google AI Studio'ya giriş yapın ve Create API key seçeneğine tıklayın. Yeni bir proje ücretsiz katmanda başlar.
2. SDK 3.2 veya sonrasını yükleyin: pip install -U google-genai ya da npm install @google/genai@latest.
3. Anahtarı SDK'nın algılaması için GEMINI_API_KEY olarak dışa aktarın.
4. http_options={"api_version": "v1beta"} ile bir istek gönderin ve yanıttaki usage bloğunu okuyun.

from google import genai

client = genai.Client(http_options={"api_version": "v1beta"})

result = client.decisions.create(
    model="gemini-decision-1",
    input="Order 8821 arrived with a cracked screen.",
    questions={
        "is_damaged": {"type": "noul", "instructions": "Did the item arrive damaged?"},
    },
)

print(result.answers["is_damaged"].noul)
print(result.usage.total_input_tokens)

usage.total_input_tokens sayısı, kaydedilmesi gereken sayıdır. Ücretsiz katmanda 50.000 TPM'nizi tüketen şey budur; ücretli katmanda ise faturalanan tek şeydir.

Google'ın diğer ücretsiz teklifleri için Gemini API ücretsiz katmanı rehberimize ve Gemini'yi ücretsiz kullanma yazımıza göz atın.

Gemini Decisions API fiyatlandırması nasıl çalışır

Yalnızca girdi token'ları için ödeme yaparsınız ve kaç soru sorarsanız sorun, paylaşılan girdi istek başına bir kez sayılır. Her soru yalnızca kendi talimat ve ölçüt token'larını ekler. Çıktı her zaman 0 token'dır, çünkü model metin değil olasılık döndürür.

Bu nedenle tek bir istek için formül basittir:

input tokens = shared input + sum(each question's instructions + criteria)
paid cost    = input tokens / 1,000,000 x $0.10

Asıl ilginç olan, bunun ücretsiz katmana etkisidir. Metinlerde genellikle istek sayısı (200 RPM, 10.000 RPD) önce sınıra çarpar. Görsellerde, seslerde veya uzun belgelerde ise 50.000 TPM limiti önce devreye girer.

Örnek maliyet hesaplamaları: ücretsiz katman ve ücretli karşılaştırması

Aşağıdaki soru token rakamları tahminidir (kısa soru başına yaklaşık 30 token). Görsel ve ses sayıları, güncel Gemini modelleri için görsel başına low çözünürlükte 280 token, high çözünürlükte 1.120 token ve saniye başına 25 token listeleyen Google'ın medya çözünürlüğü tablosundan alınmıştır. Bir gerçek istek çalıştırın ve benim rakamlarımı kendi usage değerlerinizle değiştirin.

10.000 ürün fotoğrafı x 16 soru

Diyelim ki teslimat fotoğraflarını hasar, yerleşim, etiket okunabilirliği ve 13 başka konu için kontrol ediyorsunuz.

• low çözünürlükte istek başına: 280 (görsel) + 20 (metin bağlamı) + 16 x 30 (sorular) = 780 token
• 10.000 fotoğraf: 10.000 x 780 = 7,8M token
• Ücretli maliyet: 7,8 x 0,10 $ = 0,78 $
• high çözünürlükte: fotoğraf başına 1.120 + 20 + 480 = 1.620 token, 16,2M token, 1,62 $

Ücretsiz katmanda hızınızı TPM belirler: 50.000 / 780 = dakikada yaklaşık 64 fotoğraf. 10.000 fotoğrafın tamamı kabaca 2 saat 36 dakikada biter ve bir günün 10.000 isteğini tam olarak kullanır. high çözünürlükte dakikada yaklaşık 30 fotoğraf ve 5,5 saat demektir.

Şimdi kaçınılması gereken hataya bakalım. 16 kontrolü 16 ayrı istek olarak gönderirseniz her biri görseli yeniden gönderir: 16 x 300 = 4.800 görsel ve bağlam token'ı, artı aynı 480 soru token'ı — fotoğraf başına yaklaşık 5.280. Bu da 52,8M token (ücretli 5,28 $) ve 16 gün ücretsiz katman kotası demek olan 160.000 istek olur. Soruları tek istekte toplayın.

10.000 destek talebi x 3 yönlendirme sorusu

• İstek başına: 250 (talep metni) + 3 x 40 (ölçütlü sorular) = 370 token
• 10.000 talep: 3,7M token, ücretli 0,37 $
• Ücretsiz katman: 50.000 / 370 = dakikada 135 istek; 200 RPM sınırının altında. Bir günün 10.000 isteği 10.000 talebi karşılar.

Uzun PDF'ler

Bağlam penceresi 262.144 token'dır, ancak ücretsiz TPM 50.000'dir; dolayısıyla tek bir 120.000 token'lık sözleşme, ücretsiz bütçenin bir dakikadan fazlasını tüketir. Google'ın belgeleri ücretsiz katmanın TPM sınırını aşan tek bir isteği nasıl ele aldığını söylemiyor, bu yüzden önce bir tane test edin. Uzun belgeler, Kademe 1'in (1M TPM) kendini amorti ettiği yerdir.

Gemini Decision 1'i 0 $ ile kullanmanın diğer yolları

12 Kasım 2026'da kontrol edilen OpenRouter'ın model sayfası, 1M girdi başına 0,10 $, ücretsiz çıktı ve :free varyantı olmadan tek bir sağlayıcı (Google AI Studio) listeliyor. OpenRouter'ın Decisions uç noktasında çalışır, bu yüzden chat completions SDK'ları onu çağıramaz.

Ücretsiz katmanda nasıl kalınır

Bu alışkanlıklar bir prototipi mümkün olduğunca uzun süre 0 $ 'da tutar:

1. Tüm soruları tek istekte sorun. Paylaşılan girdi bir kez faturalanır ve tek bir çağrıda 1.000 soruya kadar sığar.
2. Medya çözünürlüğünü düşürün. low, görsel başına high değerinin dörtte birine mal olur.
3. Yalnızca soruların ihtiyaç duyduğu alanları gönderin. Google, alakasız içeriğin doğruluğu düşürdüğünü söyler ve TPM yakar.
4. RPM yerine TPM'e göre hız sınırlandırın. Çalışanları, ölçtüğünüz istek başına token sayısına bölünmüş 50.000'e göre zamanlayın.
5. Yanıtları kendiniz önbelleğe alın. API'de bağlam önbelleğe alma yoktur ve tekrarlanan girdiyi tam olarak sayar; bu yüzden girdi artı soruların karmasını alın ve tekrarları atlayın.
6. Büyük işleri Pasifik gece yarısından sonra başlatın ki tam bir günlük kotayı elde edin.
7. Testleri ve CI'ı gerçek API'den uzak tutun. Her push'ta onu çağıran bir test paketi öğle yemeğine kadar 10.000 istek harcayabilir. Onun yerine mock kullanın.

Kodlama ajanınız Decisions API'yi Apidog CLI ile mock'lasın

Birim testlerinin canlı bir modele ihtiyacı yoktur. Doğru şekle ihtiyaçları vardır: bir answers haritası, 0,01 ile 0,99 arası bir noul, bir confidence ve usage.total_output_tokens: 0. Kodlama ajanınız bu mock'u Apidog CLI ile oluşturabilir, böylece yalnızca bir smoke test Google'a dokunur.

Bir kez kurulum:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Ardından Claude Code, Codex veya Cursor'a tek bir istem verin:

In Apidog project <id>, add the Gemini Decisions endpoint POST /v1beta/decisions
with a request body of model, input and questions. Create mock expectations that
return a damaged answer (noul 0.97) and an undamaged one (noul 0.04), each with
usage.total_output_tokens = 0. Add a test case that asserts the answers map,
confidence between 0 and 1 and zero output tokens. Run it against the mock
environment, then once against the real API with my free-tier key.

Ajan her payload şemasını okur, doğrular ve ancak sonra şunları yazar:

apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <id> --file decisions-endpoint.json

apidog cli-schema get mock-create
apidog cli-schema validate mock-create --file mock-damaged.json
apidog mock create --project <id> --file mock-damaged.json

apidog cli-schema get test-case-create
apidog test-case create --project <id> --file decisions-case.json
apidog run --test-case <caseId> --project <id> -e <mockEnvId> -r cli,json
apidog run --test-case <caseId> --project <id> -e <freeTierEnvId> -r cli

CI'da yalnızca mock ortamını -r junit ile çalıştırın (pipeline dosyası Apidog CLI CI/CD rehberimizde); ajan kurulumu Apidog CLI in Claude Code yazısında. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar, böylece küçük bir ekip mock'ları maliyetsiz paylaşır. OpenAI'nin versiyonunu da değerlendiriyor musunuz? OpenAI Decisions API açıklamamıza bakın.

SSS

Gemini Decisions API ücretsiz mi? Evet, limitler dahilinde. Ücretsiz katman girdi için hiçbir ücret almaz ve çıktı her zaman 0 token'dır. Proje başına dakikada 200 istek, dakikada 50.000 token ve günde 10.000 istek alırsınız. Bunun ötesinde faturalandırmayı kurun ve 1M girdi token'ı başına 0,10 $ ödeyin.

Gemini Decisions API ücretsiz katmanı için kredi kartı gerekli mi? Hayır. Google AI Studio'dan alınan bir API anahtarı ücretsiz katmanda başlar. Google'ın hız limitleri sayfası, ancak AI Studio'da faturalandırmayı kurduktan sonra ücretli katmana geçtiğinizi söyler.

Google, ücretsiz katman Decisions API verilerimle eğitim yapar mı? Google'ın fiyatlandırma sayfası "Ürünlerimizi geliştirmek için kullanılır" alanını ücretsiz katman için Evet, ücretli için Hayır olarak işaretler. Ücretsiz katman anahtarlarını hassas veriler için uygun değil olarak değerlendirin.

Neden dakikada 200 isteğin çok altındayken 429 hataları alıyorum? Muhtemelen dakikada 50.000 token'ı aşıyorsunuzdur. Görsel, ses ve PDF girdileri token açısından ağırdır, bu yüzden TPM genellikle RPM'den önce sınıra çarpar. usage.total_input_tokens değerini kaydedin ve istekleri bu sayıya bölünmüş 50.000'e göre zamanlayın.

OpenRouter'da ücretsiz bir Gemini Decision 1 modeli var mı? 12 Kasım 2026 itibarıyla hayır. OpenRouter, google/gemini-decision-1 modelini 1M girdi token'ı başına 0,10 $ ve 0 $ çıktı ile listeler; :free varyantı yoktur.

Ücretsiz katmanı uzatmak için Batch API veya bağlam önbelleğe alma kullanabilir miyim? Hayır. Model sayfası, Batch API ve önbelleğe almayı herhangi bir katmanda desteklenmiyor olarak listeler. Soruları tek bir istekte toplayın ve yanıtları kendi kodunuzda önbelleğe alın.