ServBay AI Gateway (AI Geçidi) Tanıtımı

ServBay AI Gateway (AI Geçidi), ServBay platformuna entegre edilen yerel birleşik bir AI tedarikçi geçididir. Makinenizde çalışan bir proxy noktası olarak, OpenAI, Anthropic, DeepSeek, Qwen ve diğer neredeyse 20 büyük model tedarikçisiyle yapılan tüm istekleri tek bir giriş noktasında toplar. Bu sayede API anahtarlarınızı merkezi olarak yönetebilir, kullanım ve maliyetleri izleyebilir ve Claude Code, Codex, Gemini CLI gibi popüler AI programlama araçlarını tek tıkla yerel ağ geçidine yönlendirebilirsiniz.

Bu doküman AI Geçidi’nin ne olduğunu, hangi sorunlara çözüm sunduğunu ve genel mimarisini tanıtır. Ayrıntılı kullanım için şu başvuru sayfalarını inceleyin:

• Kanalları Yönetme — Tedarikçi ekleme ve yapılandırma
• Sanal Anahtarlar — Anahtar oluşturma, yetki sınırlandırma, döndürme ve iptal
• Tek Tıkla AI Programlama Araçlarını Yönlendirme — Claude Code ve benzeri araçları geçide yönlendirme
• İstatistik ve İzleme — Kullanım, maliyet ve bütçe yönetimi
• Uç Noktalar & Ortam Değişkenleri — Kendi kodunuzdan geçidi çağırmak

Genel Bakış

Günlük AI geliştirme süreçlerinizde, birden fazla tedarikçiye ait API anahtarlarınız farklı proje ve araçlarda dağınık halde bulunabilir. Maliyetleri toplu olarak izlemek, tek bir noktadan yönetmek veya hızlıca geçiş yapmak genellikle zordur. ServBay AI Geçidi bu problemleri şöyle çözer:

• Tek giriş, çoklu tedarikçi erişimi — Her kanal için yapılandırmayı yaptıktan sonra, tüm istekler http://127.0.0.1:11580 adresindeki yerel proxy üzerinden geçer; uygulamanız yalnızca bu tek adresi bilmelidir.
• Gerçek anahtarlar yerine sanal anahtar kullanımı — Geçit, uygulama ve araçlar için “sanal anahtarlar” oluşturup iletir; gerçek tedarikçi API anahtarları yalnızca geçitte saklanır, başka yerlere yayılmaz. Sanal anahtarların yetkilerini istediğiniz an sınırlayabilir, döndürebilir ya da iptal edebilirsiniz.
• Birleşik kullanım & maliyet görüntüsü — Geçitten geçen tüm istekler kaydedilir ve istek sayısı, token kullanımı, maliyet, gecikme, multimodal tüketim gibi istatistikler sunar. Ayrıca bütçe yönetimi desteği vardır.
• AI programlama araçlarına tek tıkla yönlendirme — Claude Code, Codex, Gemini CLI, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush ve daha birçok popüler aracı manuel yapılandırmaya gerek kalmadan tek tıkla geçide yönlendirebilirsiniz.

Mimari ve Portlar

AI Geçidi, sadece döngüsel adres (127.0.0.1) üzerinde dinlenen iki yerel servis bileşeninden oluşur:

Port	Kullanım Amacı	Açıklama
11580	Proxy Portu	Uygulamalar için birleşik giriş noktasıdır. Kodunuz ve yönlendirilen AI araçları tüm istekleri buraya gönderir; geçit, sanal anahtara bağlı yetkilerle isteği ilgili tedarikçi kanalına yönlendirir.
11581	Yönetim Portu	ServBay uygulamasının kanal, anahtar ve istatistikleri yönetmesi için kullanılır. Genellikle doğrudan erişim gerekmez.

Proxy portu, OpenAI, Anthropic ve Gemini ile uyumlu birçok uç nokta türünü destekler. Detaylar için bkz. Uç Noktalar & Ortam Değişkenleri.

Desteklenen Tedarikçi Kanalları

AI Geçidinde yaklaşık 20 tedarikçi ön ayarı bulunur ve bunlar kategorilere göre gruplanmıştır. Kanal eklerken kolayca seçim yapabilirsiniz:

