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

ServBay AI Gateway (AI Ağ Geçidi), ServBay içinde yerleşik olarak sunulan yerel ve birleşik bir AI sağlayıcı ağ geçididir. Makinenizde bir proxy uç noktası çalıştırarak OpenAI, Anthropic, DeepSeek, Tongyi Qianwen gibi yaklaşık 20 büyük dil modeli sağlayıcısına giden istekleri tek bir giriş noktasında toplar; anahtarları merkezi olarak yönetmenize, kullanım ve maliyetleri izlemenize ve Claude Code, Codex gibi AI kodlama araçlarını tek tıkla yerel ağ geçidine yönlendirmenize yardımcı olur.

Bu belge, AI Gateway'in ne olduğunu, hangi sorunları çözdüğünü ve genel mimarisini tanıtır. Belirli işlemler için aşağıdaki bölümlere bakın:

• Kanalları Yönetme — Sağlayıcıları ekleme ve yapılandırma
• Sanal Anahtarlar — Anahtar oluşturma, yetki sınırlama, döndürme ve iptal etme
• AI Kodlama Araçlarını Tek Tıkla Devralma — Claude Code gibi CLI araçlarını ağ geçidine yönlendirme
• İstatistikler ve İzleme — Kullanım, maliyet ve bütçe
• Uç Noktalar ve Ortam Değişkenleri — Kendi kodunuzdan ağ geçidini çağırma

Genel Bakış

Günlük AI geliştirme sürecinde, farklı projelerde ve farklı araçların yapılandırma dosyalarında dağılmış halde birden fazla sağlayıcıya ait API anahtarına sahip olabilirsiniz; bu durumda hem harcamaları takip etmek hem de tek bir noktadan geçiş yapmak zorlaşır. ServBay AI Gateway tüm bu sorunları tek bir yerde toplar:

• Tek giriş noktası, birden fazla sağlayıcı — Tüm kanalları yapılandırdıktan sonra tüm istekler yerel http://127.0.0.1:11580 üzerinden iletilir; uygulamanızın yalnızca tek bir adresle muhatap olması yeterlidir.
• Gerçek anahtarlar yerine sanal anahtarlar — Ağ geçidi, uygulamalara ve araçlara "sanal anahtarlar" verir. Gerçek sağlayıcı API anahtarları yalnızca ağ geçidi tarafında saklanır ve artık ortalıkta dağılmaz. Sanal anahtarların yetkileri istendiği zaman sınırlandırılabilir, döndürülebilir veya iptal edilebilir.
• Birleşik kullanım ve maliyet görünümü — Ağ geçidinden geçen tüm istekler kaydedilir. Ağ geçidi; istek sayısı, Token kullanımı, maliyet, gecikme ve multimodal kullanım gibi istatistikler sunar ve bütçe yönetimini destekler.
• Popüler AI kodlama araçlarını tek tıkla devralma — Yapılandırma dosyalarını elle değiştirmeye gerek yoktur. Ağ geçidi; Claude Code, Codex, Qwen Code, Kimi CLI, CodeBuddy, opencode, Crush gibi araçları tek tıkla yerel ağ geçidine yönlendirebilir.
• Abonelik hesapları ve kota takibi — Abonelik tabanlı sağlayıcı hesaplarını (örneğin Claude Pro / Max için OAuth yetkilendirmesi) bağlamayı destekler. Ağ geçidi içinde plan bilgilerini, kullanılabilir uç noktaları ve çıktı uzunluğu sınırlarını görsel olarak gösterir; ayrıca çoklu pencere kotalarını (kullanılan / kalan yüzde, kotanın tükenme durumu, sıfırlanma zamanı) gerçek zamanlı olarak takip ederek abonelik bakiyenizi her an bilmenizi sağlar.
• Kanal yeteneklerini algılama ve akıllı yönlendirme — Kanal eklerken ağ geçidi sağlayıcı yeteneklerini otomatik olarak algılar (OAuth yetkilendirme tipi / kodlama planı tipi / kademeli model tipi); onayladıktan sonra algılama sonuçlarına göre üç kademeli ağ geçidi eşlemesini otomatik olarak yazar. Model uyumluluğunu elle tahmin etmenize gerek kalmaz.

