Przewodnik integracji API Grok

Dlaczego warto użyć bezfiltracyjnej alternatywy dla API Grok?

Bezpośredni dostęp do API często stosuje ścisłe filtry treści, które blokują legalne treści dla dorosłych lub kontrowersyjne tematy. Wielu dostawców ukrywa te odmowy głęboko w strukturach odpowiedzi. Model bez cenzury dostarcza surowe dane wnioskowania dla dowolnego przypadku użycia. Otrzymujesz pełne wyjście bez interwencji korporacyjnej warstwy bezpieczeństwa.

API klasy korporacyjnej często zmieniają logikę filtrowania bez uprzedzenia. Łamie to aplikacje downstream, które polegają na określonych typach treści. Dedykowana usługa niecenzurowana eliminuje tę niepewność. Twoje prompty zwracają dokładnie to, co generuje model.

Rozważ różnicę między interfejsem czatu a surowym API. Interfejs czatu może ukrywać zniuansowane wyjścia. API udostępnia pełny strumień tokenów. Ta przejrzystość jest krytyczna dla deweloperów budujących specjalistyczne narzędzia.

Nasz serwis działa niezależnie. Nie obsługujemy Grok ani żadnego innego modelu dostawcy. Zapewniamy odrębny duży model językowy uncensored. Działa na naszych własnych serwerach. Interfejs pozostaje znajomy dla użytkowników OpenAI.

Kluczowe korzyści

• Brak opłat subskrypcyjnych miesięcznych.
• Przejrzyste rozliczenie z góry.
• Surowe wyjście dla legalnych treści dla dorosłych.
• Brak ukrytych odrzuceń dla kontrowersyjnych tematów.

Zrozumienie struktury punktu końcowego API

Dwa punkty końcowe obsługują wszystkie interakcje: POST /v1/chat/completions oraz GET /v1/models. Postępują one zgodnie ze standardową specyfikacją API OpenAI. Wysyłasz ładunek JSON ze swoimi wiadomościami systemowymi i użytkownika. Serwer zwraca odpowiedź JSON z wygenerowanym tekstem.

Punkt końcowy GET wyświetla dostępne modele. Potwierdza, że Twoje połączenie jest poprawne. Użyj go do zweryfikowania, czy Twój klucz API działa, zanim wyślesz duże obciążenia. Pokazuje również identyfikator modelu, który musisz dołączyć do swoich żądań.

Nasz bazowy URL to HTTPS://api.isgrokunfiltered.com/v1. Zastępuje domyślny URL OpenAI w konfiguracji klienta. ID modelu do wysłania to "uncensored". Zapewnia to trafienie na właściwy serwer.

Uwierzytelnianie używa tokena Bearer w nagłówku Authorization. Dołącz swój klucz API bezpośrednio. Nie są wymagane złożone przepływy OAuth. Ta prostota znacznie skraca czas integracji.

Podsumowanie punktów końcowych

Metoda	Ścieżka	Funkcja
POST	/v1/chat/completions	Generuje odpowiedzi tekstowe
GET	/v1/models	Wyświetla dostępne modele

Konfigurowanie klienta dla strumieniowania

Włącz strumieniowanie, ustawiając parametr stream na true w ciele żądania. Zwraca to zdarzenia wysyłane serwerowo (SSE) zamiast pojedynczego obiektu JSON. Każde zdarzenie zawiera częściowy fragment odpowiedzi. Możesz wyświetlać tekst użytkownikom w czasie rzeczywistym.

Strumieniowanie zmniejsza postrzeganą opóźnienie dla długich odpowiedzi. Użytkownicy widzą wyjście, gdy jest generowane. Poprawia to doświadczenie w interfejsach typu czat. Pozwala również na wcześniejsze anulowanie żądań, jeśli jest to konieczne.

Każdy chunk zawiera dane o zużyciu tokenów w ostatnim zdarzeniu. Możesz dokładnie śledzić tokeny wejściowe i wyjściowe. Pomaga to monitorować stan konta kredytowego. Błędy podczas strumieniowania nadal pobierają tokeny za przetworzone dane.

Obsługuj poprawnie format SSE. Parsuj każdą linię zaczynającą się od "data: ". Ignoruj zdarzenie końcowe "[DONE]". Zapewnia to, że Twoja aplikacja przetwarza każdy token poprawnie.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.isgrokunfiltered.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)

Obsługa wywołań funkcji w trybie uncensored

Wywoływanie funkcji pozwala Twojej aplikacji na wykonywanie kodu na podstawie wyniku modelu. Wyślij listę narzędzi w żądaniu. Model zwraca tablicę tool_calls zamiast zwykłego tekstu. Twój kod wykonuje funkcję i zwraca wynik.

To działa płynnie z naszym modelem bez cenzury. Model nie odmawia wywoływania funkcji na podstawie typu treści. Skupia się na logicznej strukturze żądania. To jest idealne do złożonych zadań ekstrakcji danych.

Używaj trybu JSON do wymuszenia ścisłych formatów wyjściowych. Ustaw response_format na json_object. Model zwraca tylko poprawny JSON. Zmniejsza to błędy parsowania w Twoim backendzie. Zapewnia spójne struktury danych.

Połącz wywoływanie funkcji ze strumieniowaniem dla dynamicznych interakcji. Możesz rozpocząć wykonywanie funkcji, gdy model wciąż generuje treść. Tworzy to bardzo responsywną aplikację. Model uncensored obsługuje zróżnicowane definicje narzędzi bez uprzedzeń.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.isgrokunfiltered.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);

