Entegrasyon rehberleri · 2026-05-22

Gemini API OpenAI uyumlu rehber: base URL ve model seçimi

Gemini API OpenAI uyumlu kullanımını, base URL mantığını, reasoning ayarlarını, model seçimini ve LLMTR gateway üzerinden Google modellerine geçişi açıklayın.

Gemini API OpenAI uyumlu akışında uygulama istemcisi, base URL, LLMTR gateway ve Google model seçeneklerini gösteren entegrasyon diyagramı.

Gemini API OpenAI uyumlu ne demektir?

OpenAI uyumluluğu, geliştiricinin mevcut OpenAI istemci kütüphanesini kullanırken hedef endpoint'i Gemini veya gateway adresine yönlendirebilmesi anlamına gelir. Bu yaklaşım SDK değişimini azaltır, fakat model davranışlarının birebir aynı olduğu varsayılmamalıdır.

Google'ın uyumluluk yüzeyi base URL, chat completions, streaming, function calling, embeddings ve bazı multimodal akışlarda OpenAI benzeri kullanım sağlar. LLMTR tarafında ise Google modelleri katalog ve gateway kurallarıyla birlikte sunulur.

Base URL ve model ID ayrımı

Base URL hangi gateway'e istek atılacağını belirler. Model ID ise gateway'in hangi sağlayıcı ve native modele yönleneceğini söyler. LLMTR'de canonical ID formatı provider/model şeklindedir ve model detay sayfasından alınmalıdır.

  • İstemci tarafında endpoint path'ini genellikle SDK ekler.
  • API key LLMTR anahtarıysa Authorization header LLMTR tarafından doğrulanır.
  • Google'a özgü reasoning veya multimodal davranışlar model detayında ayrıca kontrol edilir.

Reasoning ve multimodal kontrolü

Gemini ailesinde thinking veya reasoning ayarları modele göre farklılaşabilir. Bazı modellerde düşünme seviyesi kapatılamaz, bazılarında bütçe veya seviye olarak ayarlanır. Bu yüzden kodda tek bir varsayım yapmak yerine model detayını ve gateway davranışını kontrol etmek gerekir.

LLMTR üzerinde test akışı

Önce metin tabanlı küçük bir chat isteği gönderin. Ardından streaming, görsel giriş veya structured output gibi üretim ihtiyacınız olan özellikleri ayrı ayrı test edin. Böylece endpoint uyumluluğu ile model kabiliyeti birbirine karıştırılmaz.

Gemini modelini LLMTR gateway üzerinden test etme

OpenAI uyumlu istemciyle Google modeline geçmeden önce base URL, API key, model ID ve özellik kontrollerini doğrulayın.

  1. Google modelini katalogdan seçin. Modelin chat, streaming, vision veya diğer ihtiyaç duyduğunuz operasyonları desteklediğini kontrol edin.
  2. İstemci base URL değerini ayarlayın. OpenAI uyumlu istemcide base URL değerini LLMTR gateway adresine alın ve LLMTR API anahtarını kullanın.
  3. Küçük metin isteği gönderin. Önce kısa bir chat completions isteğiyle kimlik doğrulama, model ID ve yanıt formatını doğrulayın.
  4. Özellikleri ayrı ayrı test edin. Reasoning, streaming, görsel giriş veya structured output ihtiyacınız varsa her birini ayrı test isteğiyle doğrulayın.

Sık sorulan sorular

Gemini API OpenAI uyumluysa doğrudan aynı parametreler çalışır mı?

Temel alanlar çoğu akışta benzerdir, ancak reasoning, dosya, video veya modele özgü alanlarda farklılık olabilir. Model detayını kontrol etmek gerekir.

LLMTR'de Google modelini nasıl seçerim?

Model katalogunda Google sağlayıcısını filtreleyip public model detayındaki canonical ID değerini kullanırsınız.

İlgili yazılar