Szybki start dla użytkowników Unhinged Grok

Uwierzytelnianie i URL bazowy

Nasze API jest kompatybilne z OpenAI, co oznacza, że nie potrzebujesz nowej biblioteki. Musisz tylko zaktualizować dwie wartości w istniejącej konfiguracji: base_url oraz api_key. Twój klucz API jest generowany natychmiast po rejestracji przez Google lub e-mail. Chroń ten klucz; jest to jedyne poświadczenie wymagane do uwierzytelniania.

Zamień standardowy URL bazowy OpenAI na nasz endpoint. Ta zmiana kieruje wszystkie kolejne zapytania do serwerów naszego modelu bez cenzury. Nie są wymagane inne zmiany kodu dla podstawowej generacji tekstu.

Przykład konfiguracji

• Base URL: https://api.unhingedgrok.com/v1
• Klucz API: Twój unikalny klucz z panelu

Zweryfikuj połączenie, wyświetlając dostępne modele. Potwierdzi to poprawne działanie uwierzytelniania przed wysłaniem żądań generacji.

Pierwsze zapytanie

Zacznij od wysłania prostego żądania uzupełnienia tekstu. Ten przykład używa curl do pokazania struktury HTTP. Zapytanie kieruje się do endpointu /v1/chat/completions z identyfikatorem modelu uncensored. Odpowiedź zwraca wygenerowany tekst w tablicy choices.

To bezpośrednie podejście działa dla dowolnego języka lub narzędzia obsługującego standardowe formaty HTTP OpenAI. Możesz przetestować to natychmiast po wygenerowaniu klucza.

Bezpośrednie żądanie HTTP

Kopiujcurl https://api.unhingedgrok.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Integracja z Python SDK

Użyj oficjalnej biblioteki Python OpenAI do integracji z naszym API. Zainstaluj pakiet przez pip. Zainicjuj klienta swoim kluczem i niestandardowym base URL. Pozostałe metody SDK, takie jak chat.completions.create, działają dokładnie tak, jak opisano dla OpenAI.

Ta metoda jest idealna dla usług backendowych, skryptów przetwarzania danych lub zautomatyzowanych przepływów pracy. SDK automatycznie obsługuje serializację JSON i parsowanie odpowiedzi.

Przykład kodu Python

Kopiujfrom openai import OpenAI

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

Integracja z Node.js SDK

W środowiskach JavaScript lub TypeScript użyj oficjalnego pakietu npm openai. Skonfiguruj klienta z tym samym base URL i kluczem. SDK Node obsługuje zarówno wzorce oparte na callbackach, jak i promise.

Ta konfiguracja pozwala na bezpośrednie osadzenie generacji tekstu bez cenzury w aplikacjach webowych, funkcjach serverless lub narzędziach automatyzacji opartych na Node. Obsługa błędów pozostaje spójna ze standardowym zachowaniem SDK OpenAI.

Przykład kodu Node.js

Kopiujimport OpenAI from "openai";

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

Odpowiedzi strumieniowe

Włącz generację tokenów w czasie rzeczywistym, ustawiając stream: true. API zwraca strumień Server-Sent Events (SSE). Każdy fragment zawiera częściową odpowiedź. Ostatni fragment zawiera statystyki użycia tokenów.

Strumieniowanie zmniejsza postrzegane opóźnienie dla użytkowników końcowych. Jest kluczowe dla interfejsów czatu i aplikacji interaktywnych. Obsługuj każdy fragment inkrementalnie, aby aktualizować interfejs użytkownika natychmiast.

Przykład kodu strumieniowania

Kopiujstream = 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)

Limity, błędy i kontekst

Poznaj ograniczenia operacyjne, aby uniknąć przerw w usłudze. Okno kontekstu obsługuje łącznie 100,000 tokenów, a jeśli max_tokens nie jest ustawione, odpowiedź może sięgać do końca okna.

Limity zapytań pozwalają na 300 zapytań na minutę na klucz. Równoległe zapytania są ograniczone do 8. Ciała zapytań nie mogą przekraczać 8 MB. Obsługuj standardowe kody błędów HTTP: 401 oznacza nieprawidłowy klucz, 402 sygnalizuje niewystarczający kredyt, a 429 oznacza przekroczenie limitu. Błędy nie zużywają kredytu.