DEV Community

Cover image for Gemini 4 Neon API nasıl kullanılır?
Tobias Hoffmann
Tobias Hoffmann

Posted on Originally published at apidog.com

Gemini 4 Neon API nasıl kullanılır?

Gemini 4 Neon API, gemini-4-neon model kimliğini kullanır. Modele https://generativelanguage.googleapis.com/v1beta/interactions adresine bir POST isteğiyle, anahtarınızı x-goog-api-key başlığında ve JSON gövdesinde model ile input alanlarını göndererek erişirsiniz. Yalnızca ücretli katmanda çalışır: milyon giriş tokenı başına 3$ ve milyon çıkış tokenı başına 15$ fiyatlanır; varsayılan düşünme seviyesi high şeklindedir.

Apidog'u bugün deneyin

Bu kılavuz, Neon'u farklı kılan yönleri ele alıyor: ücretli katman kurulumu, başka bir Gemini 4 modelinden geçiş, 64K tokenı aşan çıktılar, Neon'u Hydrogen ile eşleştirme ve faturayı kontrol altında tutma. Tüm alan adları Google'ın dokümantasyonundan alınmıştır.

İlk Gemini 4 Neon API çağrınızdan önce neye ihtiyacınız var?

Faturalandırmanın etkinleştirildiği bir projeye ait bir Gemini API anahtarına, gemini-4-neon model kimliğine ve Interactions uç noktasına ihtiyacınız var. Google, Neon'u 18 Kasım 2026'da, Gemini 4 ailesinin ortanca modeli olarak, Hydrogen ile Carbon arasına yerleştirerek yayımladı.

Öğe Değer
Model kimliği gemini-4-neon
Uç nokta generativelanguage.googleapis.com üzerinde POST /v1beta/interactions
Kimlik doğrulama başlığı x-goog-api-key: $GEMINI_API_KEY
API'ler Interactions API ve generateContent
Düşünme seviyeleri low, medium, high (varsayılan), xhigh
Bağlam penceresi 1.048.576 token; giriş, düşünme ve çıkış arasında paylaşımlı
Senkron adım başına çıkış 65.536 token
Uzun çözümleme 1.048.576 token eksi girişinize kadar
Ücretsiz katman Hayır
Ücretli fiyat 1M giriş için 3,00$, 1M çıkış için 15,00$ (düşünme dahil)
Önbelleğe alınmış giriş Örtük önbellekleme yoluyla 1M için 0,15$

PDF'ler, fonksiyon çağırma ve akış için istek yapıları Gemini 4 Hydrogen API kılavuzumuzla aynıdır; yalnızca model kimliğini değiştirin.

Apidog

Neon ile çalışan bir Gemini API anahtarını nasıl alırsınız?

Neon ücretsiz katmanda bulunmadığından, yalnızca bir anahtar yeterli değildir. Anahtarın arkasındaki projede faturalandırma etkin olmalıdır.

  1. Google AI Studio'da API anahtarları sayfasını açın ve yeni bir anahtar oluşturun ya da mevcut bir anahtarı yeniden kullanın.
  2. Anahtarın projemin ücretli katmanda olduğundan emin olun. Google'ın kılavuzu açıkça şöyle diyor: "Neon yalnızca ücretli katmanda kullanılabilir (ücretsiz katmanda değildir)."
  3. Anahtarı dışa aktarın: export GEMINI_API_KEY="YOUR_API_KEY". Google GenAI SDK'ları bunu otomatik olarak okur.
  4. Büyük bir toplu iş planlamadan önce hız limitleri sayfasından ücretli katman hız limitlerinizi kontrol edin.

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

Interactions uç noktasına model ve input gönderin. Bu, Google'ın hızlı başlangıç yapısıdır:

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-4-neon",
    "input": "Review this Go handler for missing error checks and suggest fixes."
  }'
Enter fullscreen mode Exit fullscreen mode

Python SDK ile aynı çağrı (pip install -U google-genai):

