Kılavuzlara dön
Mimari·2 Temmuz 2026·Son güncelleme: 4 Ekim 2026·8 dk okuma

LLM geçidi — her model için tek API: yönlendirme, geri dönüş, faturalandırma ve gözlemlenebilirlik (2026)

LLM geçidi, her model sağlayıcısının önünde duran tek bir API'dir — yönlendirme, geri dönüş, önbellekleme, tek fatura ve anahtar başına harcama denetimi. Ne yaptığını, API geçidinden farkını, iki mimariyi ve Kunavo'nun bunu OpenAI uyumlu biçimde nasıl uyguladığını açıklıyoruz.

Son inceleme tarihi: .

LLM gateway, birçok büyük dil modeli sağlayıcısının önünde duran tek bir API uç noktasıdır. Anthropic, Google ve OpenAI'yi ayrı ayrı entegre etmek — üç SDK, üç anahtar, üç fatura — yerine uygulamanız tek bir temel URL'ye tek bir anahtarla tek bir istek biçimi gönderir; gateway yönlendirir, hata durumunda yeniden dener, kullanımı ölçer ve harcama sınırlarını uygular. Ürününüz ile modeller arasındaki kontrol düzlemidir.

LLM gateway ne yapar?

Üretim amaçlı bir LLM gateway altı sorumluluk taşır. Diğer beşini mümkün kılan ilk sorumluluk, tek ve kararlı bir API yüzeyidir.

YetenekSize sağladıkları
OpenAI uyumlu APIHer model için genellikle /v1/chat/completions olan tek bir istek/yanıt biçimi; böylece yalnızca base_url değiştirerek herhangi bir OpenAI SDK'sı çalışır.
Model yönlendirmeİstek başına sağlayıcı/model seçin; istemci kodunu yeniden yazmak yerine bir dizeyi değiştirerek modelleri değiştirin.
Geri dönüş ve yük devretmeBir sağlayıcı hata verdiğinde, hız sınırına ulaştığında veya performansı düştüğünde sağlıklı bir üst sağlayıcıya yeniden yönlendirin — uygulamanızın kodlamak zorunda kalmayacağı dayanıklılık.
Önbelleğe almaKararlı istemleri yeniden kullanarak (ör. Anthropic istem önbelleklemesi) tekrarlanan giriş maliyetini azaltın; önbellekleri sıcak tutan bağlılık yönlendiricisi kullanın.
Faturalandırma ve harcama kontrolüSağlayıcılar arasında tek cüzdan, anahtar başına bütçeler ve hız sınırları; böylece sızan bir anahtar veya kontrolden çıkan döngü hesabı tüketemez.
GözlemlenebilirlikTokenların, gecikmenin ve maliyetin çağrı başına kaydı — üç sağlayıcı konsolu yerine tek pano.

Tek uç nokta, her sağlayıcı

Gateway, “sağlayıcı eklemeyi” tek dizelik bir değişikliğe dönüştürür. Aynı istemci Claude ve GPT'ye ulaşır — model alanını ayarlayarak yönlendirirsiniz:

llm_gateway.py
from openai import OpenAI

# One LLM gateway endpoint + one key fronts every provider.
gateway = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",  # the LLM gateway
)

# Route by changing a string — no per-provider SDK, key or client.
def ask(model: str, prompt: str) -> str:
    r = gateway.chat.completions.create(
        model=model,
        messages=[{"role": "user", "content": prompt}],
    )
    return r.choices[0].message.content

print(ask("claude-sonnet-5", "Draft a release note."))   # Anthropic
print(ask("claude-haiku-4-5", "Classify this ticket."))    # Anthropic, cheap tier
print(ask("gpt-5-6-terra", "Summarize the thread."))             # OpenAI

LLM gateway ve API gateway karşılaştırması

Geleneksel bir API gateway — Kong, AWS API Gateway, NGINX — genel HTTP'yi yönlendirir ve kimlik doğrulama, kotalar ile hız sınırlamayı yönetir. Bir LLM gateway model trafiği için özel olarak tasarlanmıştır: tokenları ve akışı anlar, istem önbelleklemesi ve model yönlendirmesi yapar, harcamayı anahtar başına ölçer ve (çıkarım gateway'lerinde) kullanımı faturalandırır. Birlikte kullanılabilirler — bazı ekipler LLM gateway'i mevcut API gateway'lerinin arkasına koyar. Kavramsal derinlemesine inceleme için AI gateway nedir? bölümüne, kurumsal API yönetimi durumu için Kunavo ve Kong AI Gateway karşılaştırmasına bakın.

İki tür LLM gateway

Kategori, sağlayıcı ilişkisini kimin yönettiğine göre ayrılır:

TürSizin sağladığınızÖrneklerEn uygun kullanım
Kendi anahtarını getir (BYO-key) ağ geçidiKendi sağlayıcı anahtarlarınız + faturalandırmaPortkey, Helicone, LiteLLM (açık kaynak)Sahip olduğunuz hesaplar üzerinde yönlendirme, güvenlik kuralları ve gözlemlenebilirlik
Çıkarım ağ geçidiHiçbir şey — ağ geçidi erişimi yeniden satarKunavo, OpenRouterSağlayıcılar arasında tek cüzdan ve tek anahtar; çoğu zaman liste fiyatının altında

