Gemini Kararlar API'si: Gemini Decision 1 Ne İşe Yarar, Fiyatlandırması ve Çalışma Mantığı

Gemini Decisions API, metin üretmek yerine kapalı uçlu soruları yanıtlayan yeni bir Google uç noktasıdır. Tek bir paylaşılan girdi (metin, görsel, ses, video veya PDF) ve en fazla 1.000 yazılı soru gönderirsiniz; Gemini Decision 1 (gemini-decision-1) her biri için kalibre edilmiş bir olasılık ve bir güven puanı döndürür. Maliyeti girdi başına 1M token için 0,10 $; çıktı her zaman 0 token'dır ve Google uçtan uca 150–250 ms süre belirtiyor.

Google, bunu 11 Kasım 2026'da bir v1beta uç noktası olarak kullanıma sundu. Uygulamalı kurulum için Gemini Decisions API nasıl kullanılır yazımıza bakın.

Google, Gemini Decision 1 ile neler sundu?

Gemini Decision 1, metni token token çözümlemek yerine tek bir ileri geçişte sabit bir aday yanıt setini puanlayan bir modeldir. Decisions API bu modeli kullanıma açar ve kodunuz, üzerinde dallanma yapabileceği sayıları alır.

“Gemini Decisions API: Fast, calibrated multimodal decisions” başlıklı lansman yazısı öne çıkan bilgileri şöyle sıralıyor:

• gemini-decision-1 model kimliği; Gemini API ve Google AI Studio üzerinden erişilebilir
• İstek başına tek çok modlu girdi; girdi ile tüm sorular tarafından paylaşılan 262.144 token'a kadar bağlam penceresi
• İstek başına 1 ila 1.000 bağımsız soru; üç tür: noul, choice ve score
• 1M girdi tokenı başına 0,10 $, çıktı 0 $; prototipleme için ücretsiz bir katman
• google-genai 3.2 ve üzeri SDK desteği (client.decisions.create(...)); OpenRouter, LangChain, Vercel AI SDK ve LiteLLM entegrasyonları aşamalı olarak kullanıma sunuluyor

Google Cloud'daki Gemini (Vertex AI) desteği “yakında” olarak listeleniyor; bugün itibarıyla yalnızca Developer API üzerinde çalışıyor.

Sohbet çağrısı yerine neden bir karar uç noktası?

“Bunu sınıflandır” türündeki kodların çoğu üretken bir model çağırır, JSON ister ve yanıtı ayrıştırır. Çıktı ve düşünme tokenları için ödeme yaparsınız ve model yaratıcı davrandığında ayrıştırıcı bozulur.

Decisions API, üretim adımını ortadan kaldırıyor. Google'ın dokümantasyonu bunu açıkça ifade ediyor: “sıfır metin tokenı üretir, dolayısıyla çıktı token kullanımı her zaman 0'dır.” Bunun ardından üç tasarım tercihi geliyor:

1. Paralel ve izole puanlama. Her soru, tek bir geçişte paylaşılan girdiye karşı çalışır. Sorular birbirini göremediği için birini eklemek ya da çıkarmak diğer yanıtları değiştirmez.
2. Değer artı güven. Değer, kodunuza ne yapılacağını söyler. Güven ise bunun otomatik yapılacağını mı yoksa bir üst makama mı eskale edileceğini belirtir.
3. Kod içinde birleştirilen atomik kontroller. Dar kapsamlı sorular sorar ve yanıtları sıradan if ifadeleri ile ağırlıklarla birleştirirsiniz.

Üretilen metin, şema biçimli veri çıkarımı, araç çağrıları veya çok adımlı akıl yürütme için Google yine sizi Interactions API'ye yönlendiriyor.

Üç soru türü

Her sorunun bir type, instructions alanı ve iki tür için criteria alanı vardır. Model, soru anahtarlarınızı asla görmez; bu yüzden sorunun tamamını instructions içinde yazın.

Eşik değerleri yazmadan önce bilmeniz gereken birkaç davranış var:

• noul asla 0 veya 1 olmaz. Olasılıklar 0,01 ile 0,99 arasında kalır; dolayısıyla “0,99'un üzerinde” kontrolü hiçbir zaman eşleşmez.
• choice anahtarları alfabetik olarak sıralanır ve puanlama bu sırayla yapılır; bu yüzden none_of_the_above gibi başa sıralanan bir anahtar yerine other gibi kapsayıcı bir anahtar kullanın.
• choice olasılığı her zaman seçeneklerinizin üzerine dağıtır, hiçbiri uygun olmasa bile. Bunu bir noul kapsam kontrolü ya da güven eşiğiyle birlikte kullanın.
• score seviye indekslerinin ağırlıklı ortalamasıdır; örneğin 1,12 “büyük ölçüde seviye 1, kısmen seviye 2” demektir.

