AI Ağ Geçidi Uç Noktaları ve Ortam Değişkenleri

Bir tıkla devralma özelliğini içeren hazır AI araçlarının dışında, kendi uygulama, script veya herhangi bir AI aracınızda da doğrudan AI ağ geçidini çağırabilirsiniz. Bu doküman, ağ geçidinin sağladığı uç nokta formatlarını ve sanal anahtar ile bağlantının nasıl yapılacağını açıklar.

Proxy Uç Noktası

AI Ağ Geçidi proxy servisi http://127.0.0.1:11580 adresinde çalışmaktadır. Farklı sağlayıcıların SDK ve araçlarıyla uyumluluk sağlamak için ağ geçidi aynı port üzerinde çeşitli protokol formatlarında uç noktalar sunar:

Protokol Formatı	Uç Nokta Yolu	Kullanım Senaryosu
OpenAI Uyumlu	http://127.0.0.1:11580/v1	OpenAI API formatındaki tüm SDK/arçlar (örn. /v1/chat/completions)
Anthropic Uyumlu	http://127.0.0.1:11580/v1/messages	Anthropic SDK ve Claude Code gibi araçlar
Gemini Uyumlu	http://127.0.0.1:11580/v1beta	Google Gemini SDK ve Gemini CLI gibi araçlar

Kullandığınız SDK'nın protokolüne göre uygun formatı seçip, isteklerinizi bu uç noktaya yönlendirmeniz yeterlidir. Ağ geçidi, sanal anahtar izinlerine göre isteği ilgili sağlayıcı kanalına yönlendirecektir.

Kimlik Doğrulama: Sanal Anahtar Kullanımı

Tüm ağ geçidi isteklerinde sanal anahtar ile kimlik doğrulaması yapılır; gerçek sağlayıcı anahtarı kullanmak gerekmez. Önce Anahtarlar sayfasında bir sanal anahtar oluşturup, düz metnini kopyalayın.

AI Ağ Geçidi → Uç Noktalar (Endpoints) sayfasında, bir sanal anahtar seçebilir ve ağ geçidi, sık kullanılan araçlar için kopyalanabilir ortam değişkeni örnekleri oluşturur.

Ortam Değişkeni Örneği

Aşağıdaki örneklerde, bir sanal anahtarınız olduğu varsayılmıştır (<sanal anahtarınız> ile gösterilmiştir).

OpenAI Uyumlu SDK / Araçlar

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<sanal anahtarınız>"

Claude Code / Anthropic

# Not: Anthropic protokolü ağ geçidinin kök adresini kullanır, /v1 eklenmez
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<sanal anahtarınız>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<sanal anahtarınız>"

Çağrı Örneği (OpenAI Uyumlu)

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <sanal anahtarınız>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Buradaki model değeri, kanallar bölümünde yapılandırılmış ve ilgili sanal anahtara kullanım izni verilmiş bir model olmalıdır.

Ön Koşullar

• AI Ağ Geçidi proxy servisi çalışıyor durumda olmalı.
• En az bir sağlıklı kanal yapılandırılmış ve ilgili modele/kanala izinli bir sanal anahtar oluşturulmuş olmalı.

Sıkça Sorulan Sorular (SSS)

• S: İsteklerim kimlik doğrulama hatası ile dönüyor, sebep nedir?
  • C: Sanal anahtar kullandığınıza (gerçek sağlayıcı anahtarı değil) emin olun. Ek olarak anahtarınızın süresinin dolmamış ve iptal edilmemiş olduğundan emin olun.
• S: Model kullanılamıyor veya izin yok uyarısı çıkıyor, neden?
  • C: İlgili model bir kanalda yapılandırılmış olmalı ve aktif sanal anahtarınızın "izinli model/kanal" listesinde bulunmalı.
• S: Hangi uç nokta formatını kullanmalıyım?
  • C: SDK'nızın protokolüne göre seçim yapın — OpenAI için /v1, Anthropic için /v1/messages (Base URL sonunda /v1 olmadan), Gemini için /v1beta.
• S: Yerel ağdaki diğer cihazlar ağ geçidine erişebilir mi?
  • C: Varsayılan olarak ağ geçidi yalnızca 127.0.0.1 üzerinde (sadece yerel makine) dinler. Bu, güvenlik sebebiyle önerilen ayardır.

Özet

AI Ağ Geçidi; OpenAI, Anthropic ve Gemini ile uyumlu yerel uç noktalar sağlar ve sanal anahtar ile kimlik doğrulamanın yanı sıra uygulama veya AI aracınızı ağ geçidine entegre ederek tek tip anahtar yönetimi ve kullanım takibinin avantajından yararlanmanızı sağlar. Yaygın CLI araçları için, doğrudan bir tıkla devralma özelliği en pratik yöntemdir.