Integracja API & IDE (Cursor / VS Code)

Krok 1: Generowanie Klucza API

Aby połączyć się z klastrem z zewnątrz, potrzebujesz klucza autoryzacyjnego.

Zaloguj się do panelu PrivatAI przez przeglądarkę.
Kliknij ikonę swojego profilu (prawy górny róg) i wybierz Ustawienia (Settings).
Przejdź do zakładki Konto (Account).
W sekcji "Klucze API" kliknij przycisk + Utwórz nowy secret key.
Skopiuj wygenerowany klucz (zaczyna się od sk-...). Będzie potrzebny w następnym kroku.

Krok 2: Konfiguracja w Cursor / VS Code

Nasz klaster jest w 100% kompatybilny ze standardem OpenAI. Wystarczy zmienić adres docelowy.

Parametry połączenia:

API Type / Provider

OpenAI Compatible

Base URL (Adres Bazowy)

https://ai.privatai.pl/ollama/v1

API Key

[Wklej tutaj klucz wygenerowany w Kroku 1]

Model Name

gemma2:latest

*Jeśli używasz konkretnej wersji modelu (np. 27b), sprawdź jej dokładną nazwę w oknie czatu.

Krok 3: Weryfikacja

Po wpisaniu danych, spróbuj wysłać proste zapytanie w oknie czatu Cursora (np. "Hello, are you Gemma?"). Jeśli otrzymasz odpowiedź, połączenie jest aktywne i szyfrowane.

Wszystkie zapytania wysyłane przez API podlegają tym samym zasadom bezpieczeństwa (brak logowania treści, brak trenowania modelu).

Krok 4: Konfiguracja Sieci (Wymagane)

Nasz system chroniony jest przez Cloudflare Zero Trust. Narzędzia developerskie (Cursor, VS Code) nie obsługują logowania przez e-mail/PIN, dlatego Twój adres IP musi zostać dodany do naszej białej listy (Bypass).

👉 Jeśli połączenie nie działa, wyślij swój stały adres biurowy IP na: ai@privatai.pl w celu autoryzacji.