Basis-URL en authenticatie
Onze API volgt de OpenAI Chat Completions-standaard. Om met de service te communiceren, moet je je client wijzen naar https://api.grokapikey.com/v1 en je unieke API-sleutel opnemen in de Authorization-header. Je kunt deze sleutel direct genereren na het aanmaken van een account met alleen een e-mailadres en wachtwoord. De sleutel wordt één keer weergegeven bij het aanmaken, dus bewaar hem veilig. Als je hem kwijtraakt, kun je een nieuwe sleutel genereren vanuit je dashboard, waardoor de vorige direct ongeldig wordt. Er is geen creditcard nodig voor het proefaccount.
Je eerste verzoek
Begin met het versturen van een eenvoudige tekstprompt om de verbinding te verifiëren. Gebruik het standaard chat/completions-endpoint met de model-id uncensored. Het volgende voorbeeld toont een basis curl-opdracht om de verbinding te testen. Dit bevestigt dat je authenticatie correct is en de service reageert. Je kunt deze structuur vervolgens aanpassen voor je specifieke applicatielogica.
Vervang YOUR_API_KEY door je daadwerkelijke sleutel voordat je dit commando uitvoert.
curl https://api.grokapikey.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."}]
}'Python SDK Integratie
Als je een Python-applicatie bouwt, gebruik dan de officiële openai bibliotheek. Configureer de client om onze base URL en je API-sleutel te gebruiken. Dit stelt je in staat bekende Python-idiomen te benutten terwijl je toegang krijgt tot het ongecensureerde model. De client verwerkt serialisatie en streaming automatisch. Zorg dat je omgeving de nieuwste versie van de bibliotheek heeft geïnstalleerd voor de beste compatibiliteit met onze endpoints.
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.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)Node.js SDK Integratie
Voor JavaScript- of TypeScript-projecten werkt de Node.js OpenAI SDK direct. Stel de apiKey en baseURL eigenschappen in je configuratieobject in. Dit zorgt ervoor dat alle volgende verzoeken via onze infrastructuur worden gerouteerd. Je kunt standaard async/await patronen gebruiken om antwoorden te verwerken. Deze aanpak is ideaal voor server-side applicaties of edge functions die directe API-toegang nodig hebben zonder via OpenAI te proxyen.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.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);Streaming Antwoorden
Voor applicaties die baat hebben bij realtime token-generatie, schakel streaming in door stream: true in te stellen in je requestbody. De API retourneert een Server-Sent Events (SSE)-stream van gedeeltelijke antwoorden. Dit vermindert de waargenomen latentie voor gebruikers en maakt directe weergave van gegenereerde tekst mogelijk. Elke chunk bevat een delta van het antwoord. Verwerk deze events in je clientcode om de UI progressief bij te werken. Streaming verbruikt tokens normaal en heeft geen invloed op de prijzen.
stream = 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)Limieten, Fouten en Context
Elke API-sleutel is beperkt tot 300 verzoeken per minuut en een maximale requestbody-grootte van 8 MB. Als je de rate limit overschrijdt, retourneert de API een 429-statuscode; wacht een paar seconden en probeer het opnieuw. Een 401-fout geeft een ongeldige of ingetrokken sleutel aan, terwijl een 402-fout betekent dat je prepaid credit verbruikt is. Het model ondersteunt een contextvenster van 100.000 tokens voor zowel input als output samen. Zorg dat je prompts binnen deze limiet passen om truncatie te vermijden. Content filters blijven minimaal, met uitzondering van een harde blokkade op seksuele content met minderjarigen.
