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

Hazır AI araçlarını Tek Tıkla Devralma ile kullanmanın yanı sıra, kendi uygulamalarınızda, betiklerinizde veya herhangi bir AI aracında doğrudan AI Ağ Geçidi'ni çağırabilirsiniz. Bu makale, ağ geçidinin sunduğu uç nokta biçimlerini ve Sanal Anahtarlar ile nasıl bağlanacağınızı açıklar.

Proxy Uç Noktaları

AI Ağ Geçidi'nin proxy hizmeti http://127.0.0.1:11580 adresini dinler. Farklı sağlayıcıların SDK'ları ve araçlarıyla uyumluluk için ağ geçidi, aynı bağlantı noktası üzerinde birden çok protokol biçiminde uç nokta sunar:

Protokol Biçimi	Uç Nokta Yolu	Kullanım Senaryosu
OpenAI Uyumlu	http://127.0.0.1:11580/v1	OpenAI API biçimini kullanan tüm SDK'lar / araçlar (ör. /v1/chat/completions)
Anthropic Uyumlu	http://127.0.0.1:11580/v1/messages	Anthropic SDK ve Claude Code vb.
Gemini Uyumlu	http://127.0.0.1:11580/v1beta	Google Gemini SDK vb.

Kullandığınız SDK'nın protokolüne göre ilgili biçimi seçmeniz ve istekleri ağ geçidi adresine yönlendirmeniz yeterlidir; ağ geçidi, Sanal Anahtarın izinlerine göre istekleri ilgili sağlayıcı Kanalına yönlendirir.

Kimlik Doğrulama: Sanal Anahtarların Kullanımı

Ağ geçidine yapılan tüm istekler, sağlayıcının gerçek anahtarı yerine sanal anahtar ile kimlik doğrulanır. Önce Anahtarlar sayfasından bir sanal anahtar oluşturun ve düz metin halini kopyalayın.

AI Ağ Geçidi → Uç Noktalar (Endpoints) sayfasında bir sanal anahtar seçebilirsiniz; ağ geçidi, yaygın araçlar için doğrudan kopyalanabilir ortam değişkeni parçacıkları oluşturur.

Ortam Değişkeni Örnekleri

Aşağıdaki örnekler, bir sanal anahtarınız olduğunu varsayar (<你的虚拟密钥> olarak gösterilir).

OpenAI Uyumlu SDK / Araçlar

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<你的虚拟密钥>"

Claude Code / Anthropic

# Not: Anthropic protokolü, /v1 olmadan ağ geçidi kök adresini kullanır
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<你的虚拟密钥>"

Gemini

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<你的虚拟密钥>"

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

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <你的虚拟密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Burada model, Kanallar bölümünde yapılandırılmış ve söz konusu sanal anahtarın çağrılmasına izin verilen bir model olmalıdır.

Ön Koşullar

• AI Ağ Geçidi proxy hizmeti çalışıyor olmalıdır.
• En az bir sağlıklı kanal yapılandırılmış ve ilgili model / kanal izinlerine sahip bir sanal anahtar oluşturulmuş olmalıdır.

Sık Sorulan Sorular (SSS)

• S: İstek kimlik doğrulama hatası mı döndürüyor?
  • C: Sanal anahtar kullandığınızdan (sağlayıcının gerçek anahtarı değil) ve anahtarın süresinin dolmadığından / iptal edilmediğinden emin olun.
• S: Model kullanılamıyor veya izin yok mu diyor?
  • C: Bu modelin bir kanalda yapılandırıldığından ve mevcut sanal anahtarın "İzin Verilen Modeller / Kanallar" listesinde bulunduğundan emin olun.
• S: Hangi uç nokta biçimini kullanmalıyım?
  • C: Kullandığınız SDK'nın protokolüne göre seçin — OpenAI tarzı için /v1, Anthropic tarzı için /v1/messages (Base URL /v1 içermez), Gemini tarzı için /v1beta.
• S: Yerel ağdaki diğer cihazlar ağ geçidine erişebilir mi?
  • C: Ağ geçidi varsayılan olarak yalnızca 127.0.0.1 (yalnızca yerel makine) adresini dinler. Bu, güvenlik nedeniyle önerilen ayardır.

Özet

AI Ağ Geçidi, OpenAI / Anthropic / Gemini olmak üzere üç uyumlu biçimde birleşik yerel uç noktalar sunar. Sanal anahtar kimlik doğrulamasıyla birlikte herhangi bir uygulamayı veya AI aracını ağ geçidine bağlayabilir, birleşik anahtar yönetimi ve kullanım istatistiklerinden yararlanabilirsiniz. Yaygın CLI araçları için doğrudan Tek Tıkla Devralma kullanmak daha zahmetsiz olacaktır.