Gemini native

Stream Generate Content

Melakukan streaming pembuatan konten menggunakan format Google Gemini API

POST
/v1beta/models/{model}:streamGenerateContent

Versi SSE dari Gemini generateContent. Event dapat hanya berisi metadata atau konten perantara tanpa finishReason. Stream berakhir pada EOF alami dan tidak menambahkan penanda [DONE].

Parameter Path

modelstringpathwajib

Nama model (misalnya, gemini-2.5-pro, gemini-3.5-flash).

Parameter Query

keystringquery

API key (alternatif untuk autentikasi header).

Autentikasi

Sama seperti Hasilkan Konten: ?key=, x-goog-api-key, atau Authorization: Bearer.

Body Permintaan

Sama seperti Hasilkan Konten. Ini mencakup array parts multimodal dengan bagian gambar inline_data terstruktur untuk permintaan vision.

Dukungan untuk generationConfig.candidateCount, tools, tipe media, dan field opsional lainnya bergantung pada model yang dipilih.

Respons

Mengembalikan Server-Sent Events Gemini. Event yang hanya berisi metadata, chunk perantara tanpa finishReason, dan EOF alami valid. Stream tidak menambahkan penanda [DONE] Chat Completions. Setiap event adalah baris data: yang memuat satu chunk JSON. Respons selalu berupa SSE; alt=sse diterima tetapi tidak wajib.

Error sebelum event pertama mengembalikan error JSON Gemini dengan kode yang sama seperti Hasilkan Konten.

Permintaan

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"}]
      }
    ]
  }'

Respons

Stream Chunk
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {"text": "Once upon a time"}
        ]
      }
    }
  ]
}

Contoh Input Vision

Permintaan vision streaming menggunakan struktur contents[].parts[] yang sama seperti endpoint non-streaming.

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "Please describe this image." },
        {
          "inline_data": {
            "mime_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

Otorisasi

AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Parameter path

model*string

Nama model (contoh: gemini-2.5-pro)

Parameter query

key?string

Kunci API (alternatif untuk autentikasi header)

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

  • "auto"
  • "verified"
  • "official"

Body permintaan

application/json

Permintaan GenerateContent Gemini asli. Nama ProtoJSON lowerCamelCase dan proto snake_case asli keduanya diterima dan dipertahankan, termasuk permintaan campuran. Jika kedua ejaan dari satu bidang ada, TokenLab tidak menggabungkannya atau memilih prioritas lokal. Bidang yang tidak diketahui diteruskan berdasarkan upaya terbaik.

Respons

text/event-stream

application/json

application/json

application/json

application/json

application/json