Gemini yerel

Akışlı İçerik Üretimi

Google Gemini API formatını kullanarak içerik üretimini akış olarak iletir

POST
/v1beta/models/{model}:streamGenerateContent

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

modelstringpathzorunlu

Model adı (örn. gemini-2.5-pro, gemini-3.5-flash).

Query Parametreleri

keystringquery

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

Stream Chunk
{
  "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..."
          }
        }
      ]
    }
  ]
}

Yetkilendirme

AuthorizationBearer <token>

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*string

Model adı (ör. gemini-2.5-pro)

Sorgu parametreleri

key?string

API anahtarı (başlık kimlik doğrulamasına alternatif)

Başlıklar

X-TokenLab-Delivery-Policy?string

İ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