Optymalizacja kosztów tokenów dla długich kontekstów

Okno kontekstowe obsługuje do 100 000 tokenów. Obejmuje to zarówno prompt, jak i uzupełnienie. Dłuższe konteksty zużywają więcej kredytu z góry opłaconego. Monitoruj zużycie tokenów, aby uniknąć nieoczekiwanych opłat.

Tokeny wejściowe kosztują $0.15 za milion. Tokeny wyjściowe kosztują $0.50 za milion. Tokeny wyjściowe są znacznie droższe. Zoptymalizuj swoje prompty, aby zmniejszyć rozmiar wejścia. Używaj zwięzłych instrukcji systemowych. Unikaj wysyłania niepotrzebnej historii.

Ustaw parametr max_tokens, aby kontrolować długość wyjścia. Domyślna wartość to 2 048 tokenów. Możesz zwiększyć tę wartość do 16 000 tokenów na żądanie. Zapobiega to niekontrolowanemu generowaniu, które szybko zużywa kredyt.

Błędy i odrzucenia są darmowe. Płacisz tylko za pomyślną generację tokenów. Chroni Cię to przed marnymi wydatkami na nieudane żądania. Śledź swoje saldo regularnie, aby być na bieżąco.

Szczegóły Cennika

• Wejście: $0,15 / 1M tokenów
• Wyjście: $0,50 / 1M tokenów
• Maks. Wyjście: 16,000 tokenów
• Okno kontekstowe: 100 000 tokenów

Ustawienia szybkości i współbieżności

Każdy klucz API pozwala na 300 żądań na minutę. Limit ten dotyczy globalnie Twojego klucza. Aplikacje o wysokiej częstotliwości muszą ostrożnie zarządzać swoją szybkością żądań. Przekroczenie limitu zwraca błąd 429 Too Many Requests.

Możesz mieć do 8 równoległych żądań na klucz. Pozwala to na równoległe przetwarzanie niezależnych zadań. Zarządzaj współbieżnością, aby uniknąć przekroczenia limitu szybkości. Rozkładaj żądania w czasie.

Maksymalny rozmiar ciała żądania to 8 MB. Duże ładunki z rozległą historią mogą to przekroczyć. Skompresuj dane wejściowe lub ucinaj stare wiadomości. To zapewnia, że Twoje żądania są przetwarzane pomyślnie.

Możesz mieć tylko jeden aktywny klucz na konto. Jeśli zgubisz klucz, wygeneruj nowy. Stary klucz staje się nieważny natychmiast. To upraszcza zarządzanie bezpieczeństwem. Okresowo zmieniaj klucze dla dodatkowego bezpieczeństwa.

Copycurl https://api.isgrokunfiltered.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of five unique Python script ideas."}]
  }'

Migracja istniejących kluczy API Grok

Migracja do naszego API wymaga zmiany bazowego adresu URL i identyfikatora modelu. Istniejąca struktura kodu klienta pozostaje w dużej mierze bez zmian. Zaktualizuj bazowy adres URL na HTTPS://api.isgrokunfiltered.com/v1. Zmień identyfikator modelu na "uncensored".

Rozwiązywanie typowych błędów integracji

Błędy 401 Unauthorized wskazują na nieprawidłowy lub wygasły klucz API. Zweryfikuj swój klucz w panelu. Upewnij się, że wysyłasz go w nagłówku Authorization. Sprawdź, czy nie ma spacji na początku lub literówek.

Błąd 429 Too Many Requests oznacza, że osiągnąłeś limit szybkości. Zmniejsz częstotliwość żądań lub zwiększ interwał między wywołaniami. Użyj wykładniczego backoffu przy ponownych próbach. Zapobiega to przeciążeniu serwera.

Błąd 400 Bad Request często wynika z nieprawidłowego JSON. Upewnij się, że ładunek pasuje do oczekiwanego schematu. Sprawdź brakujące pola wymagane, takie jak messages lub model. Użyj endpointu GET, aby zweryfikować dostępność modelu.

Błędy 500 Internal Server Errors są rzadkie, ale możliwe. Spróbuj ponownie zapytanie po krótkim opóźnieniu. Jeśli problem będzie się utrzymywał, skontaktuj się z supportem. Nasze logi pomogą szybko zidentyfikować przyczynę.

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)

Kolejne kroki: Testowanie Twojego modelu uncensored

Zacznij od prostej prośby o generowanie tekstu. Wyślij krótki prompt i zweryfikuj format odpowiedzi. Sprawdź, czy strumieniowanie działa poprawnie. Upewnij się, że wywoływanie funkcji płynnie integruje się z Twoim kodem.

Monitoruj zużycie tokenów dokładnie. Model prepay rozlicza tylko rzeczywiste tokeny. Błędy są darmowe. Pozwala to na bezpieczne eksperymentowanie. Doładuj kredyt, używając kryptowalut, gdy jest to konieczne.

Przetestuj przypadki brzegowe, takie jak długie konteksty i złożone definicje narzędzi. Zweryfikuj, czy model bez cenzury radzi sobie z różnymi tematami. Upewnij się, że Twoja aplikacja poprawnie obsługuje częściowe odpowiedzi. Przygotuje to Cię do użycia produkcyjnego.

Zarejestruj się za pomocą Google lub e-maila. Otrzymaj swój klucz API natychmiast. Nie jest wymagany numer telefonu. Zacznij testować natychmiast z kredytem próbnym $0.50. Daje to sposób na ocenę usługi bez ryzyka.