Snelstart: gebruik de groq key api

Basis-URL en authenticatiesetup

De groq key API vervangt het standaard OpenAI-endpoint door een directe weg naar ons ongefilterde model. Stel je base_url na HTTPS://api.groqkeyapi.com/v1 en injecteer je sleutel in de Authorization header. Deze configuratie werkt met elke OpenAI-compatible client, inclusief de officiële Python- en Node SDK's. Je hoeft de modelnaam niet in je code te wijzigen; wij regelen de routing intern.

Copycurl https://api.groqkeyapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check if endpoint supports 32k context window"}]
  }'

Authenticatie is streng. Een 401-fout betekent dat je sleutel ongeldig of ontbrekend is. Zorg ervoor dat je de sleutel direct na het aanmelden kopieert, omdat deze slechts één keer wordt weergegeven.

Eerste chatcompletieverzoek

Stuur een POST-verzoek naar /v1/chat/completions met de model-ID ingesteld op "uncensored". Dit model antwoordt zonder weigeringen voor wettelijke volwassen, fictieve of controversiële onderwerpen. Het verwerkt tekstinput en retourneert tekstoutput. Je kunt parameters aanpassen zoals temperature en top_p om de creativiteit te regelen. Het contextvenster ondersteunt 100,000 tokens voor de gecombineerde prompt en voltooiing.

Copyfrom openai import OpenAI

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

Fouten tijdens verwerking verbruiken geen tegoed. Als het model een afwijzing retourneert voor minderjarigeninhoud, betaalt u niets. Dit vooruitbetaalde model zorgt ervoor dat u alleen uitgeeft aan daadwerkelijke outputtokens.

Schakel streaming in voor real-time uitvoer

Streamen via Server-Sent Events (SSE) levert tokens zodra ze worden gegenereerd. Stel stream=true in je verzoek. De laatste chunk bevat de volledige tokengebruiksstatistieken voor facturering. Deze aanpak vermindert de waargenomen latentie voor lange antwoorden. Het is ideaal voor chatinterfaces waar gebruikers tekst in real-time zien verschijnen. De SDK's verwerken de parsing automatisch.

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)

Streaming verandert niet de prijsstructuur. Je betaalt nog steeds per 1M uitvoertokens. De harde limiet van 16.000 tokens per verzoek blijft van kracht, ongeacht de streamingstatus.

Gebruik JSON-modus voor gestructureerde gegevens

Instellen response_format naar {"type": "json_object"} om strikte JSON-uitvoer af te dwingen. Dit is handig voor programmatische integraties waar je voorspelbare datastructuren nodig hebt. Het model zal proberen de respons te formatteren als geldige JSON. Het kan falen als de prompt te complex is of de output de limieten overschrijdt. Valideer de JSON altijd aan de clientkant.

Copyimport OpenAI from "openai";

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

Function calling wordt ook ondersteund. U kunt tools definiëren en het model laten kiezen welke ervan moet worden aangeroepen. Dit breidt de API-mogelijkheden uit voorbij eenvoudige tekstgeneratie.

Aanvraaglimes en foutafhandeling

De API handhaaft een limiet van 300 verzoeken per minuut per sleutel. U kunt 8 gelijktijdige verzoeken uitvoeren. De maximale grootte van het verzoeklichaam is 8 MB. Een 429-fout geeft aan dat u deze limieten hebt overschreden. Wacht een paar seconden en probeer het opnieuw. Een 402-fout betekent dat uw voorgeladen tegoed op is. Laad op via crypto om de service te hervatten. Fouten zoals 400 of 500 rekenen geen credits in.

De model-id is altijd "uncensored". Probeer niet van model te wisselen. We hosten één grote taalmodel geoptimaliseerd voor onbeperkte inhoud. Dit houdt de stack eenvoudig en snel.

Contextvenster en tokenlimieten

Je totale contextvenster is 100.000 tokens. Dit omvat zowel de inputprompt als de gegenereerde voltooiing. Het maximale antwoord per aanvraag is 16.000 tokens. Als je niet specificeert max_tokens, de standaardwaarde is 2.048 tokens. Het overschrijden van de outputlimiet zal de respons afkappen. Plan uw prompts zodat er genoeg ruimte is voor het volledige antwoord. Dit stelt u in staat diepe contextbehoud te krijgen zonder handmatig chunking.

Streaming en JSON mode hebben geen invloed op deze limieten. Ze blijven consistent voor alle verzoektypes. Gebruik de usage veld in de respons om je verbruik nauwkeurig te volgen.