Skip to main content
TokenLab bu rotayı yalnızca yerel Gemini sözleşmesini yayımlayan ve aynı protokolde upstream rotası bulunan modeller için sunar; Chat Completions’a fallback yoktur. ProtoJSON lowerCamelCase ve özgün proto snake_case adlarının ikisi de resmidir ve karma isteklerde de korunur. Bilinmeyen alanlar best-effort iletilir ve desteğe upstream karar verir.

Yol Parametreleri

string
gerekli
Model adı (örneğin, gemini-2.5-pro, gemini-3.5-flash).

Sorgu Parametreleri

string
API anahtarı (header kimlik doğrulamasına alternatif).

Kimlik Doğrulama

Gemini uç noktaları birden fazla kimlik doğrulama yöntemini destekler:
  • ?key=YOUR_API_KEY sorgu parametresi
  • x-goog-api-key: YOUR_API_KEY üst bilgisi
  • Authorization: Bearer YOUR_API_KEY üst bilgisi

İstek Gövdesi

array
gerekli
Konuşma içeriği. role değerleri ve tüm parts gönderildiği gibi korunur; TokenLab trim/lowercase, Base64 yeniden yazımı veya MIME çıkarımı yapmaz. inlineData / inline_data ve fileData / file_data resmi yazımlardır; TokenLab fileData.mimeType alanını yerel olarak zorunlu tutmaz. TokenLab’de oluşturulan Files/Cache kimliklerinde sahiplik denetlenir ve özgün upstream binding korunur; diğer medya ve araç kurallarına sağlayıcı karar verir.
object
Model için sistem talimatı.
object
Yerel üretim yapılandırması. maxOutputTokens, candidateCount, thinkingConfig gibi lowerCamelCase adları ve karşılık gelen snake_case adları değiştirilmeden kabul edilir. TokenLab hata sonrasında thinkingConfig silmez veya streaming için yerel candidateCount sınırı uygulamaz; aralık ve kombinasyonlara upstream karar verir.
array
Güvenlik filtresi ayarları.

Yanıt

array
Oluşturulan içerik adayları.
object
Token kullanım bilgisi.

Çok modlu giriş örnekleri

Gemini çok modlu isteklerinde medyayı contents[].parts[] içine yerleştirin ve satır içi byte ya da URL tabanlı dosya referansı kullanın. Genel Gemini sözleşmesinde şu anda desteklenen medya kategorileri:
  • görsel
  • ses
  • video
Satır içi medya için inlineData veya inline_data kullanın ve Base64 kodlanmış dosya baytlarını gönderin. URL tabanlı medya için fileData veya file_data kullanın ve herkese açık bir https URL’i gönderin.

Görsel giriş örneği

Ses giriş örneği

Video giriş örneği

Video Girdi Örneği

Ses Girdi Örneği