Güven her yerde aynı şekilde tanımlanır: en üst sonucun olasılığı; evet/hayır soruları için max(noul, 1 - noul).

Örnek bir istek ve dönen yanıt

REST uç noktası POST https://generativelanguage.googleapis.com/v1beta/decisions olup bir x-goog-api-key başlığıyla kimlik doğrulaması yapılır. Bu istek, tek bir destek mesajı hakkında bir evet/hayır sorusu ve bir choice sorusu soruyor:

curl -X POST "https://generativelanguage.googleapis.com/v1beta/decisions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-decision-1",
    "input": "Audio cuts out on the left earcup. Fix it today or I cancel my membership.",
    "questions": {
      "is_defect": {
        "type": "noul",
        "instructions": "Does the message describe a hardware defect?"
      },
      "department": {
        "type": "choice",
        "instructions": "Which department should handle this request?",
        "criteria": {
          "billing": "Payments, invoices, and refunds.",
          "technical": "Problems using the product.",
          "shipping": "Delivery and tracking.",
          "other": "Anything outside these categories."
        }
      }
    }
  }'

Yanıtta iki üst düzey alan vardır: answers (soru kimliklerinizle indekslenir) ve usage:

{
  "answers": {
    "is_defect": { "type": "noul", "noul": 0.94, "confidence": 0.94 },
    "department": {
      "type": "choice",
      "choice": "technical",
      "probabilities": { "technical": 0.9, "other": 0.05, "billing": 0.03, "shipping": 0.02 },
      "confidence": 0.9
    }
  },
  "usage": { "total_input_tokens": 120, "total_output_tokens": 0, "total_tokens": 120 }
}

Sayılar temsili niteliktedir ve Google'ın Decisions API dokümantasyonundaki örneklerle aynı biçimdedir.

Metin dışı girdilerde input, Interactions API ile aynı şemayı kullanan içerik bloklarından oluşan bir diziye dönüşür: text, image, audio, video ve document (PDF). Medya, satır içi base64 (istek başına en fazla 100 MB), bir Files API URI'si veya bir HTTPS URL'si (her biri en fazla 15 MB) olabilir. Görsel ve video blokları, ayrıntı karşılığında token tasarrufu için bir resolution ayarı kabul eder.

Bir girdi güvenlik filtresi isteği engellerse answers yerine safety veya prohibited_content gibi bir error.code ile HTTP 400 alırsınız.

Gemini Decisions API fiyatlandırma, gecikme ve hız limitleri

Fiyatlandırma yalnızca girdiye dayalıdır: ücretli katmanda 1M girdi tokenı başına 0,10 $, ücretsiz katmanda ücretsiz ve çıktı her zaman 0 token olduğu için çıktı kalemi yoktur. Bu bilgiler, 12 Kasım 2026'da kontrol edilen Google'ın Gemini Developer API fiyatlandırma sayfasından alınmıştır. Aynı sayfa, ücretsiz katman içeriğinin Google'ın ürünlerini iyileştirmek için kullanıldığını, ücretli katman içeriğinin ise kullanılmadığını belirtir.

İki faturalandırma ayrıntısı önemlidir:

• Paylaşılan girdi istek başına bir kez faturalandırılır, kaç soru sorduğunuzdan bağımsız olarak. Her soru yalnızca kendi talimat ve criteria tokenlarını ekler.
• Bu uç nokta için bağlam önbellekleme, Batch API veya Flex/Priority çıkarımı yoktur; dolayısıyla aynı girdiyi iki istekte gönderirseniz iki kez faturalandırılır.

Kaba bir hesap: yaklaşık 40 tokenlık 20 soruyla birlikte 2.000 tokenlık bir destek talebi kabaca 2.800 girdi tokenı demektir; bu da ücretli katmanda karar çağrısı başına yaklaşık 0,00028 $'dır.

Gecikme rakamları Google'ın kendi verileridir: medyan 50–100 ms model hesaplaması, 150–250 ms uçtan uca; 16K tokena kadar girdilerde 1'den 100 soruya kadar neredeyse sabit kalıyor. Google ayrıca kendi benchmark setinde en düşük kalibrasyon hatasına ve Interactions API üzerinden Gemini 3.5 Flash-Lite'a göre yaklaşık 5 kat daha düşük maliyete sahip olduğunu iddia ediyor. Kendi trafiğinizi ölçene kadar ikisini de tedarikçi rakamları olarak değerlendirin.

12 Kasım 2026'da kontrol edilen, Google'ın hız limitleri sayfasından hız limitleri:

Ücretsiz katman, Gemini Decisions API ücretsiz yazımızda ayrıntılı olarak ele alınıyor.

Decisions API nereye uyar?

Google'ın dokümantasyonu beş kalıp adlandırıyor ve kendi iç ekipleri bunlara denk geliyor:

