Integracja krok po kroku z API LLM uncensored.com

Wymagania wstępne: SDK i konfiguracja środowiska

Zainstaluj preferowany SDK języka, aby komunikować się z endpointem. Większość programistów używa oficjalnego SDK OpenAI dla Pythona, Node.js lub Go. Działa to, ponieważ API odpowiada standardowemu schematowi chat completions OpenAI.

Upewnij się, że Twoje środowisko ma Python 3.8+ lub Node.js 18+. Zainstaluj pakiet za pomocą pip lub npm. Będziesz potrzebował klucza API z panelu. Nie jest wymagany numer telefonu do rejestracji.

• Python: pip install openai
• Node.js: npm install openai

Przechowaj klucz API w zmiennej środowiskowej. Zapobiega to przypadkowemu ujawnieniu go w systemach kontroli wersji. Klucz daje dostęp do modelu bez cenzury.

Konfigurowanie bazowego adresu URL

Wskaż klienta SDK na prawidłowy adres bazowy. To najważniejszy krok dla pomyślnej integracji. Domyślny adres bazowy OpenAI nie zadziała dla tej usługi.

Ustaw URL bazowy na HTTPS://api.uncensoredaicom.com/v1. To kieruje żądania do infrastruktury LLM uncensored. Identyfikator modelu, który musisz wysłać, to "uncensored". To model o otwartych wagach dostrojony do minimalnych odmów.

Sprawdź połączenie, wywołując punkt końcowy modeli. Potwierdza to poprawność Twoich poświadczeń i adresu URL bazowego. Pomyślna odpowiedź zwraca identyfikator modelu i typ obiektu.

Uwierzytelnianie i konfiguracja nagłówka

Przekazuj swój klucz API w nagłówku Authorization. Użyj schematu Bearer dla wszystkich żądań. Ten nagłówek uwierzytelnia Twoje konto z pre-paid.

Ustaw nagłówek jako: Authorization: Bearer YOUR_API_KEY. SDK obsługuje to automatycznie, jeśli przekażesz klucz do konstruktora klienta. Upewnij się, że nie ma dodatkowych spacji. Nieprawidłowe klucze zwracają błąd 401 Unauthorized.

Otrzymujesz jeden aktywny klucz na konto. Wygenerowanie nowego klucza unieważnia poprzedni. Upraszcza to rotację kluczy i zarządzanie bezpieczeństwem. Przechowuj swój klucz bezpiecznie w środowisku wdrożenia.

Wysyłanie standardowego żądania Chat

Wyślij żądanie POST do /v1/chat/completions. Prześlij swoje wiadomości jako tablicę obiektów zawierających rolę i treść. System obsługuje role użytkownika, asystenta i systemu.

Przykładowa struktura: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API zwraca uzupełnienie tekstu. Okno kontekstowe wynosi łącznie 100,000 tokenów. Maksymalna długość wyjścia to 16,000 tokenów na żądanie.

Błędy i odrzucenia nie pobierają kredytu. Chroni to Twój kredyt wstępnie opłacony. Ustaw temperaturę i top_p dla kontroli. Wartości domyślne działają w większości przypadków użycia.

Włączanie Strumieniowania dla Wyjścia w Czasie Rzeczywistym

Ustaw stream: true w ciele żądania. To aktywuje zdarzenia wysłane przez serwer (SSE). Tokeny przychodzą inkrementalnie zamiast czekać na pełne uzupełnienie.

Przeanalizuj strumień SSE, aby wyświetlać tekst w czasie rzeczywistym. Ostatni fragment zawiera statystyki zużycia tokenów. Pozwala to na dokładne śledzenie rozliczeń. Strumieniowanie zmniejsza postrzeganą opóźnienie dla użytkowników końcowych.

Obsługuj przerwy w sieci w sposób elegancki. Połącz się ponownie, jeśli strumień się rozłączy. API uncensored obsługuje stabilne strumieniowanie. Monitoruj stan połączenia. Użyj tego dla interfejsów czatu lub generowania długich treści.

Wykorzystywanie Narzędzi i Wywoływania Funkcji

Zdefiniuj narzędzia w ciele żądania. Przekaz listę schematów funkcji. Model może wywoływać te funkcje na podstawie intencji użytkownika. Umożliwia to zachowanie przypominające działanie agenta.

Specify tool_choice kontrolować wybór funkcji. Użyj auto dla automatycznego wykrywania. API obsługuje standardowe definicje narzędzi. Sparsuj argumenty wywołania funkcji z odpowiedzi.

Wdroż wykonanie funkcji w swoim kodzie. Wyślij wynik z powrotem jako wiadomość. Model kontynuuje rozmowę. To umożliwia złożone przepływy pracy. Testowanie zapewnia dokładne parsowanie argumentów.

Obsługa odpowiedzi w trybie JSON

Ustaw response_format: {"type": "json_object"}.To wymusza od modelu zwracanie poprawnego formatu JSON. Użyj tego do ekstrakcji danych strukturalnych. Zapobiega błędom wynikającym z niepoprawnej struktury odpowiedzi.

Przetwarzaj ciąg JSON w swoim kodzie. Obsłuż potencjalne błędy parsowania. Tryb JSON poprawia niezawodność integracji API. Jest idealny do potoków przetwarzania danych.

Połącz tryb JSON z promptami systemowymi. Kieruj model do generowania konkretnych schematów. Zapewnia to spójny format. Zweryfikuj wyjście przed jego użyciem. Zmniejsza to błędy downstreamowe.

Monitorowanie limitów i błędów

Szczegółowo przestrzegaj limitów szybkości. Masz do dyspozycji 300 żądań na minutę na klucz. Maksymalnie 8 jednoczesnych żądań. Rozmiar ciała żądania jest ograniczony do 8 MB.

Monitoruj kody statusu HTTP. 429 wskazuje na przekroczenie limitu szybkości. 400 wskazuje na błędne żądanie. 500 wskazuje na błąd serwera. Zaimplementuj wykładnicze ponawianie prób. Zapobiega to przeciążeniu API.

Śledź użycie tokenów w ostatnim kawałku strumienia. Pomaga to zarządzać kredytem z góry opłaconym. Błędy nie zużywają tokenów. Chroni to Twoje saldo. Regularne monitorowanie zapewnia płynną pracę.

Obliczanie kosztów i zużycia tokenów

Cennik jest przejrzysty i oparty na modelu prepaid. Tokeny wejściowe kosztują $0.15 za milion. Tokeny wyjściowe kosztują $0.50 za milion. Kredyt nigdy nie wygasa. Nie ma opłat miesięcznych.

Doładuj tylko kryptowalutą. USDT (TRC20) lub USDC (Base). Kwoty wahają się od $20 do $500. Bonus kredytowy stosuje się przy większych doładowaniach. +5% od $50, +10% od $100, +15% od $200.

Oblicz koszty przed intensywnym użytkowaniem. Oszacuj liczbę tokenów dla swoich promptów. Pomaga to efektywnie planować budżet. Błędy są darmowe. Zwrotów nie wystawiamy, ale błędy są naprawiane. Używaj panelu do śledzenia wydatków.