Eerste verzoek in vijf minuten

Basis-URL en authenticatie

Onze API imiteert de OpenAI v1-interface, waardoor je endpoints kunt wisselen zonder de applicatielogica aan te passen. Gebruik https://api.groknsfw.top/v1 als je basis-URL. Authenticatie vereist een geldige API-sleutel die wordt doorgegeven in de Authorization header als Bearer-token. Je kunt deze sleutel direct genereren via Google inloggen of e-mail op het dashboard. Elke account ondersteunt één actieve sleutel tegelijk; het uitgeven van een nieuwe sleutel maakt de vorige direct ongeldig. Dit single-key model vereenvoudigt toegangscontrole voor de meeste ontwikkel- en QA-omgevingen.

Eerste verzoek

Stuur een standaard chat-completion verzoek om de connectiviteit te testen. De modelidentifier is uncensored, die inhoudsweigeringen anders afhandelt dan standaard modellen. Hieronder volgt een basisvoorbeeld met de curl-opdrachtregel om te verifiëren dat je sleutel en basis-URL correct zijn.

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."}]
  }'

Als je een JSON-antwoord ontvangt met choices en usage, is je integratie actief. Controleer het usage object om tokenverbruik te zien voor nauwkeurige facturatievolging.

Python SDK-integratie

Gebruik de officiële openai Python-pakket om te communiceren met ons endpoint. Stel de base_url en api_key attributen in voordat je aanroept. Deze aanpak werkt met elke bibliotheek die het OpenAI-schema ondersteunt, waardoor migratie van andere providers eenvoudig is.

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)

Dit codefragment demonstreert een synchroon verzoek. Voor het genereren van NSFW-content met hoge doorvoer kun je overwegen asynchrone clients te gebruiken om meerdere verzoeken gelijktijdig af te handelen zonder je hoofdthread te blokkeren.

Node.js SDK-instelling

Configureer voor JavaScript- of TypeScript-applicaties de OpenAI SDK om naar onze basis-URL te wijzen. Dit zorgt ervoor dat je bestaande clientcode zonder wijzigingen werkt. De Node.js-ecosysteem profiteert van deze compatibiliteit, waardoor snelle prototyping van NSFW-chatinterfaces mogelijk is.

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);

Zorg ervoor dat je een recente versie van de SDK gebruikt die aangepaste basis-URLs ondersteunt. Het configuratieobject moet strikt de apiKey en baseURL eigenschappen bevatten om endpoint-mismatch te voorkomen.

Streaming-antwoorden (SSE)

Schakel realtime token-generatie in door stream: true in je verzoek in te stellen. De API retourneert een Server-Sent Events (SSE)-stream, die tokens levert zodra ze gegenereerd zijn. Dit vermindert de waargenomen latentie voor eindgebruikers in chattoepassingen.

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)

Parse de SSE-gebeurtenissen om de delta inhoud te extraheren. Het laatste chunk in de stream bevat de totale usage statistieken, die je moet gebruiken voor nauwkeurige facturatieafstemming. Streaming heeft geen invloed op token-telling of prijzen.

Limieten, fouten en context

Je verzoeken zijn onderhevig aan een limiet van 300 per minuut en 8 gelijktijdige verzoeken per sleutel. De maximale grootte van de request body is 8 MB, en het contextvenster ondersteunt in totaal maximaal 100.000 tokens. Fouten worden geretourneerd in standaard HTTP-formaten: 401 voor ongeldige sleutels, 402 voor onvoldoende tegoed, en 429 voor rate limits. Fouten door kredietproblemen zijn gratis, maar bij rate limits moet je je verzoeken vertragen. De maximale output per verzoek is 32.000 tokens; het weglaten van max_tokens resulteert in een standaardwaarde van 2.048 tokens.