Kısaca
Gemini 4 Hydrogen API, Google’un Gemini API’si ve CometAPI gibi desteklenen üçüncü taraf geçitleri üzerinden kullanılabilir. Önce rotayı seçin: sağlayıcıya özgü özellikler ve hesap kontrolleri için Google’ı, birleşik model geçidi veya OpenAI uyumlu bir istemci için CometAPI’yi kullanın. Küçük bir metin isteğiyle başlayın, ardından akış (streaming), konuşma geçmişi, dosyalar ve araçlar ekleyin.
Python 3.10 veya daha yenisi, seçtiğiniz rota için bir anahtar ve gemini-4-hydrogen erişimi gerekir. İsteğe bağlı JavaScript örneği Node.js 22 veya daha yenisini kullanır. Kimlik bilgilerini eğitim boyunca sunucu ortamında tutun.
Öne Çıkanlar
- Gemini 4 Hydrogen API için model kimliği olarak
gemini-4-hydrogenkullanın. - Google ve CometAPI’nin kimlik bilgileri ve faturalandırması ayrıdır. Anahtarı seçtiğiniz uç noktaya göre eşleştirin.
- Yerel GenerateContent ile başlayın; mevcut bir sohbet istemcisine uyduğunda CometAPI’nin OpenAI uyumlu arayüzünü kullanın.
- Takip yanıtı veya araç sonucu döndürmeden önce imzalar dahil tüm model yanıtını çok turlu geçmişte saklayın.
- Rota seçerken gerçek token kullanımını ve tamamlanan görevleri karşılaştırın; standart token-fiyat örneği fiyatlandırma bölümünde yer alır.
Gemini 4 Hydrogen API Nedir?
Google, 12 Kasım 2026’da Hydrogen’i tanıttı. API, istemleri ve desteklenen dosyaları kabul eder; ardından uygulamanızın işleyeceği üretilmiş metni veya yapılandırılmış fonksiyon çağrılarını döndürür. Modeli kendiniz barındırmanız gerekmez.
Önce yalnızca metin içeren bir istekle başlayın ve araçlar veya dosyalar eklemeden önce dönen metni, bitiş nedenini ve token kullanımını doğrulayın. Bu çalıştıktan sonra tüm iş akışını bir anda kurmak yerine konuşma durumunu veya salt okunur bir iş aracını ekleyin.
Gemini 4 Hydrogen API özellikleri
| Özellik | Google tarafından belgelenen model yeteneği |
|---|---|
| Model Kimliği | gemini-4-hydrogen |
| Girdi | Metin, görseller, ses, video ve desteklenen belgeler |
| Çıktı | Araçlar kullanıldığında yapılandırılmış fonksiyon çağrılarıyla metin |
| Birleşik bağlam bütçesi | Girdi ve çıktıda toplam 1.048.576 token |
| Tek ön plan çıktı bölümü | Akıl yürütme ve fonksiyon çağrıları dahil 65.536 tokene kadar |
| Uygulama özellikleri | Düşünme düzeyi kontrolü, yapılandırılmış çıktı ve fonksiyon çağrısı |
Bunlar model yetenekleridir; her ağ geçidinin her sağlayıcı özelliğini sunduğu garanti edilmez. Aşağıdaki örnekler standart istek alanlarını ve kısa ön plan üretimlerini kullanır.
Google Resmi API’si ve CometAPI
Her iki rota da Gemini isteklerini destekler ancak farklı uç noktalar, kimlik bilgileri ve faturalandırma sistemleri kullanırlar. Sağlayıcıya özgü özellikler için Google’ı; birleşik geçit ya da mevcut uyumlu bir istemci için CometAPI’yi kullanın.
| Karar | Google Gemini Developer API | CometAPI Gemini entegrasyonu |
|---|---|---|
| Yerel API ana makinesi | generativelanguage.googleapis.com | api.cometapi.com |
| Bu rehberdeki API anahtarı | GEMINI_API_KEY | COMETAPI_KEY |
| Hesap ve faturalandırma | Google üzerinden yönetilir | CometAPI üzerinden yönetilir |
| En iyi başlangıç noktası | Google’a özgü özellikler ve hesap kontrolleri | Birleşik model erişimi veya mevcut OpenAI uyumlu istemci |
İki rotayı karşılaştırırken aynı istem ve çıktı bütçesini koruyun ki sonuçlar karşılaştırılabilir olsun. JavaScript ve OpenAI uyumlu alternatifler CometAPI için açıkça yapılandırılmıştır.
Gemini 4 Hydrogen API nasıl kullanılır?
Adım 1: Bir API anahtarı oluşturun
CometAPI için bir hesap oluşturun ve API belirteç konsolunda bir anahtar üretin. Doğrudan Google erişimi için Google AI Studio üzerinden bir Gemini API anahtarı oluşturun. Model erişimini ve seçilen hesabın faturalandırmasını veya mevcut kotasını doğrulayın.
Anahtarı güvenli şekilde saklayın. Bir CometAPI anahtarı Google’ın uç noktasına yapılan isteği doğrulayamaz; bir Google anahtarı da CometAPI isteğini doğrulayamaz.
Seçtiğiniz rota için anahtarı Bash’te ayarlayın; bu atamalardan yalnızca birine ihtiyacınız var.
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
# Or, for direct Google access:
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
Windows’ta PowerShell’de karşılık gelen anahtarı ayarlayın.
$env:COMETAPI_KEY = "YOUR_COMETAPI_KEY"
# Or, for direct Google access:
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY"
Adım 2: cURL ile ilk isteği gönderin
Bash terminalinden CometAPI üzerinden yerel bir metin isteği gönderin.
curl "https://api.cometapi.com/v1beta/models/gemini-4-hydrogen:generateContent" \
-H "x-goog-api-key: $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain how an AI coding agent works in five steps."
}
]
}
],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {
"thinkingLevel": "MEDIUM"
}
}
}'
Alternatif olarak, aynı yerel isteği Google’a doğrudan bir Google API anahtarıyla gönderin.
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-4-hydrogen:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-X POST \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain how an AI coding agent works in five steps."
}
]
}
],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {
"thinkingLevel": "MEDIUM"
}
}
}'
İstek başarılı olduktan sonra üç alanı doğrulayın: görünür metin için candidates[0].content.parts, tamamlama durumu için finishReason ve token kullanımı için usageMetadata. Daha fazla uygulama kodu eklemeden önce kimlik doğrulama veya istek hatalarını düzeltin.
Adım 3: Python İstemcisini yapılandırın ve bir istek gönderin
Python örneklerinin kullandığı paketleri kurun.
python -m pip install requests openai
Bu yardımcı dosyayı hydrogen_client.py olarak kaydedin. PROVIDER’ı CometAPI için cometapi olarak bırakın; doğrudan Gemini Developer API erişimi için google olarak ayarlayın. Sonraki yerel örnekler bu dosyayı içe aktarır, böylece seçilen rotayı korurlar.
Seçilen uç noktayı yapılandırın ve yeniden kullanılabilir istek ve metin yardımcılarını tanımlayın.
import os
import requests
MODEL = "gemini-4-hydrogen"
PROVIDER = "cometapi" # Change to "google" for direct access.
ROUTES = {
"cometapi": ("https://api.cometapi.com", "COMETAPI_KEY"),
"google": ("https://generativelanguage.googleapis.com", "GEMINI_API_KEY"),
}
BASE_URL, KEY_NAME = ROUTES[PROVIDER]
API_KEY = os.environ[KEY_NAME]
URL = f"{BASE_URL}/v1beta/models/{MODEL}:generateContent"
def generate(payload):
response = requests.post(
URL,
headers={"x-goog-api-key": API_KEY},
json=payload,
timeout=120,
)
response.raise_for_status()
return response.json()
def visible_text(data):
candidates = data.get("candidates") or []
if not candidates:
raise ValueError("No candidate returned; inspect promptFeedback.")
candidate = candidates[0]
parts = candidate.get("content", {}).get("parts", [])
text = "".join(
part.get("text", "") for part in parts
if not part.get("thought", False)
)
if not text:
raise ValueError(
f"No visible text; inspect parts and finishReason: "
f"{candidate.get('finishReason')}"
)
return text
Aşağıdakini yardımcı dosyayla aynı dizine hydrogen.py olarak kaydedin. Tamamlanmış bir yanıtı, çıktı kesilmiş bir yanıttan ayırabilmeniz için cevabı, bitiş nedenini ve kullanımı yazdırır.
Yapılandırılmış sağlayıcıyı kullanarak bir metin isteği gönderin.
from hydrogen_client import generate, visible_text
data = generate({
"contents": [{"role": "user", "parts": [{
"text": "Explain API rate limiting in three sentences."
}]}],
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"},
},
})
print(visible_text(data))
candidate = data["candidates"][0]
print("Finish reason:", candidate.get("finishReason"))
print("Usage:", data.get("usageMetadata", {}))
Seçtiğiniz API anahtarını ayarladığınız terminalde betiği çalıştırın.
python hydrogen.py
Cevabı okuyun, ardından üretimin neden durduğunu görmek için finishReason değerini kontrol edin. usageMetadata içinde isteğin kaç token kullandığını kontrol edin. MAX_TOKENS, HTTP isteği başarılı olsa bile yanıtın eksik olabileceği anlamına gelir.
JavaScript veya OpenAI Uyumlu bir İstemci kullanın
Uygulamanıza uygun örneği seçin. Node.js örneği yerel bir Gemini isteği gönderir. OpenAI SDK’sını zaten kullanıyorsanız, aşağıdaki Python örneğine geçin.
Node.js ile JavaScript
Aşağıdakini hydrogen.js olarak kaydedin ve node hydrogen.js çalıştırın. Aynı yerel istek şeklini gönderir ve tüm görünür metin parçalarını çıkarır.
Node.js’ten yerel bir GenerateContent isteği gönderin.
const apiKey = process.env.COMETAPI_KEY;
if (!apiKey) throw new Error("Set COMETAPI_KEY before running this script.");
const baseUrl = "https://api.cometapi.com";
const model = "gemini-4-hydrogen";
async function main() {
const response = await fetch(
`${baseUrl}/v1beta/models/${model}:generateContent`,
{
method: "POST",
headers: {
"Content-Type": "application/json",
"x-goog-api-key": apiKey
},
body: JSON.stringify({
contents: [
{
role: "user",
parts: [
{
text: "Explain how an AI coding agent works."
}
]
}
],
generationConfig: {
maxOutputTokens: 4096,
thinkingConfig: {
thinkingLevel: "MEDIUM"
}
}
})
}
);
if (!response.ok) {
throw new Error(
`API error: ${response.status} ${await response.text()}`
);
}
const data = await response.json();
const candidate = data.candidates?.[0];
const text = (candidate?.content?.parts || [])
.filter(part => !part.thought)
.map(part => part.text || "")
.join("");
if (!text) {
throw new Error(`No visible text; finishReason=${candidate?.finishReason}`);
}
console.log(text);
}
main().catch(console.error);
OpenAI SDK ile Python
Uygulamanız zaten OpenAI SDK’sını kullanıyorsa, CometAPI ayrıca POST /v1/chat/completions uç noktasını sunar. En basit geçiş, API anahtarını, temel URL’yi ve model kimliğini değiştirmektir. Bu rotayı yaygın sohbet iş akışları için kullanın; sağlayıcıya özgü Gemini alanlarına ihtiyacınız olduğunda yerel Gemini uç noktasını kullanın.
CometAPI üzerinden bir Chat Completions isteği oluşturun.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1"
)
response = client.chat.completions.create(
model="gemini-4-hydrogen",
messages=[
{
"role": "user",
"content": "Explain how an AI coding agent works."
}
]
)
print(response.choices[0].message.content)
Yerel örnekler contents ve generationConfig kullanır; Chat Completions ise messages ve kendi istek alanlarını kullanır. Kabul etmeyen bir SDK çağrısına yerel alanları kopyalamak yerine, her isteği tek bir formatta tutun.
Gelişmiş Gemini 4 Hydrogen API Özellikleri
Aşağıdaki örnekler, ayar bölümündeki hydrogen_client.py dosyasını yeniden kullanır, böylece PROVIDER’da seçilen sağlayıcıyla çalışırlar. Aşağıdaki akış örneği, mevcut OpenAI uyumlu bir uygulamaya uyan ayrı CometAPI Chat Completions istemcisini kullanır.
Akıl yürütme ve yapılandırılmış çıktıyı yapılandırın
generationConfig kullanarak thinkingConfig.thinkingLevel değerini LOW, MEDIUM, HIGH veya XHIGH olarak ayarlayın. Hem akıl yürütmeye hem de görünür cevaba yer kalacak bir çıktı bütçesi seçin. Uygulama JSON bekliyorsa, yalnızca doğal dil biçimlendirme isteğine güvenmek yerine responseMimeType ve responseSchema kullanın.
Yerel bir istek için çıktı bütçesini ve akıl yürütme düzeyini ayarlayın.
{
"generationConfig": {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"}
}
}
CometAPI üzerinden yanıtları akışla alın
Akış, tamamlanmış yanıtı beklemek yerine üretilen içeriği artımlı olarak döndürür. Sohbet arayüzleri, kod yardımcıları ve algılanan gecikmenin önemli olduğu uygulamalar için kullanışlıdır.
CometAPI, stream=true ile Chat Completions akışını belgelendirir. Python örneği, akış yanıtlarında oluşabilen choices içermeyen parçaları da ele alır.
OpenAI uyumlu uç nokta üzerinden metni geldiği anda yazdırın.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["COMETAPI_KEY"],
base_url="https://api.cometapi.com/v1"
)
stream = client.chat.completions.create(
model="gemini-4-hydrogen",
messages=[
{
"role": "user",
"content": (
"Write a Python function that validates an email "
"address and explain the main checks."
)
}
],
stream=True
)
for chunk in stream:
if not chunk.choices:
continue
delta = chunk.choices[0].delta
if delta and delta.content:
print(delta.content, end="", flush=True)
print()
Yerel bir istemci için CometAPI, Server-Sent Events ile streamGenerateContent belgesini sunar. Bu rota Chat Completions delta’ları yerine GenerateContent yanıt nesneleri döndürür. Ayrıştırıcıyı rotaya uygun tutun; akış davranışı, yerel Gemini uç noktası ile OpenAI uyumlu bir ağ geçidi arasında değişebilir. Mevcut bir akış istemcisini taşımadan önce uygulamanızın kullandığı tam Hydrogen rotasını test edin.
Çok turlu konuşma geçmişini koruyun
Sonraki istekle birlikte önceki kullanıcı ve model turlarını gönderin. Görünür metinden yeniden oluşturmak yerine modelin tam content nesnesini saklayın; bu, bir sonraki tur için döndürülen metaverileri korur. Örneği paylaşılan yardımcı dosyanın yanına hydrogen_history.py olarak kaydedin.
İlk model yanıtının tamamını koruyarak iki ilgili istek yapın.
from hydrogen_client import generate, visible_text
history = [{"role": "user", "parts": [{
"text": "Suggest a simple queue-based background job architecture."
}]}]
config = {
"maxOutputTokens": 4096,
"thinkingConfig": {"thinkingLevel": "MEDIUM"},
}
first = generate({"contents": history, "generationConfig": config})
print(visible_text(first))
candidate = first["candidates"][0]
if candidate.get("finishReason") != "STOP":
raise RuntimeError("The first turn did not finish normally.")
history.append(candidate["content"])
history.append({"role": "user", "parts": [{
"text": "Now identify three failure scenarios in that design."
}]})
second = generate({"contents": history, "generationConfig": config})
print(visible_text(second))
print("Finish reason:", second["candidates"][0].get("finishReason"))
python hydrogen_history.py çalıştırın. İkinci yanıtın ilk turdaki tasarımı ele alması gerekir. Bu örnekte önceki konuşma önekini değiştirmeden tutun; uzun süre çalışan uygulamalar bağlam sınırları ve sıkıştırma için ayrı bir politikaya ihtiyaç duyar.
Görseller ve PDF’ler gönderin
Hydrogen, görsel ve belge anlamayı destekler. Gemini yerel istek formatında, metin talimatının yanına bir inlineData parçası ekleyin. Bu, ekran görüntüsü analizi, mimari diyagramlar, taranmış formlar ve rapor çıkarımı için kullanışlıdır.
Bu örneği hydrogen_client.py yanında analyze_file.py olarak kaydedin. Tek bir yerel görsel veya PDF gönderir; böylece her iki giriş için de aynı kodu yeniden kullanabilirsiniz. İlk istek için küçük bir dosya kullanın; Base64 istek boyutunu artırır.
Paylaşılan yerel istemciyi kullanarak yerel bir PNG, JPEG veya PDF’yi analiz edin.
import base64
import sys
from pathlib import Path
from hydrogen_client import generate, visible_text
path = Path(sys.argv[1])
mime_types = {
".png": "image/png", ".jpg": "image/jpeg",
".jpeg": "image/jpeg", ".pdf": "application/pdf",
}
mime_type = mime_types.get(path.suffix.lower())
if mime_type is None:
raise ValueError("Choose a PNG, JPEG, or PDF file.")
data = generate({
"contents": [{"role": "user", "parts": [
{"text": "Summarize this file and identify the key findings."},
{"inlineData": {
"mimeType": mime_type,
"data": base64.b64encode(path.read_bytes()).decode("ascii"),
}},
]}],
"generationConfig": {"maxOutputTokens": 4096},
})
print(visible_text(data))
Örnek dosyayı kendi belgeniz veya görselinizle çalıştırın.
python analyze_file.py report.pdf
python analyze_file.py diagram.png
Dosya baytları, bildirilen MIME türüyle eşleşmelidir. Yeniden adlandırılmış bir dosya uzantısı dosyayı dönüştürmez. Bir yükleme reddedilirse, tekrar denemeden önce boyut veya biçim sınırı için hatayı inceleyin; Google barındırmalı bir dosya URI’sinin üçüncü taraf bir ağ geçidi üzerinden erişilebilir olduğunu varsaymayın.
Uygulama kontrollü araçları bağlayın
Fonksiyon çağrısı, modelin uygulamanızın gerçekleştirdiği bir işlemi talep etmesine olanak tanır. Model, yapılandırılmış bir fonksiyon çağrısı döndürür; uygulamanız argümanları doğrular, fonksiyonu yürütür ve sonucu geri gönderir.
Bu örnek küçük, kurgusal bir sipariş veritabanı kullanır. Paylaşılan istemcinin yanına order_agent.py olarak kaydedin. Gidiş-dönüşü uygular, döngüyü dört istekte sınırlar ve imzalar dahil olmak üzere turlar arasında tam model içeriğini korur.
Yerel bir gösterim veritabanına karşı sınırlı bir fonksiyon çağrısı döngüsü çalıştırın.
from hydrogen_client import generate, visible_text
orders = {"DEMO-1001": {"status": "shipped", "carrier": "Example Carrier"}}
tools = [{"functionDeclarations": [{
"name": "lookup_order",
"description": "Retrieve a demonstration order by its order ID.",
"parameters": {
"type": "OBJECT",
"properties": {"order_id": {"type": "STRING"}},
"required": ["order_id"],
},
}]}]
history = [{"role": "user", "parts": [{
"text": "Use lookup_order to check the status of DEMO-1001."
}]}]
for _ in range(4):
data = generate({
"contents": history,
"tools": tools,
"generationConfig": {"maxOutputTokens": 4096},
})
candidates = data.get("candidates") or []
if not candidates or not candidates[0].get("content"):
raise RuntimeError("No model content returned.")
model_content = candidates[0]["content"]
calls = [
part["functionCall"] for part in model_content.get("parts", [])
if "functionCall" in part
]
if not calls:
print(visible_text(data))
break
history.append(model_content) # Preserve all parts and signatures.
results = []
for call in calls:
args = call.get("args", {})
order_id = args.get("order_id") if isinstance(args, dict) else None
if call.get("name") != "lookup_order":
raise ValueError("Unexpected function name.")
if not isinstance(order_id, str) or not order_id:
raise ValueError("order_id must be a non-empty string.")
result = orders.get(order_id, {"error": "Order not found"})
reply = {"name": call["name"], "response": result}
if "id" in call:
reply["id"] = call["id"]
results.append({"functionResponse": reply})
history.append({"role": "user", "parts": results})
else:
raise RuntimeError("Tool-call limit reached before a final answer.")
python order_agent.py çalıştırın. Son yanıt, DEMO-1001 için yerel kaydı yansıtmalıdır. Gerçek bir serviste, bir siparişe erişmeden önce kullanıcıyı yetkilendirin; modelin bir sipariş kimliği seçmesi, izin kanıtı değildir.
Gemini 4 Hydrogen API’nin Maliyeti Ne Kadar?
Aşağıdaki ücretler, 17 Kasım 2026 tarihinde kontrol edilen, milyon token başına USD’dir. Bunlar toplu, öncelikli, önbellekli girdi veya ayrı faturalandırılan araç kullanımı değil, standart önbelleksiz girdi ve çıktı karşılaştırmalarıdır.
| Token türü | Google Global Standart | CometAPI’de Gemini 4 Hydrogen API |
|---|---|---|
| Girdi token’ları / 1M | $1.50 | $1.20 |
| Çıktı token’ları / 1M | $7.50 | $6.00 |
100.000 girdi token’ı ve 10.000 faturalandırılabilir çıktı token’ı için CometAPI tahmini 0.1 × $1.20 + 0.01 × $6.00 = $0.18 olur. Aynı hacimler, Google’ın listelenen standart ücretlerinde $0.225 tutar, bu da %20 fark demektir. Çıktı kullanımına akıl yürütme token’larını dahil edin ve gerçek bir iş akışını tahmin ederken hesabınızın faturalandırılan kullanımını kontrol edin.
Gemini 4 Hydrogen API’ye Nasıl Geçiş Yapılır?
Gemini 3.8 Flash’tan geçişte neler değişir?
Model kimliğini değiştirmeden önce düşünme ayarını, bağlam bütçesini ve istemcinizin her istekte gönderdiği konuşma geçmişini kontrol edin.
| Entegrasyon detayı | Gemini 3.8 Flash | Gemini 4 Hydrogen |
|---|---|---|
| Varsayılan düşünme düzeyi | MEDIUM | HIGH |
| Bağlam hesaplaması | Ayrı girdi ve çıktı sınırları | Tek bir paylaşılan girdi/çıktı bütçesi |
| Çok turlu durum | Mevcut istemcinin geçmiş işleyişini gözden geçirin | Tam model parçalarını ve imzaları koruyun; önek düzenlemeleri özel işlem gerektirir |
Uygulamanız varsayılanlara dayanıyorsa, geçmişi sıkıştırıyorsa veya birkaç araç turu çalıştırıyorsa, belgelenmiş geçiş değişiklikleri en çok önem taşır. Düşünmeyi açıkça ayarlayın ve üretim modelini değiştirmeden önce kısa bir mevcut iş akışını test edin.
Mevcut bir entegrasyonu güncelleyin
Anahtar ve uç noktayı birlikte tutarken yeni model kimliğiyle bir test yapılandırması oluşturun. Her iki yapılandırmayla da aynı temsil edici iş akışını çalıştırın, böylece davranışlarını karşılaştırabilirsiniz.
- Yeni bir metin isteği gönderin ve tamamlanma nedenini ve token kullanımını doğrulayın.
- Tam model yanıt nesnelerini kullanarak çok turlu bir görevi ve bir araç gidiş-dönüşünü yeniden oynatın.
- Karşılaştırmadan önce sınırlamalar bölümünde listelenen uyumsuz kontrolleri kaldırın.
- Geri alma yolunuzu yeni bir konuşmada deneyin; başka bir modelin Hydrogen’ın kaydedilmiş akıl yürütme metaverilerini kabul edeceğini varsaymayın.
Geçişin iş yükünüze yardımcı olup olmadığına karar verin
Yeni yapılandırma, kabul edilebilir görev başına maliyetle görev kalitesi ve gecikme hedeflerini karşıladığında benimseyin. Mevcut istemci zaten bu hedefleri karşılıyorsa, tüm istekleri taşımadan önce bir fayda belirlemek için sınırlı bir pilot uygulama kullanın. Değerlendirme sırasında istemleri, girdileri ve puanlama ölçütlerini tutarlı tutun.
Gemini 4 Hydrogen API Sınırlamaları
Hydrogen geliştirici kılavuzu, mevcut istemcileri etkileyen kısıtlamaları açıklar. Aynı reddedilen yükü yeniden denemek yerine bunları istek oluştururken ele alın.
- Desteklenmeyen alanlar: thinkingBudget, MINIMAL olarak ayarlanmış thinkingLevel, frequencyPenalty, presencePenalty ve birden büyük candidateCount değerlerini kaldırın.
- Yoksayılan örnekleme ayarları: özel temperature, topP ve topK, Hydrogen çıktısını kontrol etmez.
- Önbellekleme: açık cachedContent desteklenmez. Stabil istem önekleri örtük önbelleğe almayı kullanabilir, ancak bu, ağ geçidine özgü bir önbellek indirimi oluşturmaz.
- Uzun çıktı: Bu rehberdeki örnek istemci yalnızca eşzamanlı isteği uygular. Arka planda uzun kod çözme veya sağlayıcıya özgü devam iş akışlarını kapsamıyor.
- Konuşma değişiklikleri: Daha önceki istemlerin veya araç tanımlarının değiştirilmesi akıl yürütme durumunu geçersiz kılabilir. Öneki koruyun veya seçilen rota için belgelenmiş önek uyumsuzluğu davranışını uygulayın.
Yaygın kurulum kontrolleri
| Belirti | İlk kontrol |
|---|---|
| 401 veya 403 | Kimlik bilgisinin uç noktaya ait olduğunu ve seçilen modele erişimi olduğunu doğrulayın. |
| 400 | Hata gövdesini okuyun; desteklenmeyen alanları, hatalı JSON’u ve konuşma metaverilerini inceleyin. |
| Görünür metin yok | promptFeedback, aday parçaları ve finishReason değerini inceleyin; yanıt engellenmiş, eksik veya bir araç talep ediyor olabilir. |
| MAX_TOKENS | Metni potansiyel olarak eksik kabul edin ve onaylamadan önce çıktı bütçesini gözden geçirin. |
| Dosya isteği reddedildi | Gerçek MIME türünü ve seçilen rotanın yük sınırını doğrulayın. |
Beklenmeyen hatalar için, mümkün olduğunda model, rota, durum, zaman damgası ve istek kimliğini kaydedin. API anahtarlarını ve hassas dosya içeriklerini rutin günlüklerin dışında tutun.
SSS
Gemini 4 Hydrogen API oran sınırı hatalarını nasıl yeniden denemeliyim?
HTTP 429 için, eşzamanlılığı azaltın ve sabit bir maksimum deneme sayısıyla üstel geri çekilme ve jitter ile yeniden deneyin. Ağ geçidi sağladığında istek kimliğini saklayın. Geçici olmayan hataları (geçersiz istekler veya kimlik doğrulama hataları) değiştirmeden yeniden denemeyin; CometAPI’nin hata ve yeniden deneme kılavuzu, bunları geçici hatalardan ayırır. Bir zaman aşımı işlem başladıktan sonra meydana gelebileceğinden, uygulama tarafındaki herhangi bir eylemi yinelenen yürütmeye karşı koruyun.
Gemini 4 Hydrogen API’yi doğrudan bir web uygulamasından çağırabilir miyim?
İstekleri kendi backend’iniz üzerinden yönlendirin. Ön uç JavaScript’e gömülü bir anahtar, kod paketlenmiş veya küçültülmüş olsa bile ziyaretçiler tarafından çıkarılabilir. Backend kullanıcıları kimlik doğrulaması yapıp kullanım sınırlarını uygulasın ve model isteğini göndersin. Akış için, artımlı yanıtı yukarı akış API anahtarını ifşa etmeden tarayıcıya iletin.
Kesintiye uğrayan bir Gemini 4 Hydrogen akışını nasıl ele almalıyım?
Yanıt tamamlanana kadar alınan metne kısmi sonuç olarak yaklaşın. Yeni bir istek, yeni bir üretimi başlatır; kesilen akışı aynı tokenda otomatik olarak sürdürmez. Kısmi çıktıyı yeniden denenmiş yanıttan ayrı tutun ve eksik JSON veya bitmemiş araç argümanlarından eylem yürütmeyin. İki üretimi sessizce birleştirmek yerine görünür bir yeniden dene eylemi sunun.
Sonuç
İlk kabul kontrolünüz olarak temsil edici bir görev kullanın: İstek başarılı olmalı, uygulama amaçlanan sonucu çıkarmalı ve kaydedilen token kullanımı bütçenize uymalı. Bir özelliği birer birer ekleyin ve bu kontrolü entegrasyon paketinizde tutun. Küçük, gözlemlenebilir bir istemci, hataları izlenmesi zor büyük bir iş akışından daha kolay genişletilir.