Mimari ve Portlar

AI Gateway, her ikisi de yalnızca loopback adresini (127.0.0.1) dinleyen iki yerel hizmetten oluşur:

Port	Amaç	Açıklama
11580	Proxy portu	Uygulamalara yönelik birleşik giriş noktası. Kodunuz ve devralınan AI araçları isteklerini buraya gönderir; ağ geçidi, sanal anahtarın yetkilerine göre isteği ilgili sağlayıcı kanalına yönlendirir.
11581	Yönetim portu	ServBay uygulamasının kanalları, anahtarları ve istatistik verilerini dahili olarak yönetmesi için kullanılır; normalde doğrudan erişilmesine gerek yoktur.

Proxy portu aynı zamanda birden fazla uyumlu formatta uç nokta sunar (OpenAI uyumlu, Anthropic uyumlu, Gemini uyumlu). Ayrıntılar için Uç Noktalar ve Ortam Değişkenleri bölümüne bakın.

Desteklenen Sağlayıcı Kanalları

AI Gateway, kanal eklerken doğrudan seçilebilen, kategorilere ayrılmış yaklaşık 20 sağlayıcı ön ayarı içerir:

• Popüler (Mainstream): OpenAI, Anthropic, Google Gemini, Azure OpenAI, AWS Bedrock, OpenRouter.
• Çin (China): DeepSeek, Tongyi Qianwen, Zhipu GLM, Kimi (Moonshot), Doubao·Volcano, ERNIE Bot, Hunyuan, MiniMax, 01.AI, StepFun. Bunlardan Tongyi Qianwen, Zhipu GLM, Kimi, Doubao·Volcano, Hunyuan, MiniMax, StepFun gibi sağlayıcılar Çin içi / küresel çift bölge uç nokta geçişini destekler.
• 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 hizmet), Custom (tamamen özel).

Tam ekleme ve yapılandırma süreci için Kanalları Yönetme bölümüne bakın.

Ön Koşullar

• macOS veya Windows üzerinde ServBay kurulu ve çalışıyor olmalıdır.
• AI Gateway, ServBay'in katma değerli bir özelliğidir; kanal / anahtar eklemeden önce ServBay hesabınıza giriş yapmanız gerekir. Giriş yapmadıysanız arayüz sizi giriş sürecine yönlendirir.

TIP

AI Gateway, ServBay for macOS ve ServBay for Windows üzerinde aynı işlevlere sahiptir; proxy portu (11580), yönetim portu (11581) ve devralınan araçların yapılandırma dosyası yolları aynıdır. Belgelerde platform farklılıkları varsa ayrıca belirtilir.

Hesap ve Planlar

AI Gateway'in bazı özellikleri ServBay hesap planınıza bağlıdır:

• Kanal / anahtar sayısı üst sınırı — Ücretsiz ve ücretli planlarda oluşturulabilecek kanal ve sanal anahtar sayısı farklıdır. Üst sınıra ulaşıldığında arayüz yükseltme yapmanızı önerir.
• Kota ve bütçe yönetimi — Kotaya (Token / istek sayısı / tutar) göre sınırlama ve bütçe panosu VIP / ücretli özelliklerdir; abonelik yoksa ilgili alan kilitlenir ve yükseltme yapmanız istenir.

Plan ayrıntıları için ServBay Pro ve ServBay Team bölümlerine bakın.

Abonelik Hesapları ve Kota Takibi

