Gemini yerel
Akışlı İçerik Üretimi
Google Gemini API formatını kullanarak içerik üretimini akış olarak iletir
Gemini generateContent özelliğinin SSE sürümüdür. Olaylar yalnızca meta veri veya finishReason içermeyen ara içerikler barındırabilir. Akış doğal EOF noktasında sona erer ve sonuna bir [DONE] işareti eklemez.
Path Parametreleri
Model adı (örn. gemini-2.5-pro, gemini-3.5-flash).
Query Parametreleri
API anahtarı (header ile kimlik doğrulamaya alternatif).
Kimlik Doğrulama
İçerik Üretimi ile aynıdır: ?key=, x-goog-api-key veya Authorization: Bearer.
İstek Gövdesi
İçerik Üretimi ile aynıdır. Bu, vision istekleri için yapılandırılmış inline_data görsel parçalarını içeren çok modlu parts dizilerini de kapsar.
generationConfig.candidateCount, araçlar, medya türleri ve diğer isteğe bağlı alanlara yönelik destek, seçilen modele bağlıdır.
Yanıt
Gemini Server-Sent Events döndürür. Yalnızca meta veri içeren olaylar, finishReason içermeyen ara parçalar ve doğal EOF geçerlidir. Akış, Chat Completions'ın [DONE] işaretçisini eklemez. Her olay, bir JSON parçasını tutan bir data: satırıdır. Yanıt her zaman SSE biçimindedir; alt=sse kabul edilir ancak zorunlu değildir.
İlk olaydan önceki bir hata, İçerik Üretimi ile aynı kodlara sahip bir JSON Gemini hatası döndürür.
İstek
curl -N -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:streamGenerateContent?key=sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Tell me a story"}]
}
]
}'Yanıt
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{"text": "Once upon a time"}
]
}
}
]
}Görsel Girdi Örneği
Akışlı görsel (vision) istekleri, akışsız uç nokta ile aynı contents[].parts[] yapısını kullanır.
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inline_data": {
"mime_type": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.
Konum: header
Yol parametreleri
Model adı (ör. gemini-2.5-pro)
Sorgu parametreleri
API anahtarı (başlık kimlik doğrulamasına alternatif)
Başlıklar
İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.
Geçerli değerler
- "auto"
- "verified"
- "official"
İstek gövdesi
application/json
Yerel Gemini GenerateContent isteği. ProtoJSON lowerCamelCase ve orijinal proto snake_case isimlerinin her ikisi de kabul edilir ve korunur; karma istekler dahil. Bir alanın her iki yazımı da mevcutsa, TokenLab bunları birleştirmez veya yerel bir öncelik belirlemez. Bilinmeyen alanlar en iyi çaba esasına göre iletilir.
Yanıt
text/event-stream
application/json
application/json
application/json
application/json
application/json