Dolphin uncensored API Dokumentacja

Wymagania wstępne i konfiguracja środowiska

Zacznij od upewnienia się, że Twoje środowisko ma zainstalowane niezbędne zależności przed wysłaniem jakichkolwiek żądań. Będziesz potrzebował aktywnego klucza API z naszego panelu oraz obsługiwanego środowiska wykonawczego, takiego jak Python lub Node.js. Nasze API wymaga wysyłania żądań pod konkretny adres bazowy, a nie domyślny endpoint OpenAI.

Przechowuj swój klucz API bezpiecznie i przechowuj go w zmiennej środowiskowej. Zapobiega to przypadkowemu ujawnieniu w repozytorium kodu. Możesz wygenerować nowy klucz natychmiast po rejestracji za pomocą Google lub e-maila.

Nie musisz konfigurować skomplikowanego routingu ani wybierać konkretnych modeli. Punkt końcowy obsługuje jeden uncensored duży model językowy zaprojektowany do bezpośredniego wyjścia tekstu.

Instalacja oficjalnego SDK OpenAI

Zainstaluj oficjalny pakiet SDK, aby automatycznie obsługiwać uwierzytelnianie i formatowanie żądań. Ta biblioteka obsługuje zarówno środowiska Python, jak i Node.js ze spójnymi interfejsami.

Dla użytkowników Python uruchom standardowe polecenie pip install, aby dodać bibliotekę do swojego środowiska wirtualnego. Programiści Node.js powinni użyć npm do zainstalowania odpowiedniego pakietu.

SDK zarządza strukturą ładunku JSON za Ciebie, więc musisz skupić się tylko na treści promptu i parametrach takich jak temperatura czy top_p.

Możesz zweryfikować instalację, importując bibliotekę w swoim skrypcie lub module. Zapewnia to, że klient jest gotowy do połączenia z naszymi serwerami.

Konfigurowanie bazowego adresu URL i klucza API

Wskaż klienta SDK na nasz konkretny adres bazowy, aby kierować żądania do naszej infrastruktury nieograniczonej. Użyj https://api.dolphinuncensored.com/v1 jako swój punkt końcowy.

Skonfiguruj swój klucz API w nagłówku autoryzacji lub obiekcie konfiguracji klienta. Klient dołączy ten klucz do każdego żądania automatycznie.

Upewnij się, że określisz ID modelu jako "uncensored" w swojej konfiguracji. Informuje to serwer, której wersji modelu użyć do generowania.

Wykonywanie pierwszego uzupełnienia czatu

Wyślij prostą wiadomość, aby zweryfikować łączność i otrzymać odpowiedź. Potwierdza to ważność Twojego klucza i dostępność punktu końcowego.

Użyj endpointu chat-completions z promptem systemowym i wiadomością użytkownika. Odpowiedź będzie zawierać wygenerowany tekst w polu content.

Zrozumienie strumieniowania i zużycia tokenów

Włącz strumieniowanie, aby otrzymywać tokeny w miarę ich generowania zamiast czekać na pełną odpowiedź. Poprawia to postrzeganą latencję dla długich wyjść.

API zwraca statystyki zużycia w ostatnim czacie strumienia. Możesz śledzić liczbę tokenów wejściowych i wyjściowych dla przejrzystości rozliczeń.

Ustaw parametr stream na true w ciele żądania. Iteruj przez fragmenty, aby zbudować końcowy tekst lub przetworzyć go w czasie rzeczywistym.

Obsługa błędów i odrzuceń

Obsłuż błędy HTTP 401, weryfikując, czy Twój klucz API jest poprawny i nie wygasł. Błąd 402 wskazuje na niewystarczające środki na koncie; doładuj poprzez kryptowaluty, aby kontynuować.

Kod stanu 429 oznacza, że przekroczyłeś limit szybkości wynoszący 300 żądań na minutę. Poczekaj chwilę przed ponowną próbą lub zmniejsz współbieżność.

Model odmawia żądań dotyczących treści seksualnych involving minors, co jest twardym limitem. Inne tematy kontrowersyjne lub dla dorosłych są generalnie dozwolone. Błędy i odmowy nie zużywają kredytu tokenów.

cURL

Copycurl https://api.dolphinuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.dolphinuncensored.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.dolphinuncensored.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Strumieniowanie

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)