
Gemini 4 Carbon API ile Gemini 4 Argon API aynı isteği kabul eder ve girdi ile çıktı token'ı başına aynı fiyattadır; dolayısıyla aralarında seçim yapmak bir geçiş (migration) değil, bir yönlendirme kararıdır. PoYo'da tek bir dizeyi değiştirerek geçiş yaparsınız: gemini-4-carbon (model sayfası) veya gemini-4-argon (model sayfası). Bu yazı API düzeyinde nelerin farklı olduğunu, Google'ın kıyaslama farklarının hangi isteklerin Carbon'a ait olduğu hakkında ne söylediğini ve kodunuza doğrudan ekleyebileceğiniz bir yönlendiriciyi ele alır.
Carbon'la yeni mi tanışıyorsunuz? Gemini 4 Carbon API genel bakışı ve ilk istek rehberi ile başlayın. Yalnızca Argon için Gemini 4 Argon API rehberine bakın.
Bir bakışta Gemini 4 Carbon API ve Gemini 4 Argon API
| Gemini 4 Carbon | Gemini 4 Argon | |
|---|---|---|
| PoYo model kimliği | gemini-4-carbon | gemini-4-argon |
| PoYo'daki uç noktalar | POST /v1/chat/completions, POST /v1beta/models/gemini-4-carbon:generateContent / :streamGenerateContent | Aynı iki biçim, gemini-4-argon ile |
| Bağlam penceresi | 1M token | 1M token |
| Yanıt başına maksimum çıktı | 64K token | Daha büyük: Google 1M'lik birleşik girdi-çıktı limiti tanımlar (bkz. Argon rehberimiz) |
| Girdi türleri | Metin, görsel, ses, video, PDF | Metin, görsel, ses, video, PDF |
| Google'ın konumlandırması | En güçlü akıl yürütme modeli; keşif, akıl yürütme ve doğrulama için daha fazla token harcar | Verimli model: daha hızlı yanıtlar, tur başına daha düşük token harcaması |
| Google'ın önerisi | En zor çok adımlı kodlama, hata ayıklama, açık uçlu araştırma | "Yazılım mühendisliği ve bilgi çalışmalarının büyük çoğunluğu için ideal seçim" |
İstek yapısı aynıdır. Chat Completions'ta model kimliği model alanına, Gemini Native'de ise URL yoluna yazılır. Her iki model de akışı destekler ("stream": true veya :streamGenerateContent). Hatalar da aynıdır: geçersiz alanlar veya yanlış biçim için 400, hatalı anahtar için 401, bilinmeyen model kimliği için 404 ve krediniz bittiğinde 402.
Yönlendirmeyi zorunlu kılan tek limit çıktı boyutudur. Carbon'ın belgelenmiş üst sınırı yanıt başına 64K çıktı token'ıdır. Tek bir yanıtın bundan uzun olması gerekiyorsa (örneğin tek seferde çok dosyalı tam bir yeniden yazım), isteği Argon'a gönderin.
Geçiş farkı: JSON'da neler değişir
Chat Completions'ta bir isteği Argon'dan Carbon'a taşımak:
{
- "model": "gemini-4-argon",
+ "model": "gemini-4-carbon",
"messages": [
{"role": "user", "content": "Find the root cause of the failing test and propose a patch."}
],
- "max_tokens": 120000,
+ "max_tokens": 64000,
"stream": true
}
Gemini Native'de yalnızca yol değişir:
POST https://api.poyo.ai/v1beta/models/gemini-4-argon:generateContent
POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent
Carbon'ı çağırırken max_tokens (Chat Completions) veya generationConfig.maxOutputTokens (Gemini Native) değerini 64.000 veya altında tutun. Gövdede başka hiçbir şeyin değişmesi gerekmez.
Token başına fiyat: önbellek okuma dışında eşit
Güncel model sayfalarındaki PoYo fiyatları (1 kredi = $0.005):
| Ölçüm (1M token başına) | PoYo'da Gemini 4 Carbon | PoYo'da Gemini 4 Argon | Google resmi (her ikisi, lansman) |
|---|---|---|---|
| Girdi | $1.60 (320 kredi) | $1.60 (320 kredi) | $2.00 |
| Çıktı (düşünme dahil) | $8.00 (1,600 kredi) | $8.00 (1,600 kredi) | $10.00 |
| Önbellek okuma | $0.08 (16 kredi) | $0.16 (32 kredi) | $0.10 (girdide %95 indirim) |
Google, Carbon'ı Argon'un lansman fiyatıyla piyasaya sürdü. Erişilebilirlik duyurusuna göre lansman dönemi 30 Kasım 2026'da sona eriyor ve 1 Aralık'tan itibaren 1M token başına girdi için $4, çıktı için $20 uygulanıyor. Carbon fiyatlandırma yazısı, Google'ın iki ücretini de güncel PoYo fiyatıyla karşılaştırır.
Fark önbellek okuma satırındadır: PoYo'da Carbon'ın önbellek okumaları Argon'unkinin yarısı fiyatındadır. Bu tasarruf gerçektir ama küçüktür. 1M önbellekli token başına $0.08'dir ve 10.000 ek çıktı token'ı (1M başına $8.00'dan $0.08) bunu sıfırlar. Google, Carbon'ın görev başına Argon'dan daha fazla token harcadığını söylediğinden, daha ucuz önbelleğe rağmen çoğu iş yükünde Carbon'ın görev başına daha pahalı olmasını bekleyin.
Aynı token sayılarıyla bir hesap örneği (400K önbellek okuması, 50K yeni girdi, 20K çıktı):
| Carbon | Argon | |
|---|---|---|
| Hesap | 0.4 × $0.08 + 0.05 × $1.60 + 0.02 × $8.00 | 0.4 × $0.16 + 0.05 × $1.60 + 0.02 × $8.00 |
| Maliyet | $0.272 (54.4 kredi) | $0.304 (60.8 kredi) |
Carbon aynı görev için 20K yerine 30K çıktı token'ına ihtiyaç duyarsa maliyeti $0.352 olur. Bu yüzden token başına maliyeti değil, tamamlanan görev başına maliyeti ölçmelisiniz. Ölçüm betiği aşağıdadır.
Yönlendirme kanıtı olarak kıyaslama farkları
Bunlar Google'ın Gemini 4 Carbon lansman tablosundaki kendi rakamlarıdır; bu yüzden bağımsız bir test olarak değil, üreticinin karşılaştırması olarak değerlendirin. Fark sütunu, ek token'ların nerede karşılığını verdiğini gösterir.
| Kıyaslama | Carbon | Argon | Fark |
|---|---|---|---|
| ExploitGym | 54.8% | 42.0% | +12.8 |
| GraphWalks 256K–1M (BFS F1) | 96.2% | 84.2% | +12.0 |
| AA Intelligence Index v5.0 | 59 | 50 | +9 |
| Agents' Last Exam v1.1 | 77.4% | 69.0% | +8.4 |
| Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | +8.1 |
| OSWorld-2.1 (offline subset) | 81.5% | 74.7% | +6.8 |
| FrontierSWE 2 | 61.2% | 55.0% | +6.2 |
| SWE-sweep | 9.6% | 4.3% | +5.3 |
| SEC-bench Pro | 88.2% | 83.4% | +4.8 |
| RiemannBench | 80.0% | 76.0% | +4.0 |
| CWE-bench | 71.0% | 68.0% | +3.0 |
| AutomationBench (Zapier) | 53.9% | 51.3% | +2.6 |
| Vals Index v2.2 | 70.4% | 69.2% | +1.2 |
Bunu bir yönlendirme tablosu olarak okuyun:
- Büyük farklar: Carbon'a yönlendirin. 256K–1M token arasında uzun bağlamlı bilgi erişimi, terminal odaklı ajan işleri, çok adımlı ajan görevleri ve exploit doğrulama.
- Küçük farklar: Argon'da tutun. İş otomasyonu (+2,6), genel bilgi çalışması (Vals Index, +1,2) ve CWE-bench'te yama üretimi (+3,0). Burada Argon, tur başına daha az token harcarken puanın büyük kısmını alır.
- Siber güvenlik uyarısı. Google'ın siber güvenlik sonuçları Fairwind Program üzerinden erişimi yansıtır ve erişilebilirlik duyurusuna göre siber güvenlik amaçlı Carbon yalnızca bu program aracılığıyla sunulur. Genel API'nin bu puanları yeniden üreteceğini varsaymayın. Kendi görevlerinizde test edin.
Puanları yalnızca aynı tablo içinde karşılaştırın. Argon rehberimiz, Argon için Terminal-Bench 4.0 sonucunu %57,4 olarak veren Google'ın Argon lansman tablosunu aktarır. Carbon tablosu ise Artificial Analysis test düzeneğini kullanır (%57,1).
Yönlendirme stratejisi: varsayılan Argon, gerektiğinde Carbon'a yükseltin
Google'ın önerisi ve kıyaslama farkları aynı tasarıma işaret ediyor:
- Her isteği varsayılan olarak
gemini-4-argonmodeline gönderin. - Zor olduğu bilinen görev türlerini doğrudan
gemini-4-carbonmodeline yönlendirin: depo genelinde hata ayıklama, terminal ajanları, 256K token'dan fazla bağlam üzerindeki sorular ve güvenlik triyajı. - Başarısızlıkta yükseltin. Argon'un yanıtı kontrolünüzden geçemezse (testler, şema doğrulaması, bir değerlendirici) veya
finish_reason: "length"ile durursa, Carbon'da bir kez yeniden deneyin. - Yanıtın 64K token'ı aşması gerekiyorsa Argon'u zorunlu kılın.
Bu yönlendirici, PoYo'nun Chat Completions uç noktasına yönlendirilmiş OpenAI SDK'yı kullanır. Yalnızca belgelenmiş alanları gönderir: model, messages ve max_tokens.
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["POYO_API_KEY"], base_url="https://api.poyo.ai/v1")
ARGON, CARBON = "gemini-4-argon", "gemini-4-carbon"
CARBON_MAX_OUTPUT = 64_000
# PoYo USD per 1M tokens, from the model pages on 2026-11-16
PRICE = {ARGON: (1.60, 8.00), CARBON: (1.60, 8.00)}
# Task types where Google's table shows the widest Carbon lead
CARBON_TASKS = {"repo_debug", "terminal_agent", "long_context_qa", "security_triage"}
def pick_model(task_type: str, max_tokens: int) -> str:
if max_tokens > CARBON_MAX_OUTPUT:
return ARGON
return CARBON if task_type in CARBON_TASKS else ARGON
def call(model: str, messages: list, max_tokens: int) -> dict:
resp = client.chat.completions.create(model=model, messages=messages, max_tokens=max_tokens)
u = resp.usage
price_in, price_out = PRICE[model]
cost = u.prompt_tokens / 1e6 * price_in + u.completion_tokens / 1e6 * price_out
return {
"model": resp.model,
"text": resp.choices[0].message.content,
"finish_reason": resp.choices[0].finish_reason,
"prompt_tokens": u.prompt_tokens,
"completion_tokens": u.completion_tokens,
"cost_usd": round(cost, 6),
}
def run(task_type: str, messages: list, check, max_tokens: int = 16_000) -> list:
"""Returns every attempt so you can log cost per task, including escalations."""
first = pick_model(task_type, max_tokens)
attempts = [call(first, messages, max_tokens)]
a = attempts[-1]
failed = a["finish_reason"] == "length" or not check(a["text"])
if first == ARGON and failed and max_tokens <= CARBON_MAX_OUTPUT:
attempts.append(call(CARBON, messages, max_tokens))
return attempts
check sizin kendi kabul testinizdir; örneğin "yama uygulanıyor ve testler geçiyor" veya "JSON şemama göre ayrıştırılabiliyor". Maliyet tahmini, her istem token'ını önbelleğe alınmamış girdi olarak sayar. PoYo'nun belgelenmiş kullanım alanları önbellekli token'ları ayrıca göstermez; bu yüzden bu değer bir üst sınırdır.
Görev başına maliyeti kendiniz ölçün
Token başına fiyatlar eşit olduğundan iki API'yi ayıran tek sayı kabul edilen görev başına maliyettir. run() içindeki her denemeyi loglayın:
| Loglanacak alan | Chat Completions kaynağı | Gemini Native kaynağı |
|---|---|---|
| Gerçekte kullanılan model | model | URL yolu |
| Girdi token'ları | usage.prompt_tokens | usageMetadata.promptTokenCount |
| Çıktı token'ları | usage.completion_tokens | usageMetadata.candidatesTokenCount + thoughtsTokenCount |
| Çıktı sınırına ulaşıldı mı | finish_reason == "length" | finishReason |
| Kontrolünüzden geçti mi | sizin değerlendiriciniz | sizin değerlendiriciniz |
Google çıktıyı düşünme token'ları dahil fiyatlandırır; bu yüzden Gemini Native'de thoughtsTokenCount değerini çıktı olarak sayın. Akışta, son Chat Completions parçası usage bilgisini taşır. Ardından, her görev türü için:
cost per accepted task = sum(cost_usd of all attempts, incl. escalations) / tasks that passed
Argon varsayılan olacak şekilde bir hafta boyunca gerçek trafik çalıştırın ve doğrudan Carbon'a gönderilen bir örneklemle karşılaştırın. Carbon, Argon'un yükseltme gerektirdiği görevleri geçiyorsa o görev türünü CARBON_TASKS kümesine ekleyin. Carbon'ın bir türdeki başarı oranı Argon'unkiyle aynıysa o türü Argon'da tutun. İlk birkaç yüz çağrı için PoYo panelinizi kendi loglarınızla karşılaştırın.
Başka sağlayıcıların modellerini de değerlendiriyorsanız Gemini 4 Carbon API, Claude Opus 5.5 API ve GPT-6 Astra API karşılaştırmasına bakın. Bütçe korumalı bir ajan döngüsü için kodlama ajanları için Gemini 4 Carbon API yazısına bakın.
Sıkça sorulan sorular
Gemini 4 Carbon API, Gemini 4 Argon API'den daha mı pahalı?
Token başına değil. İkisi de PoYo'da 1M token başına girdi için $1.60, çıktı için $8.00; Google'ın lansman fiyatlandırmasında ise $2.00 / $10.00 tutar. PoYo'da Carbon'ın önbellek okuması daha ucuzdur (1M başına $0.08'e karşı $0.16). Görev başına ise Carbon genellikle daha pahalıdır, çünkü Google'a göre akıl yürütme ve doğrulama için daha fazla token kullanır.
Gemini 4 Argon API'den Gemini 4 Carbon API'ye nasıl geçerim?
Chat Completions'ta "model": "gemini-4-argon" değerini "model": "gemini-4-carbon" olarak değiştirin veya Gemini Native URL yolundaki modeli değiştirin. Carbon için max_tokens değerini 64.000 veya altında tutun.
Gemini 4 Carbon API'nin maksimum çıktısı Argon'a göre nedir?
Carbon, 1M token'lık bağlam penceresiyle yanıt başına en fazla 64K çıktı token'ı döndürür. Argon çok daha uzun tekil yanıtlara izin verir; bu yüzden 64K üzerindeki çıktıları Argon'a yönlendirin.
Kodlama için Gemini 4 Argon mu yoksa Gemini 4 Carbon mu kullanmalıyım?
Google'a göre Argon, yazılım mühendisliğinin çoğu için ideal seçim olmaya devam ediyor. Carbon'ı, Google'ın tablosunun en büyük farkları gösterdiği en zor çok adımlı hata ayıklama ve terminal odaklı ajan işleri için kullanın: Terminal-Bench 4.0 (AA) %65,2'ye karşı %57,1 ve SWE-sweep %9,6'ya karşı %4,3.
Gemini 4 Carbon ve Argon aynı API uç noktasını mı kullanıyor?
Evet. İkisi de aynı PoYo API anahtarıyla POST https://api.poyo.ai/v1/chat/completions (OpenAI uyumlu) ve POST https://api.poyo.ai/v1beta/models/{model}:generateContent veya :streamGenerateContent (Gemini Native) ile çalışır.