Yapay zekâ ağ geçidi, birden çok model 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 ve tek bir istek biçimiyle gönderir; ağ geçidi isteği doğru sağlayıcıya yönlendirir. Odak metin modellerindeyse buna LLM ağ geçidi de denir.
Yapay zekâ ağ geçidi ne yapar?
Ağ geçidi, uygulamanız ile model sağlayıcıları arasındaki kontrol düzlemidir. Temel sorumlulukları şunlardır:
| İşlev | Anlamı |
|---|---|
| Birleşik API | Her model için genellikle OpenAI uyumlu tek bir istek/yanıt biçimi sunar; böylece bir kez entegre olursunuz. |
| Sağlayıcı yönlendirme | Her istek için modeli/sağlayıcıyı seçin; istemci kodunu yeniden yazmak yerine bir dizeyi değiştirerek model değiştirin. |
| Yük devretme | Bir sağlayıcı hata verdiğinde veya hız sınırladığında sağlıklı bir upstream'e yeniden deneyin; uygulamanızın kendisinin kodlamak zorunda olmadığı dayanıklılık sağlar. |
| Önbelleğe alma | Tekrarlanan giriş maliyetini azaltmak için aynı veya kararlı istemleri (ör. Anthropic istem önbelleklemesini) yeniden kullanır. |
| Harcama ve hız kontrolü | Tek bir sızmış anahtarın veya kontrolden çıkmış bir döngünün hesabı tüketmesini önlemek için anahtar başına bütçeler ve hız limitleri sunar. |
| Gözlemlenebilirlik ve faturalandırma | Çağrı başına günlük kaydı, token/maliyet kullanımı ve çıkarım ağ geçitleri için tek bir cüzdan ve fatura sağlar. |
Ne zaman kullanmalısınız?
Şunlardan herhangi biri geçerli olur olmaz bir yapay zekâ ağ geçidine yönelin:
- Birden fazla model veya sağlayıcı çağırıyorsunuz. Ağ geçidi, "sağlayıcı eklemeyi" bir yapılandırma değişikliğine dönüştürür.
- Yük devretme istiyorsunuz. Sağlayıcılar yavaşlayabilir; ağ geçidi yeniden dağıtım yapmadan trafiği başka yere yönlendirir.
- Maliyet kontrolüne ve görünürlüğe ihtiyacınız var. Anahtar başına harcama sınırları ve kullanım günlükleri, üç sağlayıcının panosunu okumaktan daha iyidir.
- Tek bir fatura istiyorsunuz. Sağlayıcı başına bir hesap yerine metin, görüntü, video ve ses için tek bir cüzdan kullanırsınız.
Atılacak tek modelli bir prototipte sağlayıcıyı doğrudan çağırabilirsiniz; ancak bir ağ geçidinin arkasından başlamak, sonraki her değişikliği tek satırlık bir düzenleme olarak tutar.
İki tür yapay zekâ ağ geçidi
Bu terim, sorunun farklı yarılarını çözen iki mimariyi kapsar:
| Tür | Sizin sağladığınız | Örnekler | En uygun kullanım |
|---|---|---|---|
| Kendi anahtarını getir (BYO-key) ağ geçidi | Kendi sağlayıcı anahtarlarınız + faturalandırma | Portkey, Helicone, LiteLLM | Zaten sahip olduğunuz hesapların üzerinde yönlendirme, koruma kuralları ve gözlemlenebilirlik |
| Çıkarım ağ geçidi | Hiçbir şey — ağ geçidi erişimi yeniden satar | Kunavo, OpenRouter | Sağlayıcılar arasında tek cüzdan ve tek anahtar; çoğu zaman liste fiyatının altında |
Kendi anahtarını getir ağ geçitleri, mevcut Anthropic, Google ve OpenAI hesaplarınızın üzerine bir kontrol/gözlemlenebilirlik katmanı ekler — anahtarlar hâlâ sizdedir ve her sağlayıcıya ayrı ödeme yaparsınız. Çıkarım ağ geçitleri ise sağlayıcıların kendilerinin önünde yer alır: tek bir bakiyeye yükleme yapar ve hiçbir sağlayıcı konsoluna girmezsiniz. BYO-key tarafı için Kunavo ile Portkey, Helicone ve LiteLLM karşılaştırmasına; edge proxy senaryosu için Kunavo vs Cloudflare AI Gateway karşılaştırmasına; kurumsal API yönetimi senaryosu için Kunavo vs Kong AI Gateway karşılaştırmasına; yönlendirici karşılaştırması için de Kunavo vs OpenRouter karşılaştırmasına bakın.
Kunavo bir yapay zekâ ağ geçidi olarak
Kunavo bir çıkarım yapay zekâ ağ geçididir. https://api.kunavo.com/v1 adresinde OpenAI API protokolüyle uyumludur; bu nedenle 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 erişir — sağlayıcıların liste fiyatlarının yaklaşık %30 altında fiyatlandırılır; $10 yüklemeden başlayan kullandıkça öde modeli ve Stripe üzerinden faturalandırılan tek bir cüzdan sunar.
from openai import OpenAI
# One gateway endpoint + one key reaches every provider.
client = OpenAI(
api_key="sk-kn-...",
base_url="https://api.kunavo.com/v1", # the AI gateway
)
# Same request shape, different providers — just change the model.
for model in ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-terra"]:
r = client.chat.completions.create(
model=model,
messages=[{"role": "user", "content": "One word: ready?"}],
)
print(model, "→", r.choices[0].message.content)Aynı anahtar, Anthropic'in kendi Anthropic Messages API biçimini ve görüntü, video ve ses üretimini de destekler — veri aktarım biçiminin, kod değişikliği yapmadan yerel (Ollama) ve barındırılan modeller arasında geçiş yapmanızı nasıl sağladığını öğrenmek için OpenAI uyumlu API kılavuzuna, ilk çağrınız için de hızlı başlangıç kılavuzuna bakın.
Sık sorulan sorular
Yapay zekâ ağ geçidi nedir?
Yapay zekâ ağ geçidi (LLM ağ geçidi olarak da adlandırılır), birden çok model 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 ve tek bir istek biçimiyle istek gönderir; ağ geçidi sağlayıcı yönlendirmesini, kimlik doğrulamayı, yük devretmeyi, önbelleğe almayı, hız sınırlamasını, harcama kontrollerini ve kullanım günlüklerini yönetir. Anthropic, Google ve OpenAI'yi ayrı ayrı bağlamak yerine bir kez entegre olmanızı sağlar.
Yapay zekâ ağ geçidi ile LLM ağ geçidi arasındaki fark nedir?
Aynı şeydir. 'LLM ağ geçidi' ifadesi metin/sohbet modellerini vurgular; 'yapay zekâ ağ geçidi' ise aynı uç noktanın arkasındaki görüntü, video ve ses modellerini de kapsayan daha geniş terimdir. Kunavo bir yapay zekâ ağ geçididir: Claude ve GPT metin modelleri ile görüntü, video ve ses üretimi için tek bir OpenAI uyumlu API sunar.
Yapay zekâ ağ geçidine ihtiyacım var mı?
Birden fazla model veya sağlayıcı çağırmaya başladığınızda, sağlayıcılardan biri yavaşladığında yük devretmeye ihtiyaç duyduğunuzda, anahtar başına harcama limitleri ve kullanım görünürlüğü istediğinizde veya her sağlayıcı için ayrı hesap yerine tek bir ön ödemeli bakiye istediğinizde kullanın. Tek modelle yapılan bir prototipte sağlayıcıyı doğrudan çağırabilirsiniz; ancak ağ geçidi bunu daha sonra tek satırlık bir değişiklik olarak tutar.
Yapay zekâ ağ geçidi ile OpenRouter gibi bir yönlendirici arasındaki fark nedir?
Yönlendirici, metin isteği için sağlayıcı seçmeye odaklanan bir tür yapay zekâ ağ geçididir. Tam kapsamlı bir yapay zekâ ağ geçidi faturalandırma, çok modlu uç noktalar, önbelleğe alma ve harcama kontrollerini de ekler. Kunavo bir çıkarım ağ geçididir: modele göre liste fiyatının altında, tek bir ön ödemeli cüzdan üzerinden model erişimini yeniden satar ve sohbetin yanı sıra görüntü, video ve sesi de kapsar.