Kluczowe punkty
- Nasz base URL to https://api.uncensoredgptapi.com/v1, a ID modelu to
uncensored. - SDK Python i Node przyjmują base_url lub baseURL; oba odczytują też zmienne środowiskowe.
- Większość niepowodzeń wynika z brakującego /v1, zduplikowanej ścieżki lub starej nazwy modelu.
- GET /v1/models to najszybszy sposób potwierdzenia, że URL i klucz są poprawne.
Co robi base URL
gpt api base_url to adres, który SDK OpenAI dołącza na początku do każdej ścieżki endpointa. Domyślnie oficjalne SDK wysyłają zapytania do serwerów OpenAI. Jeśli ustawisz inny base URL, ten sam kod klienta wysyła ten sam format zapytania do innego serwera obsługującego ten sam protokół.
To wszystko oznacza kompatybilność z OpenAI w praktyce. Nasze API akceptuje POST /v1/chat/completions i GET /v1/models z tymi samymi strukturami JSON, tym samym nagłówkiem Authorization: Bearer i tym samym formatem strumieniowania. Musisz więc zmienić trzy wartości:
- Base URL:
https://api.uncensoredgptapi.com/v1 - Klucz API: klucz z Twojego panelu
- Model:
uncensored
Nasza usługa to niezależny serwis uruchamiający pojedynczy model o otwartych wagach. Nie jest to API OpenAI ani router do innych dostawców, więc nazwy modeli takie jak gpt-4o tutaj nie istnieją. Używaj uncensored wszędzie.
Python z SDK OpenAI
W aktualnym SDK Python przekaż base_url podczas tworzenia klienta.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)Jeśli Twój kod jest starszy i używa openai.api_base, to SDK sprzed wersji 1.0, gdzie ustawienie globalne ma inną nazwę. Aktualizacja pakietu jest zwykle łatwiejsza niż adaptacja. Sprawdź wersję za pomocą pip show openai.
Warto wiedzieć, jak SDK buduje zapytanie. Pobiera Twój base URL, dołącza ścieżkę endpointu taką jak /chat/completions i dodaje nagłówek Authorization: Bearer z Twoim kluczem. To cały mechanizm. Gdy coś się nie powiedzie, wydrukuj lub zaloguj końcowy URL i porównaj go z poleceniem curl w następnej sekcji.
Ten sam klient obsługuje ustawienia timeout i max_retries. Domyślne wartości próbują ponownie kilka razy przy problemach z połączeniem, co jest wystarczające dla większości skryptów. W przypadku limitów zapytań przechwyć wyjątek limitu zapytań zwracany przez SDK i zmniejsz częstotliwość. Żądanie strumieniowe zajmuje slot concurrency do momentu zakończenia, więc fala długich strumieni może przekroczyć limit concurrency, nawet jeśli liczba zapytań na minutę jest niska.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")Czekanie pięciu sekund przy pierwszym retry pasuje do wartości Retry-After: 5 wysyłanej przez API przy tymczasowym przeciążeniu. Dłuższe czekanie przy kolejnych próbach zapobiega obciążaniu endpointu.
Node i curl
SDK Node używa baseURL z wielką literą URL.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);Bez żadnego SDK curl pokazuje dokładnie to, co robi SDK. Pełny URL to base URL plus /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Przeczytanie tego polecenia to najjaśniejszy sposób zrozumienia base URL: wszystko do i włącznie z /v1 to base, a SDK dodaje resztę.
Zmienne środowiskowe
Jeśli nie możesz edytować kodu lub chcesz jednego ustawienia dla kilku skryptów, SDK OpenAI odczytują OPENAI_BASE_URL i OPENAI_API_KEY ze środowiska, gdy nie podano jawnej wartości.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyTo wygodne dla narzędzi, których nie napisałeś. Wszystko zbudowane na SDK OpenAI może odczytać zmienne bez zmian, choć nadal musisz ustawić nazwę modelu na uncensored wewnątrz narzędzia. Jeśli narzędzie ma zhardkodowaną nazwę modelu, potrzebujesz własnego ustawienia lub zmiany w kodzie.
Oddzielanie dwóch endpointów
Wiele projektów testuje jeden endpoint i wdraża drugi, lub przełącza się między nimi przez środowisko. Trzymaj trzy wartości z dala od kodu i odczytuj je z konfiguracji, więc przełączenie to zmiana pliku, a nie edycja kodu.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")Użycie własnych nazw zmiennych zamiast domyślnych SDK zapobiega cichej pułapce: narzędzie, które odczytuje OPENAI_API_KEY z powłoki, wyśle dowolny klucz ustawiony tam do dowolnego base URL ustawionego obok niego. Jeśli masz stary klucz OpenAI w swoim profilu i nowy base URL w projekcie, możesz skończyć z wysyłaniem klucza jednej usługi do drugiej. Różne nazwy wykluczają taką możliwość i pozwalają na pierwszy rzut oka zobaczyć, którego endpointa użyje skrypt.
Traktuj nazwę modelu jako konfigurację. To wartość najczęściej pozostawiana przy zmianie, powodująca najbardziej mylące błędy, ponieważ wszystko inne wygląda poprawnie.
Streaming i narzędzia używają tego samego base URL
Zmiana base URL nie ogranicza funkcji. Strumieniowanie, wywoływanie funkcji i tryb JSON przechodzą przez tę samą ścieżkę /chat/completions, więc kod, który działał z oryginalnym API, nadal działa. Strumieniowanie zwraca zdarzenia wysyłane serwerowo (SSE), a zużycie jest raportowane na końcu strumienia.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()Zabezpieczenie dla chunk.choices ma znaczenie. Ostatni fragment zawierający informacje o zużyciu może nie mieć żadnych elementów w choices, a kod odwołujący się do pustej listy spowoduje błąd przy ostatniej wiadomości. Wywoływanie funkcji strumieniuje się w ten sam sposób, jako częściowe fragmenty tool_calls, które łączysz przed uruchomieniem funkcji, a wyniki wracają jako wiadomości z role: "tool". Tryb JSON przyjmuje response_format={"type": "json_object"}.
Aplikacje i frameworki z polem base URL
Wiele aplikacji udostępnia to samo ustawienie pod różnymi nazwami: adres bazowy API, endpoint, niestandardowy adres URL OpenAI lub host. Zasada się nie zmienia. Wklej base URL wraz z /v1, wklej klucz i wpisz uncensored jako nazwę modelu.
SillyTavern pozwala dodać kompatybilny z OpenAI endpoint. Klasa LangChain ChatOpenAI przyjmuje argument base_url. Inne front-endy nazywają to pole proxy URL lub reverse proxy. Nazwy pól różnią się w zależności od wersji, więc szukaj tej, która przyjmuje URL kończący się na /v1.
Niektóre aplikacje pytają o model z listy rozwijanej wypełnianej przez wywołanie GET /v1/models. Ten endpoint działa tutaj i zwraca listę modeli, więc lista rozwijalna powinna pokazywać uncensored po poprawnym URL i kluczu. Jeśli lista jest pusta, URL lub klucz są błędne.
Gdy aplikacja oferuje pole base URL oraz pole „organizacja” lub „projekt”, pozostaw dodatkowe pola puste. Istnieją one dla oryginalnej usługi i nie mają tu znaczenia. Jeśli aplikacja wymaga klucza zaczynającego się od określonego prefiksu, spróbuj innego typu połączenia, np. opcji uniwersalnej lub niestandardowej kompatybilnej z OpenAI, zamiast ustawienia domyślnego dla oryginalnej usługi.
Niektóre narzędzia desktopowe testują połączenie, żądając konkretnej nazwy modelu od oryginalnego dostawcy, i zgłaszają błąd, nawet gdy endpoint jest poprawny. W takim przypadku pomiń przycisk testu i wyślij rzeczywistą wiadomość. Jeśli odpowiedź nadejdzie, URL, klucz i model są poprawne, a narzędzie po prostu rygorystycznie sprawdza połączenie.
Narzędzia przeglądarkowe mogą też natrafić na reguły cross-origin, ponieważ zapytanie opuszcza stronę dla innego hosta. Jeśli narzędzie webowe zawiedzie w przeglądarce, ale to samo zapytanie działa w curl, uruchom zapytanie z małego serwera, aby klucz został poza kodem po stronie klienta, co jest bezpieczniejszą architekturą w każdym razie.
Typowe błędy i jak je naprawić
Prawie każda nieudana konfiguracja wynika z krótkiej listy.
- Brak /v1. Base URL to
https://api.uncensoredgptapi.com/v1, cały adres do/v1włącznie, a nie tylko nazwa hosta. Bez/v1SDK buduje ścieżki, które nie istnieją. - Podwojona ścieżka. Jeśli wkleisz
.../v1/chat/completionsjako base URL, SDK dołączy ścieżkę ponownie. Podaj tylko bazę. - Końcowy slash. Większość SDK sobie z tym radzi, ale niektóre narzędzia nie. Spróbuj bez niego.
- Stara nazwa modelu. Nazwa modelu taka jak
gpt-4o, który został po oryginalnym kodzie, nie będzie pasować. Ustawuncensored. - Zły klucz. Użyj klucza z tej usługi. Klucz OpenAI nie zadziała tutaj, a nasz nie zadziała na OpenAI.
- Błędy limitu zapytań. HTTP 429 z kodem
rate_limitedoznacza zbyt wiele zapytań na minutę; kodconcurrencyoznacza zbyt wiele naraz. 429 z nagłówkiemRetry-After: 5oznacza tymczasowe przeciążenie, więc poczekaj pięć sekund i ponów żądanie.
Nasz przewodnik rozwiązywania problemów omawia błędy integracji bardziej szczegółowo.
Zweryfikuj konfigurację jednym wywołaniem
Zanim uruchomisz całą aplikację, wywołaj endpoint modeli. Jest tani i potwierdza poprawność adresu URL oraz klucza.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Jeśli zwróci listę zawierającą uncensored, wyślij prawdziwe zapytanie czatu. Dla pełnego klucza spodziewaj się do 8 równoległych zapytań i 300 zapytań na minutę; klucz próbny pozwala na 2 równoległe i 60 na minutę. Każda odpowiedź zawiera X-Request-Id, X-Balance-USD oraz nagłówki limitu zapytań, przydatne podczas debugowania.
Aby uzyskać klucz, zarejestruj się i użyj strony klucza API, gdzie nowi użytkownicy mogą odebrać darmowy kredyt próbny w wysokości $0,50 jednym kliknięciem. Dokumentacja omawia strumieniowanie, wywoływanie funkcji i tryb JSON, gdy połączenie zadziała.