• Ana Akım (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Çin (China): DeepSeek, Qwen, Zhipu GLM, Kimi (Moonshot), Doubao / Volcengine, Wenxin Yiyan, Hunyuan, MiniMax, Lingyi Wanwu, StepStar. Qwen, Zhipu GLM, Kimi, Doubao, Hunyuan, MiniMax ve StepStar gibi tedarikçilerde hem Yerel / Küresel iki bölge uç nokta seçeneği bulunur.
• Yerel (Local): Ollama (varsayılan 127.0.0.1:11434), LM Studio (varsayılan 127.0.0.1:1234).
• Özel (Custom): OpenAI Compatible (herhangi bir OpenAI uyumlu servis), Custom (tamamen özelleştirilebilir).

Tüm ekleme ve yapılandırma süreci için bkz. Kanalları Yönetme.

Önkoşullar

• ServBay’i macOS veya Windows işletim sistemine kurmuş ve çalıştırıyor olmalısınız.
• AI Geçidi, ServBay’in ek bir değerli özelliğidir; kanal/anahtar eklemeden önce ServBay hesabınızla giriş yapmanız gerekir. Giriş yapılmamışsa, uygulama arayüzü sizi otomatik olarak yönlendirecektir.

TIP

AI Geçidi'nin macOS ve Windows sürümlerindeki tüm fonksiyonları aynıdır. Proxy portu (11580), yönetim portu (11581) ve yönlendirilen araçların ayar dosya yolları birbirinin aynısıdır. Belgenin ilgili bölümlerinde platforma özgü farklılıklar ayrıca belirtilmiştir.

Hesap ve Paketler

AI Geçidi’nin bazı yetenekleri ServBay hesap paketiniz ile ilişkilidir:

• Kanal / sanal anahtar sayısı sınırı — Ücretsiz ve ücretli paketlerde oluşturulabilecek kanal ve sanal anahtar sayısı farklıdır. Sınıra ulaşıldığında arayüz yükseltmeniz için uyarı verir.
• Kota & bütçe yönetimi — Token / istek sayısı / tutar bazlı kota ve bütçe göstergeleri VIP/Ücretli paketlere dahildir; abone değilseniz ilgili alanlar kilitli olur ve yükseltme bildirimi çıkar.

Paket detayları için ServBay Pro ve ServBay Team belgelerine bakınız.

Veri Saklama

• Kanal, sanal anahtar ve kullanım istatistikleri gibi veriler tamamen yerel olarak, geçidin arka servisleri tarafından saklanır.
• Sanal anahtarların açık hali yalnızca oluşturma (veya döndürme) anında bir kez görüntülenir; sonrasında yalnızca ön ek tanımlayıcı olarak tutulur. Oluştururken mutlaka kopyalayıp saklayınız.
• Araçları yönlendirirken, geçit öncelikle orijinal ayar dosyasını .bak uzantısıyla yedekler ve yenisini yerel geçide yönlendirecek şekilde günceller; böylece her zaman kolayca geri dönebilirsiniz.

Tipik Kullanım Akışı

1. ServBay hesabınızla giriş yapın ve AI Geçidi’ne erişin.
2. Kanallar sayfasında en az bir tedarikçi kanalı ekleyin (ör. OpenAI veya DeepSeek), gerçek API anahtarınızı girip bağlantıyı test edin.
3. Sanal Anahtarlar sayfasında bir sanal anahtar oluşturun, gerekirse kullanılabilir model/kanal ve hız kısıtlama yapın.
4. Uç Noktalar sayfasında sanal anahtarı uygulamanıza girin veya aynı sayfadaki Tek Tıkla Yönlendirme özelliğiyle sık kullandığınız AI programlama araçlarını otomatik yapılandırın.
5. İstatistik & İzleme sayfasında kullanım, maliyet ve gecikmeleri izleyin, gerekiyorsa bütçe sınırları belirleyin.

Sonuç

ServBay AI Geçidi; “çoklu tedarikçi, çoklu anahtar, çoklu araç” ile bölünmüş AI geliştirmesini, “tek yerel giriş noktası, tek sanal anahtar kümesi, birleşik kullanım görüntüsü”ne dönüştürür. Yerelde hem güvenli, hem merkezi yönetimle AI yeteneklerinizi konsolide etmenizi ve maliyetinizi hassas biçimde kontrol etmenizi sağlar. Ayrıca, çeşitli AI programlama araçlarını en düşük maliyetle birleşik geçide bağlamak için eksiksiz bir çözüm sunar; ServBay’in AI-native geliştirme vizyonunun temel taşlarından biridir.