API-documentatie

Authenticatie en basis-URL

De base URL voor alle verzoeken is https://api.grokapiplatform.com/v1. Authenticeer door je unieke API-sleutel door te geven in de Authorization header. Elk verzoek moet deze header bevatten om je accountbalans te verifiëren en snelheidsbeperkingen toe te passen.

Chat completions endpoint

Stuur tekstqueries naar POST /v1/chat/completions. De te gebruiken model-ID is "uncensored". Dit endpoint verwerkt standaard tekst-in, tekst-uit interacties zonder extra configuratie voor basisgebruik.

Copycurl https://api.grokapiplatform.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check my current token usage balance."}]
  }'

Het model werkt met een contextvenster van 100.000 tokens. Invoer- en uitvoertokens delen deze limiet. Verzoeken die het contextvenster overschrijden, falen onmiddellijk.

Streamingresponsen met SSE

Activeer streaming door stream: true in je aanvraaglichaam. De server retourneert Server-Sent Events (SSE) met incrementele tokenupdates. Gebruik dit voor real-time weergaven of om de waargenomen latentie te verminderen.

Copyfrom openai import OpenAI

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

Tokenverbruiksgegevens verschijnen in de laatste chunk van de stream. Je kunt het totale verbruik per verzoek bijhouden zonder elke tussenliggende delta te parseren.

Functieaanroep en hulpprogramma's

Definieer tools in de tools array en instellen tool_choice om specifiek gedrag te triggeren. Het model ondersteunt standaard tool use patronen compatibel met OpenAI SDKs.

Copyimport OpenAI from "openai";

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

Gebruik tool_choice: "auto" voor automatische selectie of geef een toolnaam op voor geforceerde uitvoering. Dit werkt naadloos met het uncensored-model voor complexe redeneertaken.

JSON-modus voor gestructureerde uitvoer

Instellen response_format naar {"type": "json_object"} om strikte JSON-uitvoer af te dwingen. Dit vermindert parserfouten bij integratie met frontend-applicaties of datapipelines.

Parameters en limieten

Aanpassen temperature, top_p, en seed om de willekeurigheid te bepalen. De maximale uitvoer per verzoek is 16.000 tokens. Fouten zoals 401 duiden op ongeldige sleutels, 402 betekent onvoldoende vooruitbetaald krediet, en 429 signaleert snelheidslimieten. De limiet is 300 verzoeken per minuut per sleutel. Krediet vervalt nooit, dus je kunt bijbetalen met USDT of USDC wanneer je maar wilt.

Streaming

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)