AI Gateway, abonelik tabanlı sağlayıcı hesaplarını (örneğin OAuth yetkilendirmesiyle bağlanan Claude Pro / Max gibi) bağlamayı destekler. Böylece bu abonelik kaynaklarını her sağlayıcının web konsoluna giriş yapmadan doğrudan yerel ağ geçidi içinde görüntüleyip yönetebilirsiniz.

Abonelik Hesapları Neler Yapabilir?

• Plan bilgileri tek bakışta — Abonelik planı adını, faturalandırma yapısını ve geçerlilik süresini gösterir.
• Kullanılabilir uç noktalar ve çıktı sınırları — Bu abonelik hesabıyla çağrılabilecek uç noktaların listesini ve her modelin maksimum çıktı uzunluğu sınırını görüntüleyin.
• Çoklu pencere kota takibi — Kullanılan / kalan kota yüzdesini, kotanın şu anda tükenip tükenmediğini ve kota sıfırlanma zamanını görsel olarak göstererek abonelik kaynaklarınızı dengeli bir şekilde dağıtmanıza yardımcı olur.
• Kimlik bilgisi geçersizliği görünür — Abonelik hesabının yetkilendirme kimlik bilgileri süresi dolduğunda veya geçersiz hale geldiğinde arayüzde açıkça işaretlenir ve yeniden yetkilendirme yapmanız hatırlatılır.

Deneysel özellik

Abonelik hesaplarının OAuth yetkilendirmesiyle bağlanması şu anda deneysel bir özelliktir ve desteklenen sağlayıcılar kademeli olarak genişletilecektir. Yetkilendirme sırasında sağlayıcının OAuth akışını tarayıcınızda tamamlamanız gerekir; yetkilendirme token'ı yalnızca yerel olarak saklanır.

Veri Depolama

• Kanal yapılandırmaları, sanal anahtarlar, kullanım istatistikleri ve benzeri veriler ağ geçidi arka uç hizmeti tarafından yerel olarak saklanır.
• Sanal anahtarın düz metni yalnızca oluşturma (veya döndürme) sırasında bir kez gösterilir; sonrasında ağ geçidi yalnızca tanımlama için ön eki saklar. Bu nedenle oluştururken hemen kopyalayıp kaydettiğinizden emin olun.
• Araçlar tek tıkla devralınırken ağ geçidi önce hedef aracın mevcut yapılandırma dosyasını .bak uzantısıyla yedekler, ardından yerel ağ geçidini işaret eden yapılandırmayı yazar; böylece istediğiniz zaman geri dönebilirsiniz.

Tipik Kullanım Akışı

1. ServBay hesabınıza giriş yapın ve AI Gateway'e gidin.
2. Kanallar sayfasında en az bir sağlayıcı kanalı ekleyin (örneğin OpenAI veya DeepSeek), gerçek API anahtarını girin ve bağlantıyı test edin.
3. Sanal Anahtarlar sayfasında bir sanal anahtar oluşturun; kullanılabilir model / kanal ve hız sınırlarını ihtiyacınıza göre belirleyin.
4. Uç Noktalar sayfasında sanal anahtarı uygulamanıza girin veya aynı sayfadaki Tek Tıkla Devralma ile sık kullandığınız AI kodlama aracını devralın.
5. İstatistikler ve İzleme sayfasında kullanım, maliyet ve gecikmeyi izleyin; gerekirse bütçe belirleyin.

Özet

ServBay AI Gateway, "birden fazla sağlayıcı, birden fazla anahtar, birden fazla araç" şeklindeki parçalı AI geliştirme ortamını "tek bir yerel giriş noktası, tek bir sanal anahtar seti, tek bir kullanım görünümü" halinde birleştirir. AI yeteneklerinizi yerelde güvenli bir şekilde merkezi olarak yönetmenize, maliyetleri tam olarak kontrol etmenize ve çeşitli AI kodlama araçlarını minimum maliyetle birleşik ağ geçidine bağlamanıza olanak tanır. Bu, ServBay'in AI-native geliştirmeye yönelik temel yeteneklerinden biridir.