from google import genai

client = genai.Client()  # reads GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-4-neon",
    input="Review this Go handler for missing error checks and suggest fixes.",
)

print(interaction.output_text)
print(interaction.usage)
Enter fullscreen mode Exit fullscreen mode

Test ederken her yanıtta usage alanını okuyun: düşünme tokenları 15$'lık çıkış ücretiyle faturalandırılır, dolayısıyla maliyetinizin arttığı yer düşünme tokenlarıdır.

Bu kod parçacıkları Google'ın kılavuzunu takip eder. Bu yazı için bizim tarafımızdan çalıştırılmadılar; yanıt yapısını kendi ilk çağrınızla karşılaştırarak doğrulayın.

Hydrogen veya Carbon'dan geçiş yaptığınızda neler değişir?

Zaten başka bir Gemini 4 modeli çalıştırıyorsanız, geçiş için istek şemasında değişiklik gerekmez. model dizesini değiştirin ve üç şeyi kontrol edin:

Kontrol Neon Hydrogen Carbon ve Argon
Varsayılan düşünme seviyesi high high medium
En yüksek seviye xhigh xhigh high
1M başına giriş / çıkış 3$ / 15$ 1,50$ / 7,50$ Carbon fiyatlandırmasına bakın

Carbon veya Argon'dan geçiş yapıyorsanız, mediumdan higha varsayılan atlama, aynı istemde daha fazla düşünme tokenı anlamına gelir. Eski davranışı istiyorsanız thinking_level değerini açıkça belirleyin:

interaction = client.interactions.create(
    model="gemini-4-neon",
    input="Audit this payment retry queue for race conditions.",
    generation_config={"thinking_level": "medium"},
)
Enter fullscreen mode Exit fullscreen mode

Gemini 3.8 Flash veya daha eski bir sürümden geçiş yapıyorsanız liste daha uzundur. Google'ın geçiş kontrol listesine göre:

  • Düşük çıkış sınırlarını yükseltin. max_output_tokens, düşünme ve cevabı birlikte kapsar. 8.192 gibi sabitlenmiş sınırları kaldırın ya da 65.536'ya yükseltin; daha az harcamanız gerekiyorsa düşünme seviyesini düşürün.
  • minimal değerini kaldırın. Neon bunu bir hata ile reddeder.
  • Örnekleme parametrelerini kaldırın. Sunucu aralık içindeki temperature, top_p ve top_k değerlerini yok sayar; aralık dışı değerler 400 döndürür.
  • Açık önbelleklemeden uzaklaşın. Neon cachedContents veya caches.create desteklemez; dolayısıyla cached_content alanlarını kaldırın.
  • Araçları doğal şekilde tanımlayın. Tanımlı araç olmadan ham JSON araç çağrıları istemek MALFORMED_FUNCTION_CALL hatası döndürebilir. Fonksiyon çağırma veya yapılandırılmış çıktılar kullanın.

Neon'dan 64K'dan fazla token nasıl alınır?

Senkron bir istek, akış olsun ya da olmasın, 65.536 tokenda durur. Tam bir geçiş şartnamesi ve buna bağlı test paketi gibi daha uzun çıktılar için background değerini true yapın ve max_output_tokens değerini 65.536'nın üzerine çıkarın. Google'ın sunucuları daha sonra, sınırınıza ulaşana dek 64K tokenlık adımlarla üretmeye devam eder.

Gemini 4 Neon long decode

İşi başlatın ve id değerini saklayın:

export ID=$(curl -s -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-4-neon",
    "input": "Generate a complete multi-module migration specification and test suite for this service.",
    "background": true,
    "generation_config": {
      "max_output_tokens": 262144,
      "thinking_level": "high"
    }
  }' | jq -r '.id')
Enter fullscreen mode Exit fullscreen mode

Sonra işlem bitene kadar yoklama yapın ve her adımdan gelen metni birleştirin (Python, dışa aktardığınız ID ile):

