Endpointy API kompatybilne z OpenAI: co jest wspierane
Lista endpointów API kompatybilnego z OpenAI obsługiwanych przez tę usługę, z działającymi zapytaniami dla każdego i prostą listą tego, czego brakuje.
Kluczowe punkty
- Pięć ścieżek: chat completions, responses, modele i dwie ścieżki do salda.
- ID modelu to uncensored, a jeden klucz działa z dowolnym SDK OpenAI.
- Brak obrazów, audio, wideo, embeddings ani fine-tuning.
- Limity zwracają HTTP 429 z jasnym kodem błędu.

Endpointy na pierwszy rzut oka
Które ścieżki w stylu OpenAI naprawdę implementuje dostawca? Oto krótka lista dla tego API. Base URL: https://api.uncensoredendpoint.com/v1. Autoryzacja odbywa się za pomocą klucza Bearer przy każdym wywołaniu.
| Metoda i ścieżka | Cel |
|---|---|
POST /v1/chat/completions | Zapytania czatu, strumieniowanie, narzędzia, tryb JSON |
POST /v1/responses | Nowszy format zapytania w stylu Responses |
GET /v1/models | Wyświetla modele; ID to uncensored |
GET /v1/dashboard/billing/credit_grants | Saldo w kształcie zgodnym ze stylem OpenAI |
GET /v1/balance | Saldo w prostej formie |
To jest cała oferta. Wszystko, czego nie ma w tabeli, nie jest dostępne. Czytaj dalej, aby poznać działające żądania i listę brakujących funkcji, co pozwoli Ci zaplanować pracę przed napisaniem kodu.
Uzupełnianie czatu
To endpoint, którego używa większość klientów. Wskaż dowolne SDK OpenAI na base URL i użyj nazwy modelu uncensored.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "List three uses of a webhook."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)Obsługiwane parametry to stream, tools, tool_choice, response_format z json_object oraz zestaw próbkowania: temperature, top_p, stop, seed i kary. max_tokens jest opcjonalny, ponieważ uzupełnienie może wykorzystać dowolną liczbę tokenów z okna 100 000.
Przy stream: true odpowiedź przychodzi jako zdarzenia wysłane przez serwer, a użycie jest dołączone na końcu, więc nadal możesz logować liczbę tokenów.
Czaty wieloetapowe
API nie przechowuje stanu rozmowy. W przypadku wieloetapowej rozmowy wysyłasz pełną listę wiadomości za każdym razem: najpierw wiadomość systemowa, naprzemiennie użytkownik i asystent. Oznacza to, że liczba tokenów wejściowych rośnie z każdą turą, a wraz z nią koszt, więc skracaj lub streszczaj stare tury, gdy rozmowa staje się długa. Okno ma rozmiar 100 000 tokenów dla promptu plus uzupełnienia, co wystarczy dla większości rozmów, ale łatwo je wypełnić wklejonymi dokumentami.
Odpowiedzi, modele i saldo
Odpowiedzi
Nowsze przykłady OpenAI używają /v1/responses. Jest ono również dostępne tutaj, więc kod napisany dla tego formatu nie wymaga przepisania.
curl https://api.uncensoredendpoint.com/v1/responses \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "uncensored", "input": "Write a haiku about caching."}'Użyj tego, czego oczekuje Twój klient. Jeśli zaczynasz od zera, endpoint chat completions ma najszersze wsparcie narzędzi.
Modele i saldo
Wypisz modele, aby sprawdzić, czy Twój klucz działa. Powinieneś zobaczyć jedną pozycję, uncensored, ponieważ usługa uruchamia jeden model i nie jest routerem między dostawcami.
curl https://api.uncensoredendpoint.com/v1/models -H "Authorization: Bearer YOUR_KEY"
# remaining credit, OpenAI-style
curl https://api.uncensoredendpoint.com/v1/dashboard/billing/credit_grants -H "Authorization: Bearer YOUR_KEY"
# remaining credit, short form
curl https://api.uncensoredendpoint.com/v1/balance -H "Authorization: Bearer YOUR_KEY"Saldo otrzymujesz również w każdej odpowiedzi w nagłówku X-Balance-USD, co jest wygodne do wyświetlenia ostrzeżenia o niskim kredycie w Twojej aplikacji bez dodatkowego zapytania. Inne nagłówki to X-Request-Id do pytań wsparcia, oraz X-RateLimit-Limit-Requests i X-RateLimit-Limit-Concurrency.
Narzędzia i tryb JSON w praktyce
Dwie funkcje zamieniają endpoint czatu w coś, na czym można zbudować produkt. Wywoływanie narzędzi pozwala modelowi poprosić Twój kod o uruchomienie funkcji. Tryb JSON sprawia, że zwraca on wynik do parsowania. Obie funkcje używają standardowych pól zapytania.
Wywołanie narzędzia wygląda tak. Model zwraca wpis tool_calls, uruchamiasz funkcję, a następnie wysyłasz wynik z powrotem jako wiadomość z role: "tool".
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
tools = [{
"type": "function",
"function": {
"name": "get_weather",
"description": "Current weather for a city",
"parameters": {
"type": "object",
"properties": {"city": {"type": "string"}},
"required": ["city"],
},
},
}]
msgs = [{"role": "user", "content": "Weather in Oslo?"}]
r = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
call = r.choices[0].message.tool_calls[0]
args = json.loads(call.function.arguments)
msgs.append(r.choices[0].message)
msgs.append({"role": "tool", "tool_call_id": call.id, "content": '{"temp_c": 4}'})
final = client.chat.completions.create(model="uncensored", messages=msgs, tools=tools)
print(final.choices[0].message.content)Dla trybu JSON dodaj response_format={"type": "json_object"} i podaj w prompcie, że chcesz JSON, najlepiej z kluczami, których oczekujesz. Zawsze parsuj wynik w bloku try: żaden model nie gwarantuje zgodności ze schematem przy każdym wywołaniu, więc zwaliduj wynik przed zaufaniem mu.
Przeniesienie istniejącego projektu OpenAI
Jeśli Twoja aplikacja już używa SDK OpenAI, migracja to trzy edycje i brak nowej biblioteki. Większość SDK czyta te same dwie zmienne środowiskowe, więc często nie musisz nic zmieniać w kodzie.
export OPENAI_BASE_URL=https://api.uncensoredendpoint.com/v1
export OPENAI_API_KEY=YOUR_KEYimport OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredendpoint.com/v1", apiKey: process.env.KEY });
const r = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Ping" }],
});
console.log(r.choices[0].message.content);Wyszukaj w kodzie nazwy modeli, takich jak ID modelu GPT, i zamień je na uncensored, ponieważ usługa oferuje jeden model. Usuń wywołania do embeddings, obrazów lub audio i przekaż je innemu dostawcy. Zachowaj krótką listę kontrolną: zmieniony Base URL, zmieniona nazwa modelu, klucz przechowywany w zmiennej środowiskowej, a nie w repozytorium, logika ponawiania dla 429 i alert niskiego salda na podstawie nagłówka salda. Konfigurację klucza znajdziesz w jak zdobyć klucz API do AI bez cenzury. Następnie wykonaj pojedyncze zapytanie testowe i sprawdź, czy zwracany jest nagłówek X-Balance-USD, zanim przełączysz ruch produkcyjny.
Co nie jest oferowane
Znanie braków oszczędza dzień debugowania. To API obsługuje tylko tekst. Te endpointy OpenAI nie są dostępne:
- Generowanie obrazów i wizja maszynowa. Brak generowania lub edycji obrazów.
- Audio. Brak konwersji mowy na tekst ani tekstu na mowę.
- Wideo. Nie oferowane.
- Embeddings. Jeśli budujesz pobieranie informacji, potrzebujesz osobnej usługi embeddings.
- Dostrajanie. Nie możesz trenować na tej usłudze.
Wywołania tych ścieżek zakończą się niepowodzeniem, więc trzymaj je z dala od współdzielonej konfiguracji klienta. Typowa konfiguracja łączy to API do czatu z innym dostawcą do embeddings, a Twoja aplikacja wybiera base URL zgodnie z zadaniem.
Limity, błędy i ponawianie
Pełny klucz pozwala na 8 równoległych zapytań i 300 zapytań na minutę. Klucz próbny pozwala na 2 równoległe i 60 na minutę. Maksymalna wielkość ciała to 8 MB. Po przekroczeniu limitu otrzymasz HTTP 429 z kodem błędu wskazującym, który limit został przekroczony: rate_limited dla zapytań na minutę, concurrency dla zbyt wielu zapytań naraz. Przy tymczasowym przeciążeniu otrzymasz również 429 z nagłówkiem Retry-After: 5.
Jeden szczegół zaskakuje ludzi: strumieniowane zapytanie zajmuje slot współbieżności do końca strumienia, więc wolni czytelnicy liczą się do limitu. Prosty opakowywacz ponawiania obsługuje wszystko to:
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredendpoint.com/v1", api_key="YOUR_KEY")
def ask(prompt, tries=4):
for i in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": prompt}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (i + 1))
raise RuntimeError("still rate limited")Nieudane lub odrzucone zapytania nie są rozliczane, więc ponowienia przy błędach nie kosztują ekstra. Dla zadań wsadowych ogranicz pulę workerów do 8 przy pełnym kluczu lub do 2 przy kluczu próbnym, zamiast polegać na ponowieniach. Stała pula jest łatwiejsza do zrozumienia i zapobiega głodzeniu innych strumieni przez jeden wolny.
Koszt i dostęp
Ceny to $0,15 za 1M tokenów wejściowych i $0,50 za 1M tokenów wyjściowych, z przedpłaconego kredytu bez subskrypcji i bez wygaśnięcia. Doładuj dowolną kwotą całkowitą od $20 do $500 kryptowalutami (USDT na TRC20, USDC na Base). Większe doładowania dodają bonus: +5% od $50, +10% od $100, +15% od $200. Zobacz stronę z cenami.
Aby wypróbować, zarejestruj się za pomocą Google lub e-maila, a następnie odebierz darmowy kredyt próbny za $0,50 jednym kliknięciem na strony klucza API. dokumentacja omawiają każdy parametr, a przegląd endpointów wyjaśnia, czym jest usługa: jeden model o otwartych wagach do użytku prawnego przez osoby dorosłe, bez odrzuceń treści i z wyraźnym zakazem treści seksualnych z udziałem nieletnich.
Więcej przewodników
Pytania i odpowiedzi
Czy obsługuje strumieniowanie i wywoływanie narzędzi?
Tak. Użyj stream: true dla zdarzeń SSE z użyciem na końcu oraz narzędzi z tool_choice do wywoływania funkcji.
Czy jest endpoint embeddings?
Nie. Usługa obsługuje tylko czat tekstowy, więc do embeddingów użyj innego dostawcy.
Jak sprawdzić swoje saldo?
Wywołaj GET /v1/balance lub endpoint credit_grants w stylu OpenAI, albo odczytaj nagłówek X-Balance-USD z dowolnej odpowiedzi.
Co się stanie, gdy osiągnę limit zapytań?
Otrzymasz HTTP 429 z kodem rate_limited lub concurrency. Poczekaj i ponów; w przypadku tymczasowego przeciążenia nagłówek Retry-After podaje 5 sekund.
Twój klucz jest o jeden formularz dalej
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.