Erste Anfrage in fünf Minuten

Basis-URL und Authentifizierung

Unsere API spiegelt die OpenAI v1-Schnittstelle wider, sodass Sie Endpunkte austauschen können, ohne Ihre Anwendungslogik zu ändern. Verwenden Sie https://api.groknsfw.top/v1 als Ihre Basis-URL. Die Authentifizierung erfordert einen gültigen API-Schlüssel, der im Authorization-Header als Bearer-Token übergeben wird. Sie können diesen Schlüssel sofort über Google-Anmeldung oder E-Mail im Dashboard generieren. Jedes Konto unterstützt einen aktiven Schlüssel gleichzeitig; die Ausgabe eines neuen Schlüssels macht den vorherigen sofort ungültig. Dieses Single-Key-Modell vereinfacht die Zugriffskontrolle für die meisten Entwicklungs- und QA-Umgebungen.

Erste Anfrage

Sende eine Standard-Anfrage für Chat-Vervollständigungen, um die Konnektivität zu testen. Die Modellkennung ist uncensored, das Inhaltsablehnungen anders behandelt als Standardmodelle. Nachfolgend findest du ein einfaches Beispiel mit dem Befehlszeilenwerkzeug curl, um zu überprüfen, ob dein API-Schlüssel und die Basis-URL korrekt sind.

Copycurl https://api.groknsfw.top/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."}]
  }'

Wenn Sie eine JSON-Antwort mit choices und usage erhalten, ist Ihre Integration aktiv. Überprüfen Sie das Objekt usage, um den Tokenverbrauch für eine genaue Abrechnungsnachverfolgung zu sehen.

Python SDK-Integration

Verwenden Sie das offizielle openai Python-Paket, um mit unserem Endpunkt zu interagieren. Legen Sie die Attribute base_url und api_key fest, bevor Sie Aufrufe tätigen. Dieser Ansatz funktioniert mit jeder Bibliothek, die das OpenAI-Schema unterstützt, was die Migration von anderen Anbietern einfach macht.

Copyfrom openai import OpenAI

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

Dieses Snippet demonstriert eine synchrone Anfrage. Für die NSFW-Inhaltsgenerierung mit hohem Durchsatz sollten Sie asynchrone Clients verwenden, um mehrere Anfragen parallel zu bearbeiten, ohne Ihren Hauptthread zu blockieren.

Node.js SDK-Einrichtung

Konfigurieren Sie für JavaScript- oder TypeScript-Anwendungen das OpenAI SDK so, dass es auf unsere Basis-URL zeigt. Dies stellt sicher, dass Ihr vorhandener Client-Code ohne Änderungen funktioniert. Die Node.js-Ökosystem profitiert von dieser Kompatibilität, was eine schnelle Prototypentwicklung von NSFW-Chat-Schnittstellen ermöglicht.

Copyimport OpenAI from "openai";

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

Stellen Sie sicher, dass Sie eine aktuelle Version des SDK verwenden, die benutzerdefinierte Basis-URLs unterstützt. Das Konfigurationsobjekt sollte streng die Eigenschaften apiKey und baseURL enthalten, um Endpunkt-Fehlanpassungen zu vermeiden.

Streaming-Antworten (SSE)

Aktivieren Sie die Echtzeit-Token-Generierung, indem Sie stream: true in Ihrer Anfrage festlegen. Die API gibt einen Server-Sent Events (SSE)-Stream zurück, der Tokens bereitstellt, sobald sie generiert werden. Dies reduziert die wahrgenommene Latenz für Endbenutzer in Chat-Anwendungen.

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)

Analysiere die SSE-Ereignisse, um den delta-Inhalt zu extrahieren. Der letzte Block im Stream enthält die Gesamtstatistiken zu usage, die du für eine genaue Abrechnungsnachverfolgung verwenden solltest. Das Streaming hat keinen Einfluss auf die Tokenzählung oder die Preisgestaltung.

Grenzwerte, Fehler und Kontext

Deine Anfragen unterliegen einem Limit von 300 pro Minute und 8 parallelen Anfragen pro Schlüssel. Die maximale Größe des Anfragekörpers beträgt 8 MB, und das Kontextfenster unterstützt bis zu 100.000 Token insgesamt. Fehler werden in standardmäßigen HTTP-Formaten zurückgegeben: 401 für ungültige Schlüssel, 402 für unzureichendes Guthaben und 429 für Ratenlimits. Bei Guthabenfehlern wird nichts berechnet, aber bei Ratenlimits musst du die Anfragen drosseln. Die maximale Ausgabe pro Anfrage beträgt 32.000 Token; das Auslassen von max_tokens führt zu einem Standardwert von 2.048 Token.