Gemini 4 Carbon API: Model Kimliği, Fiyatlandırma ve İlk İsteğiniz

11 Kasım 2026 itibarıyla Google’ın Gemini 4 Carbon API’si gemini-4-carbon model kimliğini kullanıyor ve 30 Kasım 2026’ya kadar milyon giriş jetonu başına 2 dolar, milyon çıkış jetonu başına 10 dolar; sonrasında 4 dolar ve 20 dolar maliyetine sahip. Google, modeli 10 Kasım 2026’da yalnızca Gemini API’nin ücretli katmanında genel kullanıma sundu.

Bu rehber, yeni bir anahtarı ilk isteğinize kadar götürür, faturanızı belirleyen kullanım rakamlarını gösterir ve test işini kodlama ajanınıza devreder.

Gemini 4 Carbon model kimliği nedir?

Gemini 4 Carbon model kimliği gemini-4-carbon’dur. Bunu Gemini API’nin Interactions uç noktasına yapılan bir istekte model alanı olarak, Python veya JavaScript SDK’sında ya da bir Google AI Studio isteminde iletirsiniz. Google, Carbon’u en güçlü akıl yürütme modeli olarak tanımlar ve zor görevler için önerir; günlük işler için ise Gemini 4 Argon varsayılan olmaya devam eder.

Modelin kendisi hakkında arka plan bilgisi için Gemini 4 Carbon nedir yazısıyla başlayın.

Gemini 4 Carbon için Gemini API anahtarı nasıl alınır?

Carbon yalnızca ücretli katmanda çalıştığı için tek başına bir anahtar yeterli değildir. Cloud Billing bağlı bir projedeki bir anahtara ihtiyacınız var:

1. Google AI Studio’da API anahtarları sayfasını açın. Yeni kullanıcılar için proje ve anahtar otomatik oluşturulur; aksi hâlde Create API key seçeneğine tıklayın.
2. API anahtarları veya Projeler sayfasında Set up billing seçeneğine tıklayın.
3. Bir Cloud Billing hesabı oluşturun veya mevcut bir hesabı bağlayın, ödeme yöntemi ekleyin ve Google’ın hızlı başlangıç kılavuzuna göre en az 5 dolar kredi ön ödemesi yapın.
4. Anahtarı kabuğunuza aktarın: export GEMINI_API_KEY="YOUR_API_KEY".

Gemini 4 Carbon ücretsiz seçenekleri yazısı, hiç API anahtarı gerektirmeyen yolları ele alıyor.

İlk Gemini 4 Carbon API isteğinizi nasıl gönderirsiniz?

Google’ın Carbon için hızlı başlangıç kılavuzu Interactions API’yi kullanır: gövdede model ve input ile /v1beta/interactions adresine bir POST. Model adını bir değişkene koyun; böylece ileride Carbon ve Argon arasında geçiş tek satırlık bir değişiklik olur.

curl ile:

export GEMINI_MODEL="gemini-4-carbon"

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "model": "'"$GEMINI_MODEL"'",
    "input": "Find the race condition in this retry loop and rewrite the lock safely.",
    "generation_config": {
      "thinking_level": "medium"
    }
  }'

Python SDK ile (pip install -U google-genai):

import os
from google import genai

MODEL = os.environ.get("GEMINI_MODEL", "gemini-4-carbon")

client = genai.Client()  # reads GEMINI_API_KEY from the environment

interaction = client.interactions.create(
    model=MODEL,
    input="Find the race condition in this retry loop and rewrite the lock safely.",
    generation_config={"thinking_level": "medium"},
)

print(interaction.output_text)
print(interaction.usage)

Her iki kod parçacığı da Google’ın dokümanlarındaki örnekleri takip ediyor. Bu makale için onları çalıştırmadık, çünkü bu makinede ücretli bir Carbon anahtarımız yok; bu yüzden yanıt yapısını kendi ilk çağrınızla doğrulayın.

Google’ın geçiş notlarındaki üç ayrıntı size bir hata ayıklama oturumu kazandırır:

• Örnekleme parametrelerini kaldırın. temperature, top_p ve top_k Carbon tarafından yok sayılır, dolayısıyla bunları çıkarın.
• Zaman aşımı sürelerini artırın. Zor istemler birkaç dakika sürebilir. Google, arka planda çalıştırmayı veya en az 15 dakikalık HTTP zaman aşımlarını öneriyor.
• Durumu sunucuda tutun. Çok turlu sohbetler ve fonksiyon çağırma için geçmişi yeniden göndermek yerine previous_interaction_id kullanın.