• Model yönlendirme. Gemini Notebook, sorguları bir model katmanına ve düşünme seviyesine yönlendiriyor; Google'a göre günlük sorgularda %40'a kadar daha düşük gecikme.
• Politika kontrolleri. Tek bir girdiye karşı tek çağrıda birçok kural; Google Search bunu MCP araçları için bir güvenlik katmanı olarak kullanıyor.
• Ajan kontrolü. Hangi araçların yükleneceği ya da sıkıştırma, eskalasyon veya durdurma kararları.
• Değerlendirme ve sıralama. Adayları veya getirilen parçaları bir rubriğe göre puanlama.
• Gerçek zamanlı medya. Google Labs'tan CC, 200'den fazla seçenek arasından bir emoji seçiyor.

Google'ın önerisi, bu eşiği kendi trafiğinizin etiketli örneklerinden, yanlış pozitif maliyetini yanlış negatif maliyetiyle tartarak belirlemektir.

OpenAI, Ekim ayında GPT-6 Luna üzerinde predicate, choice ve score soru türleriyle benzer bir uç nokta sundu; OpenAI Decisions API açıklamamız bunu ele alıyor. Limitler, modaliteler ve fiyatlandırma konusunda karşılaştırma ise Gemini Decisions API vs OpenAI Decisions API yazımızda.

Sınırlar ve açık sorular

Dokümantasyonun bugün itibarıyla belirttikleri:

• Gemini Developer API'de v1beta, yalnızca Gemini Decision 1 ile
• Soru talimatları yalnızca metin; sorularda medya desteklenmiyor
• Konuşma geçmişi, düşünme ve araç çağrısı blokları geçerli girdi değil; çok turlu bağlamı metin olarak serileştirin

Google, GA tarihi, bölgeler veya veri yerleşimi koşulları hakkında henüz bilgi yayınlamadı. Ayrıca kullanıcı metninin kendi sınıflandırması lehine argüman ileri sürebileceği konusunda uyarıyor; bu yüzden ödeme yapma gibi yüksek riskli eylemlerde insan kontrolünü sürdürün.

Kodlama ajanınızın Apidog CLI ile test etmesine izin verin

Bir karar uç noktası, ancak sözleşmesi tuttuğunda faydalıdır: her güven değeri 0 ile 1 arasında, her choice sizin setinizin içinde. Kodlama ajanınız, siz çalışmaya devam ederken bu regresyon testini Apidog CLI ile yazıp çalıştırabilir.

Bir kez kurulum yapın:

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

Ardından ajanınıza tek bir komut verin:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and a secret variable GEMINI_API_KEY.
Define POST /v1beta/decisions with header x-goog-api-key: {{GEMINI_API_KEY}}
and the support-ticket body from this article. Add a test case asserting:
status 200, usage.total_output_tokens == 0, every answers.*.confidence is
between 0 and 1, answers.department.choice is one of billing|technical|shipping|other,
and answers.is_defect.noul is between 0.01 and 0.99. Run it and summarize failures.

Ajan her payload'ı şemasına göre doğrular, ardından test senaryosunu oluşturur ve çalıştırır:

apidog environment create gemini --project <projectId> --base-url https://generativelanguage.googleapis.com
apidog cli-schema get environment-update
apidog environment update <envId> --project <projectId> --file env.json
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file decisions-endpoint.json
apidog endpoint create --project <projectId> --file decisions-endpoint.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file decisions-case.json
apidog test-case create --project <projectId> --file decisions-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Anahtarın kaydedilen ortamda saklanmaması için, çalışma anında --env-var "GEMINI_API_KEY=..." ile geçirin. -r junit ile aynı apidog run komutu CI'a doğrudan entegre olur; apidog run komut referansı tüm bayrakları listeler, Claude Code'da Apidog CLI ise tam ajan kurulumunu gösterir. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar.

SSS

Gemini Decisions API ücretsiz mi? Evet, ücretsiz katman sınırları içinde: dakikada 200 istek, dakikada 50.000 token ve günde 10.000 istek. Ücretli kullanım, 1M girdi tokenı başına 0,10 $'dır.

Tek bir istekte kaç soru sorabilirim? 1'den 1.000'e kadar; üst sınır, girdi ile tüm sorular tarafından paylaşılan 262.144 tokenlık bağlam penceresidir.

noul ne anlama geliyor? Evet/hayır soru türüdür. Yanıtın evet olma olasılığını (0,01 ile 0,99 arasında) ve bir güven puanını döndürür.

Vertex AI üzerinde kullanabilir miyim? Henüz hayır. Google, Google Cloud'daki Gemini desteğini “yakında” olarak listeliyor; bugün itibarıyla Gemini Developer API (v1beta) üzerinde.

Batch veya bağlam önbellekleme destekliyor mu? Hayır. Bağlam önbellekleme, Batch API ile Flex veya Priority çıkarımı desteklenmiyor; dolayısıyla tekrarlanan girdi tam olarak faturalandırılır.