Jak korzystać z API kompatybilnego z OpenAI w 5 krokach
Korzystanie z API w stylu OpenAI wymaga pięciu ruchów: uzyskaj klucz, zainstaluj SDK, wskaż właściwy base URL, wybierz model i wyślij wiadomości. Oto każdy z nich z kodem do wklejenia.

Kluczowe punkty
- Dowolne SDK OpenAI zadziała tutaj po zmianie base URL na https://api.uncensoredaiapis.com/v1 i użyciu własnego klucza.
- ID modelu to uncensored; główne ścieżki to POST /v1/chat/completions i GET /v1/models.
- Strumieniowanie, tryb JSON i wywoływanie funkcji używają tych samych parametrów co oficjalne API.
- Cennik to $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, a możesz zacząć od $0,50 kredytu próbnego.
Krótka wersja
Jeśli chcesz wiedzieć, jak wywoływać API OpenAI za pomocą usługi niebędącej OpenAI, odpowiedź brzmi, że format zapytania to wspólna konwencja. Klient, który go obsługuje, potrzebuje trzech wartości: gdzie wysyłać zapytania (base URL), kim jesteś (klucz) i który model uruchomić. Zmień te trzy wartości, a ten sam kod zadziała. Ta strona podąża tą konwencją, więc standardowe pakiety Python i Node.js OpenAI oraz zwykłe curl działają z nią.
Bądź jasny co to oznacza i czego nie oznacza. Kompatybilność oznacza zgodność interfejsu. Nie oznacza to, że jest to oficjalna usługa OpenAI ani że uruchamia modele OpenAI. Backend to jeden open-weight model obsługiwany przez niezależnego dostawcę i dostrojony do odpowiadania bez odmów treści dla prawnego użytku dorosłych, a Ty wybierasz go za pomocą ID modelu uncensored. Obsługuje tylko tekst: bez obrazów, audio, embeddingów ani fine-tuningu.
Poniższe pięć kroków zajmują około dziesięciu minut. Jeśli wolisz czytać gotowe fragmenty w kilku językach, zobacz stronę przykłady kodu.
Krok 1: uzyskaj klucz
Zarejestruj się przez Google lub podając adres e-mail i hasło, a następnie otwórz stronicę klucza API. Nowi użytkownicy mogą jednym kliknięciem uzyskać $0,50 kredytu próbnego. Jest on ważny przez 7 dni, limitowany do jednej sztuki na osobę i nie wymaga karty. Skopiuj klucz i zapisz go jako zmienną środowiskową zamiast wklejać go do kodu:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"Klucz próbny jest ograniczony do 2 równoległych zapytań i 60 zapytań na minutę. Klucz z doładowaniem pozwala na 8 równoległych i 300 na minutę. Szczegóły tego, co obejmuje próba, znajdują się w FAQ dotyczący darmowego kredytu próbnego.
Krok 2: zainstaluj SDK i wyślij pierwsze zapytanie
Zainstaluj oficjalny pakiet dla swojego języka. Oba to te same biblioteki, których użyłbyś dla dowolnej usługi w stylu OpenAI:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiTeraz pierwsze wywołanie w Pythonie. Jedyna różnica względem domyślnej konfiguracji to argument base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)I to samo wywołanie w Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Krok 3: zrozum tablicę messages
Modele czatu nie pamiętają niczego między wywołaniami. Każde zapytanie zawiera całą rozmowę jako listę wiadomości, a każda wiadomość ma rolę.
systemustawia zachowanie i styl. Umieść tu osobowość, reguły formatowania i ograniczenia.userzawiera to, o co zapytał użytkownik.assistantzawiera wcześniejsze odpowiedzi modelu. Dodajesz je samodzielnie, kontynuując rozmowę.toolzawiera wynik wywołania funkcji, opisany poniżej.
Aby kontynuować czat, dołącz odpowiedź asystenta i kolejną wiadomość użytkownika do tej samej listy i wyślij ją ponownie. Dlatego długie rozmowy kosztują więcej: każde wywołanie płaci za pełną historię jako tokeny wejściowe. Okno kontekstu mieści 100 000 tokenów łącznie, prompt i completion, więc przycinanie starych wiadomości jest normalną częścią budowania aplikacji czatu.
Przekazywane są przydatne pola próbkowania: temperature, top_p, stop, seed oraz kary częstotliwości i obecności. max_tokens jest opcjonalne. Ustaw je, gdy chcesz ograniczyć długość odpowiedzi i wydatki.
Krok 4: strumieniowanie, tryb JSON i narzędzia
Strumieniowanie
Dodaj stream: true, aby otrzymywać tokeny jako zdarzenia wysyłane przez serwer. Sprawia to, że interfejsy działają szybko, ponieważ tekst pojawia się, gdy model nadal pisze, a użycie jest raportowane na końcu strumienia.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Tryb JSON
Użyj response_format: {"type": "json_object"}, gdy Twój kod parsuje odpowiedź. Opisz również pożądane klucze w prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Wywoływanie funkcji
Przekaż listę tools ze schematami funkcji i opcjonalnie tool_choice. Gdy model chce uruchomić funkcję, odpowiedź zawiera tool_calls. Uruchamiasz funkcję we własnym kodzie i wysyłasz wynik z powrotem jako wiadomość z rolą tool. Wywoływanie funkcji również strumieniuje. To element budujący dla agentów; strona przypadki użycia pokazuje, gdzie się to opłaca.
Krok 5: poznaj limity, koszty i błędy
Po przekroczeniu limitu API zwraca HTTP 429. Kod błędu to rate_limited przy zbyt dużej liczbie zapytań na minutę oraz concurrency przy zbyt dużej liczbie zapytań jednocześnie. Tymczasowe przeciążenie również zwraca 429 z nagłówkiem Retry-After: 5. Żądanie strumieniowe zajmuje miejsce w limicie współbieżności do momentu zakończenia strumienia, więc zamykaj strumienie, których już nie czytasz. Limit rozmiaru ciała żądania wynosi 8 MB. Każda odpowiedź zawiera nagłówki X-Request-Id i X-Balance-USD, a pierwszy z nich służy do zgłaszania problemów w supportcie.
Koszty są proste. Wywołanie czatu z 3000 tokenami wejściowymi i 700 wyjściowymi kosztuje 3000 razy $0,15 za milion, co daje $0,00045, plus 700 razy $0,50 za milion, co daje $0,00035, więc łącznie $0,0008. Tysiąc takich wywołań kosztuje $0,80. Nieudane lub odrzucone zapytania nie są rozliczane, a kredyt nigdy nie wygasa. Strona cennik wymienia doładowania od $20 do $500 z +5% od $50, +10% od $100 i +15% od $200. Możesz zapłacić kryptowalutami (USDT na TRC20, USDC na Base).
Jak to różni się od oficjalnego API
Warte zaplanowania są trzy różnice. Po pierwsze, nazwa modelu: użyj uncensored, a nie nazwy modelu OpenAI. Po drugie, zakres: otrzymujesz tylko chat completions i listę modeli, więc funkcje takie jak generowanie obrazów, mowa, embeddingi i fine-tuning nie są tutaj. Po trzecie, zachowanie: model jest dostrojony tak, aby nie odmawiać prawnym żądaniom dorosłych, więc wyjście może różnić się od silnie filtrowanego asystenta. Jedna reguła nigdy się nie zmienia: brak treści seksualnych z udziałem nieletnich.
Kilka nawyków pomaga od pierwszego dnia. Trzymaj klucz w zmiennej środowiskowej, loguj X-Request-Id każdego wywołania i ustawiaj max_tokens podczas eksperymentów, aby uciekająca odpowiedź nie wydała więcej, niż zaplanowałeś. Gdy budujesz interfejs czatu, strumieniuj odpowiedź i przycinaj stare wiadomości, gdy historia rośnie. Gdy budujesz potok parsujący wyjście, użyj trybu JSON i nadal strzeż parsowania, ponieważ odpowiedź ucięta przy limicie tokenów nie jest poprawnym JSON. I gdy dwie części Twojego programu wywołują API jednocześnie, liczy się to do 8 równoległych zapytań, na które pozwala pełny klucz.
Nie zapomnij o koszcie testowania. Kilka dziesiątek eksperymentów z krótkimi promptami kosztuje znacznie mniej niż cent w sumie, więc $0,50 kredytu próbnego starcza na długo, podczas gdy uczysz się formatu zapytania.
Jeśli przenosisz istniejącą aplikację, przewodnik migracji przeprowadzi Cię przez zmiany po kolei. Prompty wysłane tutaj nie są używane do trenowania. Dla większości aplikacji migracja to trzy wartości z początku tej strony i nazwa modelu.
Więcej przewodników
Pytania i odpowiedzi
Czy potrzebuję oficjalnego SDK OpenAI?
Możesz go użyć, to najprostsza droga. Działa też dowolny klient kompatybilny z OpenAI lub zwykłe HTTP, o ile obsługuje niestandardowy base URL.
Jaką nazwę modelu wysyłam?
Wyślij uncensored. Base URL to https://api.uncensoredaiapis.com/v1.
Czy to oficjalne API OpenAI?
Nie. Postępuje zgodnie z tym samym formatem zapytania, ale model to open-weight model obsługiwany przez niezależnego dostawcę, a usługa jest oddzielona od OpenAI.
Ile kosztuje zapytanie?
Tokeny wejściowe kosztują $0.15 za 1M, a tokeny wyjściowe $0.50 za 1M. Zapytanie z 3000 tokenami wejściowymi i 700 tokenami wyjściowymi kosztuje około $0.0008.
Czy mogę przetestować przed płatnością?
Tak. Po rejestracji możesz jednorazowym kliknięciem odebrać $0,50 kredytu próbnego. Jest ważny przez 7 dni i nie wymaga karty.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień base URL. To cała konfiguracja.