import os, time

interaction = client.interactions.get(id=os.environ["ID"])
while interaction.status in ("in_progress", "queued"):
    time.sleep(5)
    interaction = client.interactions.get(id=interaction.id)

text = "".join(
    c.text
    for step in interaction.steps if step.type == "model_output"
    for c in step.content if c.type == "text"
)
Enter fullscreen mode Exit fullscreen mode

Google'ın kılavuzundaki üç kural, işlerin ters gitmesini önler:

  1. max_output_tokens olmadan yalnızca background ayarlarsanız, sunucu 65.536 tokenda durur.
  2. Sınır, girdiğiniz token sayısı düşülerek 1.048.576'ya kadar çıkabilir. Google, uzun ve çok adımlı işler için 131.072 veya 262.144 önerir.
  3. Zor istemler birkaç dakika sürebilir. Arka plan modunu kullanın ya da HTTP istemci zaman aşımını en az 15 dakikaya ayarlayın.

Etkileşimleri Google tarafında saklamak istemiyorsanız, uzun çözümleme kılavuzu, en son SDK'larda istemci tarafında devam ettirmeyi de belgeliyor.

Neon'u Hydrogen ile nasıl eşleştirirsiniz?

Muhakeme için Neon'u, hacimli işler için Hydrogen'ı kullanın. Neon bir iş akışını planlar veya inceler; ardından bu etkileşimin id değerini previous_interaction_id olarak tek bir adımı gerçekleştirecek bir gemini-4-hydrogen çağrısına aktarırsınız. Google'ın Cloud geliştirici kılavuzu bu deseni gösteriyor:

plan = client.interactions.create(
    model="gemini-4-neon",
    input="Design a 3-step plan to migrate our REST order service to gRPC in Go.",
    store=True,
)

step = client.interactions.create(
    model="gemini-4-hydrogen",
    input="Implement step 1 (.proto service definition) from the plan.",
    previous_interaction_id=plan.id,
)
print(step.output_text)
Enter fullscreen mode Exit fullscreen mode

Neon + Hydrogen

Hydrogen'ın Neon yerine yazdığı her çıkış tokenı yarı fiyatına mal olur. Gemini 4 Hydrogen orkestratör kılavuzumuz, planlayıcı olarak Carbon ile aynı döngüyü adım adım anlatıyor.

Gemini 4 Neon API maliyetlerini nasıl düşük tutarsınız?

Dört kolunuz var, genelde kâr getirdikleri sırayla:

  1. Geçen en düşük düşünme seviyesini seçin. Google'ın tavsiyesi, değerlendirmelerinizi dört seviyenin hepsinde yüksek bir max_output_tokens değeriyle çalıştırmanız, ardından kalite barınızı karşılayan en düşük thinking_level değerini seçmeniz.
  2. Uzun istemleri yeniden kullanın. Örtük önbellekleme, en az 4.096 tokenlık istemlerde varsayılan olarak çalışır ve önbelleğe alınmış giriş maliyetini milyonda 3,00$dan 0,15$a, yani %95 düşürür. İsteminizin uzun ve sabit kısmını (sistem metni, dokümanlar, şemalar) başa yerleştirin.
  3. Yürütmeyi Hydrogen'a devredin. Yukarıdaki eşleştirme desenine bakın.
  4. Her şeyi sayın. Google, modelin işlediği her tokenı, düşünme tokenları ve grounding kullandığınızda eklenen dahili talimatlar dahil, faturalandırır. Google Search ile grounding de sorgu başına faturalandırılır.

Hızlı bir sağlama kontrolü: 20.000 giriş tokenı ve 8.000 çıkış tokenı içeren bir çağrı (düşünme dahil) girişte 0,06$ ve çıkışta 0,12$ tutar; listedeki fiyatla toplam 0,18$ eder.

Kodlama ajanınızın Neon ve Hydrogen'ı Apidog CLI ile karşılaştırmasına izin verin

