Punkty końcowe bramy AI i zmienne środowiskowe

Oprócz przejęcia jednym kliknięciem gotowych narzędzi AI, możesz również bezpośrednio wywoływać bramę AI we własnych aplikacjach, skryptach lub dowolnych narzędziach AI. W tym artykule opisano formaty punktów końcowych udostępnianych przez bramę oraz sposób podłączania się za pomocą kluczy wirtualnych.

Punkty końcowe proxy

Usługa proxy bramy AI nasłuchuje na http://127.0.0.1:11580. Aby zapewnić zgodność z zestawami SDK i narzędziami różnych dostawców, brama udostępnia na tym samym porcie punkty końcowe w różnych formatach protokołów:

Format protokołu	Ścieżka punktu końcowego	Zastosowanie
Zgodny z OpenAI	http://127.0.0.1:11580/v1	Dowolny zestaw SDK / narzędzie korzystające z formatu OpenAI API (np. /v1/chat/completions)
Zgodny z Anthropic	http://127.0.0.1:11580/v1/messages	Anthropic SDK, Claude Code itp.
Zgodny z Gemini	http://127.0.0.1:11580/v1beta	Google Gemini SDK itp.

Wystarczy wybrać odpowiedni format zgodnie z protokołem używanego zestawu SDK i skierować żądania na adres bramy. Brama na podstawie uprawnień klucza wirtualnego przekieruje żądanie do odpowiedniego kanału dostawcy.

Uwierzytelnianie: używanie kluczy wirtualnych

Wszystkie żądania do bramy są uwierzytelniane za pomocą klucza wirtualnego, a nie prawdziwego klucza dostawcy. Najpierw utwórz klucz wirtualny na stronie Klucze i skopiuj jego jawną wartość.

Na stronie Brama AI → Punkty końcowe (Endpoints) możesz wybrać klucz wirtualny, a brama wygeneruje gotowe do skopiowania fragmenty zmiennych środowiskowych dla popularnych narzędzi.

Przykłady zmiennych środowiskowych

Poniższe przykłady zakładają, że masz już klucz wirtualny (oznaczony jako <twój klucz wirtualny>).

Zestawy SDK / narzędzia zgodne z OpenAI

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

Claude Code / Anthropic

# Uwaga: protokół Anthropic używa adresu głównego bramy, bez /v1
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="<你的虚拟密钥>"

Przykład wywołania (zgodny z OpenAI)

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": "你好"}]
  }'

Pole model musi wskazywać model, który został skonfigurowany w kanałach i do którego wywołania ten klucz wirtualny ma uprawnienia.

Wymagania wstępne

• Usługa proxy bramy AI jest uruchomiona.
• Skonfigurowano co najmniej jeden sprawny kanał i utworzono klucz wirtualny z odpowiednimi uprawnieniami do modeli / kanałów.

Często zadawane pytania (FAQ)

• P：Żądanie zwraca błąd uwierzytelniania?
  • O：Upewnij się, że używasz klucza wirtualnego (a nie prawdziwego klucza dostawcy) oraz że klucz nie wygasł i nie został unieważniony.
• P：Model jest niedostępny lub brak uprawnień?
  • O：Sprawdź, czy dany model jest skonfigurowany w którymś kanale i czy bieżący klucz wirtualny ma go na liście „Dozwolone modele / kanały”.
• P：Którego formatu punktu końcowego użyć?
  • O：Wybierz zgodnie z protokołem używanego zestawu SDK — dla stylu OpenAI użyj /v1, dla stylu Anthropic użyj /v1/messages (Base URL bez /v1), dla stylu Gemini użyj /v1beta.
• P：Czy inne urządzenia w sieci lokalnej mogą uzyskać dostęp do bramy?
  • O：Domyślnie brama nasłuchuje tylko na 127.0.0.1 (tylko lokalnie). Jest to zalecane ustawienie ze względów bezpieczeństwa.

Podsumowanie

Brama AI udostępnia jednolite lokalne punkty końcowe w trzech formatach zgodnych z OpenAI / Anthropic / Gemini. Dzięki uwierzytelnianiu kluczem wirtualnym możesz podłączyć do bramy dowolną aplikację lub narzędzie AI, korzystając z jednolitego zarządzania kluczami i statystyk użycia. W przypadku popularnych narzędzi CLI łatwiej jest użyć przejęcia jednym kliknięciem.