Kendi anahtarınızı getirdiğiniz gateway'ler, mevcut Anthropic, Google ve OpenAI hesaplarınızın üzerine kontrol ve gözlemlenebilirlik katmanı ekler — bu anahtarlar hâlâ sizdedir. Çıkarım gateway'leri sağlayıcıların önünde durur: tek bakiyeye para yükler, sağlayıcı konsoluna hiç dokunmazsınız. Tam karşılaştırmalar için Kunavo ve Portkey, Helicone, LiteLLM ve OpenRouter karşılaştırmalarına bakın.

Güvenlik ve uyumluluk

Bir ağ geçidi güvenliği uygulamak için de doğal bir yerdir: anahtarlar sunucunuzdan hiç çıkmaz, anahtar başına harcama sınırları ve hız limitleri etki alanını sınırlar, merkezi günlük kaydı ise tek bir denetim izi sağlar. Düzenlemeye tabi dağıtımlarda Kunavo'nun sunmadıklarını bilin: DPA, Zero Data Retention ve AB veri yerleşimi yoktur. İstekler ABD'de işlenir ve kendi saklama politikaları uygulanan üst model sağlayıcılarına iletilir; DPA, ZDR veya AB veri yerleşimine ihtiyacınız varsa Anthropic, OpenAI ya da Google ile kurumsal şartları altında doğrudan sözleşme yapın. Bölge bazlı uygulama kılavuzu AI uyumluluk kılavuzu bölümündedir.

LLM gateway olarak Kunavo

Kunavo bir çıkarım LLM gateway'idir. https://api.kunavo.com/v1'de OpenAI kablo biçimiyle uyumludur; dolayısıyla kodunuz OpenAI API'sini çağırabiliyorsa yalnızca temel URL'yi değiştirerek Kunavo'yu çağırabilir. Tek bir sk-kn- bearer token Claude, GPT ve kataloğun geri kalanına ulaşır — sağlayıcıların liste fiyatlarının yaklaşık 30% altında fiyatlandırılır; $10 yüklemeden itibaren kullandıkça öde modeli ve tek bir Stripe faturalı cüzdan sunar. Metnin yanı sıra aynı anahtarla görüntü, video ve ses üretimini de sağlar.

hızlı başlangıç ile başlayın; kablo biçiminin yerel (Ollama) ve barındırılan modeller arasında kod değişikliği olmadan geçiş yapmanızı nasıl sağladığını öğrenmek için OpenAI uyumlu API kılavuzuna, iş yükünün maliyetini tahmin etmek için LLM maliyet hesaplayıcısına bakın — veya Claude ve OpenAI taraflarını kendi önbellekleme kurallarıyla fiyatlandıran diğer ücretsiz maliyet araçlarını kullanın. Bir kodlama istemcisini tek bir sağlayıcıya bağlanmak yerine sağlayıcılar arasında değiştiriyorsanız CC Switch kurulumu bunu gateway tarafında ele alır.

Sık sorulan sorular

LLM gateway nedir?

LLM gateway, birçok büyük dil modeli sağlayıcısının önünde duran tek bir API uç noktasıdır. Uygulamanız tek bir temel URL'ye tek bir anahtarla tek bir istek biçimi gönderir; gateway model yönlendirme, yük devretme, önbellekleme, hız sınırlama, harcama kontrolleri, kullanım kaydı ve faturalandırmayı yönetir. Anthropic, Google ve OpenAI'yi ayrı ayrı bağlamak yerine bir kez entegre olursunuz.

LLM gateway ile API gateway arasındaki fark nedir?

Geleneksel bir API gateway (Kong, AWS API Gateway) genel HTTP trafiğini yönlendirir ve kimlik doğrulama, hız sınırlama ile kotaları yönetir. LLM gateway model trafiği için özel olarak tasarlanmıştır: OpenAI chat-completions kablo biçimini konuşur, tokenları ve akışı anlar, istem önbelleklemesi, model yönlendirme ve anahtar başına harcama sınırları uygular; çıkarım gateway'leri için kullanımı ölçer ve faturalandırır. Bazı kuruluşlar LLM gateway'i mevcut API gateway'lerinin arkasına koyar.

En iyi LLM gateway hangisidir?

Kendi sağlayıcı anahtarlarınızı getirip getirmek istemediğinize bağlıdır. Kendi anahtarınızı getirdiğiniz gateway'ler (Portkey, Helicone, LiteLLM), zaten sahip olduğunuz hesapların üzerine yönlendirme ve gözlemlenebilirlik ekler. Çıkarım gateway'leri (Kunavo, OpenRouter), model erişimini tek bir ön ödemeli cüzdanda yeniden satar. Kunavo, modele bağlı olarak sağlayıcıların liste fiyatlarının altında, görüntü, video ve sesi de kapsayan OpenAI uyumlu bir çıkarım LLM gateway'idir.

Açık kaynaklı bir LLM gateway var mı?

Evet — LiteLLM, kendi anahtarlarınızla çalıştırdığınız yaygın açık kaynaklı, kendi kendine barındırılan seçenektir. Kunavo barındırılır; çalıştırmanız gereken hiçbir şey yoktur ve tüm modeller arasında tek bakiye kullanır.