Zaten Argon kullanıyor musunuz? Gemini 4 Argon API rehberimiz aynı istek yapısını kullanıyor.

Yanıttaki kullanım ve düşünme jetonlarını nasıl okursunuz?

Her etkileşim bir usage nesnesi döndürür. Maliyet açısından önemli olan alanlar şunlar:

• total_input_tokens: gönderdiğiniz şey; sistem talimatları ve araç bildirimleri dahil.
• total_thought_tokens: modelin yanıt vermeden önce düşünmeye harcadığı jetonlar.
• total_output_tokens: görünen yanıt.
• total_tokens: toplam.

Takip edilmesi gereken alan total_thought_tokens. Google’ın düşünme rehberi, yanıt fiyatlandırmasının çıkış jetonları ile düşünme jetonlarının toplamı olduğunu söylüyor; yani düşünme, 10 dolarlık çıkış oranıyla faturalandırılıyor. Google ayrıca Carbon’un, işini keşfetmek ve doğrulamak için her turda Argon’a göre “daha fazla düşünme jetonu harcadığını” belirtiyor. Zor bir istemde düşünme, faturanın büyük bölümünü oluşturabilir.

max_output_tokens, düşünme ve çıkışın toplamını sınırlar. Bunu çok düşük ayarlarsanız Carbon, bütçenin tamamını düşünmeye harcayabilir ve yanıtı kısaltabilir. Google’ın başlangıç noktaları:

• Standart görevler: 65.536 varsayılanını koruyun.
• Limiti 32K altında olan uygulamalar: en az 32.768’e yükseltin.
• Karmaşık akıl yürütme ve kodlama: background: true ayarlayın ve 131.072 ya da 262.144 jeton kullanın.

background: true ile Google’ın sunucuları yanıtı 64K jetonluk adımlarla sürdürür. Etkileşimi, durumu in_progress veya queued olmaktan çıkana kadar yoklarsınız, ardından her model_output adımındaki metinleri birleştirirsiniz.

Hangi Gemini 4 Carbon düşünme seviyesini kullanmalısınız?

Düşünme seviyesi; kalite, gecikme ve harcama üzerindeki ana kontrol noktanızdır. düşünme rehberi ve Carbon dokümanlarındaki Google tavsiyeleri:

Google, değerlendirmelerinizi üç seviyede de çalıştırmanızı ve kalite barınızı karşılayan en düşük seviyeyi tutmanızı öneriyor. Carbon’da low ile high arasındaki fark, bütçenizin gittiği yerdir.

Bir görevi Argon yerine ne zaman Gemini 4 Carbon’a göndermelisiniz?

Google bu konuda açık: “Argon, yazılım mühendisliği ve bilgi işlerinin büyük çoğunluğu için ideal seçim olmaya devam ediyor.” İki model de 1M bağlam penceresini, yerleşik araçları ve aynı tanıtım dönemine ait jeton başına fiyatı paylaşıyor; dolayısıyla fark, her birinin tur başına kaç jeton harcadığında. Karmaşık kök neden hata ayıklaması, mimari tasarım, yoğun çok modlu sentez, kanıtlar ve güvenlik denetimleri için Carbon kullanın. Etkileşimli kodlama, günlük özellikler ve hızlı üretim döngüleri için Argon’da kalın. Gemini 4 Carbon ve Argon karşılaştırmamız daha derine iner; Carbon’u Anthropic’in en yeni modeliyle karşılaştırıyorsanız Gemini 4 Carbon ve Claude Fable 5.2 ile Claude Fable 5.2 API rehberine bakın.

Bir Gemini 4 Carbon API çağrısı ne kadar tutar?

Gemini 4 Carbon, Google’a göre 30 Kasım 2026’ya kadar 1M giriş jetonu başına 2 dolar ve 1M çıkış jetonu başına 10 dolar (düşünme dahil), sonrasında 4 dolar ve 20 dolar tutuyor.

Bunu tek bir çağrı üzerinden göstermek için 2.000 giriş jetonu, 6.000 düşünme jetonu ve 1.500 çıkış jetonu içeren temsili bir istek ele alalım. Bunlar örnek rakamlardır, bir ölçüm değildir:

• Giriş: 2.000 x 2 $ / 1M = 0,004 $
• Düşünme artı çıkış: 7.500 x 10 $ / 1M = 0,075 $
• Toplam: bugün yaklaşık 0,079 $, 1 Aralık’tan itibaren yaklaşık 0,158 $

Düşünme, isteme göre çok değişir; bu yüzden kendi usage nesnenizi okuyun. Tam fiyat matematiği, Aralık’taki sıçrama ve görev başına maliyet için Gemini 4 Carbon fiyatlandırması yazısına bakın.

Kodlama ajanınızın Carbon API’sini Apidog CLI ile test etmesine izin verin

Düşünme seviyelerini, çıkış limitlerini ve istemleri çok kez değiştireceksiniz. Her değişiklikten sonra JSON’a göz gezdirmek yerine, kodlama ajanınızın (Claude Code, Codex, Cursor) tekrarlanabilir bir test yazmasına ve onu Apidog CLI ile çalıştırmasına izin verin.

Bir kez kurulum yapın:

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

Sonra ajanınıza tek bir istem verin:

In Apidog project <projectId>, add an endpoint for
POST https://generativelanguage.googleapis.com/v1beta/interactions
with the x-goog-api-key header read from the GEMINI_API_KEY variable in
environment <envId>. Create a test case that sends model "gemini-4-carbon",
a short prompt and thinking_level "low", and asserts: HTTP 200, status is
"completed", usage.total_thought_tokens exists, and usage.total_tokens is
below 20000. Run it and summarize any failures.

Testte low kullanmak her çalıştırmayı ucuz tutar. Ajan şemaları okur, payload’larını doğrular ve test senaryosunu çalıştırır:

apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file endpoint.json
apidog endpoint create --project <projectId> --file endpoint.json
apidog test-case category --project <projectId>
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Jeton bütçesi doğrulaması, işe yarayan kısımdır. Bir istem değişikliği düşünmeyi limitinizin üzerine taşırsa test, fatura büyümeden başarısız olur. -r cli,json yerine -r junit kullanın, aynı komut CI’da da çalışır; Apidog CLI CI/CD rehberi hattı gösterir ve Claude Code’da Apidog CLI ajan kurulumunu adım adım anlatır. Apidog’un Ücretsiz planı 4 kullanıcıya kadar kapsar.

Ajanın her şeyi sıfırdan kurmasını istiyorsanız ona şunu söyleyin: “https://apidog.com/apidog-cli-installation-guide.md adresini oku ve Apidog CLI’yi kur.”

SSS

Gemini 4 Carbon API’si ücretsiz mi? Hayır. Google’ın dokümanları, Gemini 4 Carbon’un Gemini API’nin Ücretsiz katmanında kullanılamadığını söylüyor. Cloud Billing bağlı ve en az 5 dolar ön ödemeli kredi içeren bir ücretli katman projesine ihtiyacınız var. Tüketici tarafında ise Google, Carbon’u Gemini uygulamasında, AI Mode ve Antigravity’de Google AI Ultra abonelerine sunuyor.

Gemini 4 Carbon Vertex AI’da var mı? Google’ın lansman yazısı Gemini API, Google AI Studio, Android Studio, Gemini for business, Antigravity ve CodeMender’ı sayıyor. Vertex AI’dan söz etmiyor; bu yüzden planlarınızı buna göre yapmadan önce Google Cloud’un model listesini kontrol edin.

Gemini 4 Carbon bağlam penceresi nedir? 1.048.576 jeton; giriş, düşünme ve çıkış arasında paylaşımlı. Senkron bir yanıt 65.536 jetonda durur; arka planda çalıştırmayla bir yanıt, girişiniz düşülünceye kadar 1M jetona kadar sürebilir.

Interactions API yerine generateContent kullanabilir miyim? Google’ın Carbon hızlı başlangıcı Interactions API’yi kullanıyor ve dokümanları, istemci tarafı uzun decode devamı için GenerateContent API’den bahsediyor. Uygulamanız zaten generateContent kullanıyorsa, geçiş yapmadan önce model kimliği değişimini orada test edin.

Gemini 4 Argon’dan Carbon’a nasıl geçerim? Model dizesini gemini-4-argon yerine gemini-4-carbon yapın. Google, istek şemasında değişiklik gerekmediğini söylüyor. Carbon daha uzun düşündüğü için max_output_tokens değerini ve HTTP zaman aşımı sürelerinizi artırın; bir görev high gerektirmedikçe thinking_level değerini medium tutun.