Neon, sizin istemleriniz için Hydrogen'ın iki katı fiiline değer mi? Kodlama ajanınızın (Claude Code, Codex, Cursor) tek bir test senaryosu oluşturmasını ve Apidog CLI ile her iki modele karşı çalıştırmasını sağlayın.

Tek seferlik kurulum:

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

Sonra ajanınıza tek bir istem verin:

In Apidog project <projectId>, create an environment "gemini" with base URL
https://generativelanguage.googleapis.com and variables GEMINI_API_KEY,
MODEL (default "gemini-4-hydrogen") and THINKING (default "high"). Add an
endpoint for POST /v1beta/interactions with the x-goog-api-key header from
GEMINI_API_KEY. Create a test case that sends model {{MODEL}}, our code-review
prompt and generation_config.thinking_level {{THINKING}}, and asserts: HTTP 200,
status is "completed", a non-empty model_output step, and usage.total_tokens
exists. Run it for gemini-4-hydrogen and gemini-4-neon, then compare
usage.total_thought_tokens and usage.total_output_tokens.
Enter fullscreen mode Exit fullscreen mode

Ajan, bir şey yazmadan önce her yük şemasını okur ve JSON'unu doğrular:

apidog environment create gemini --project <projectId> --base-url https://generativelanguage.googleapis.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file endpoint.json
apidog endpoint create --project <projectId> --file endpoint.json
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> --env-var "MODEL=gemini-4-hydrogen" -r cli,json
apidog run --test-case <caseId> --project <projectId> -e <envId> --env-var "MODEL=gemini-4-neon" -r cli,json
Enter fullscreen mode Exit fullscreen mode

Her çalıştırmanın tokenlarını ilgili modelin fiyatıyla çarpın; böylece istem için gerçek görev başına maliyet elde edersiniz, lansman yazısı ortalamasını değil. Çalıştırmayı Apidog uygulamasında görmek için --upload-report ekleyin; ya da aynı kontrolü CI'a taşımak için -r cli,json yerine -r junit kullanın. Apidog CLI CI/CD kılavuzu hattı gösterir, Claude Code'da Apidog CLI ise ajan kurulumunu ele alır. Apidog'un Ücretsiz planı 4 kullanıcıya kadar kapsar.

SSS

Gemini 4 Neon model kimliği nedir? gemini-4-neon. Hem Interactions API hem de generateContent ile çalışır.

Gemini 4 Neon API ücretsiz mi? Hayır. Neon yalnızca Gemini API'nin ücretli katmanındadır: milyon giriş tokenı 3$, milyon çıkış tokenı 15$. Google AI Pro ve Ultra aboneleri AI Studio sohbetinde deneyebilir.

Hydrogen kodum Neon ile çalışır mı? Evet. Google, Gemini 4 modelleri arasında geçiş için istek şeması değişikliği gerekmediğini belirtir. model dizesini güncelleyin, ardından varsayılan high düşünme seviyesini isteyip istemediğinize karar verin.

Gemini 4 Neon API'nin maksimum çıktısı nedir? Senkron istek başına 65.536 token. background değeri true yapıldığında ve daha yüksek bir max_output_tokens belirlendiğinde Neon, girişiniz düşülerek 1.048.576 tokenlık pencereye kadar üretim yapabilir.

Gemini 4 Neon, temperature destekliyor mu? Hayır. Sunucu aralık içindeki temperature, top_p ve top_k değerlerini yok sayar, aralık dışı değerler için 400 döndürür. Hız ve maliyet karşılığında kaliteyi dengelemek için thinking_level kullanın.

Neon açık bağlam önbellekleme destekliyor mu? Hayır. İsteklerinizden cached_content alanını kaldırın. Örtük önbellekleme, 4.096 token ve üzeri istemlere otomatik olarak uygulanmaya devam eder; önbelleğe alınmış girişte %95 indirim sağlar.

Top comments (0)