API-snelstart

Authenticatie & basis-URL

De API gebruikt standaard OpenAI-compatibele authenticatie. Je ontvangt direct na het aanmelden met Google of e-mail een API-sleutel. Gebruik deze sleutel in de Authorization header voor alle verzoeken. De basis-URL is vast ingesteld op https://api.mistralabliterated.com/v1. Voor het endpoint-pad is geen extra configuratie nodig.

Copycurl https://api.mistralabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the first five prime numbers"}]
  }'

Je sleutel identificeert je account en houdt gebruik bij. Als je je sleutel verliest, genereer dan een nieuwe; de oude wordt ongeldig.

POST /v1/chat/completions

Stuur berichten naar het model via het standaard chat-completion eindpunt. De model ID is altijd uncensored. Dit endpoint verwerkt tekst-in, tekst-uit interacties zonder dat je complexe payload-structuren nodig hebt. Je kunt system-, user- en assistant-berichten in één verzoek sturen.

Copyfrom openai import OpenAI

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

Het verzoek retourneert een gestructureerd JSON-antwoord met de uitvoer van het model. Je kunt parameters zoals temperature en top_p aanpassen om creativiteit te sturen. Het model weigert geen wettelijke volwassen of controversiële onderwerpen, wat resulteert in een rauwe responsstijl. Fouten retourneren standaard HTTP-statuscodes voor eenvoudige debugging in je codebase.

GET /v1/models

Vraag beschikbare modellen op om de connectiviteit en configuratie te verifiëren. Dit eindpunt retourneert een lijst met beschikbare modellen, wat bevestigt dat je authenticatie en basis-URL correct zijn. Dit is nuttig om je integratie te testen voordat je zware payloads verstuurt.

Copyimport OpenAI from "openai";

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

De respons bevat het model-ID en het objecttype. Je kunt dit endpoint gebruiken in de opstartvolgorde van je applicatie om te verzekeren dat de API bereikbaar is. Het retourneert direct met lage latentie, wat het ideaal maakt voor health checks. Er wordt geen credit verbruikt door dit verzoek.

Streaming & Tools

Activeer streaming door stream: true in je verzoek. De API stuurt tekstchunks via Server-Sent Events (SSE) zodra ze gegenereerd zijn. Dit vermindert de waargenomen latentie voor gebruikers die wachten op lange antwoorden. Je kunt ook functaanroepen gebruiken door een lijst met tools in het verzoek op te geven.

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)

Tokengebruikstatistieken zijn opgenomen in het laatste chunk van de stream. Hiermee kun je kosten in real-time bijhouden. Het model ondersteunt JSON-modus voor gestructureerde outputs wanneer je response_format naar {"type": "json_object"}Toolkeuzes zijn flexibel, waardoor specifieke of automatische selectie mogelijk is.

Parameters & Limieten

Het contextvenster ondersteunt 100.000 tokens voor gecombineerde prompt en completion. Maximaal uitvoerbedrag per verzoek is 16.000 tokens, of 2.048 als je niet specificeert max_tokens. Je kunt generatie regelen met temperature, top_p, stop, en seed parameters. Frequentie- en aanwezigheidsstraffen zijn ook beschikbaar voor het afstemmen van de uitvoer.

Rate limits allow 300 requests per minute per key and 8 concurrent requests. The maximum request body size is 8 MB. These limits ensure stable performance for high-throughput applications. Adjust your batching strategy to stay within these bounds.

Fouten & Prijzen

HTTP 401 geeft een ongeldige of ontbrekende API-sleutel aan. HTTP 402 betekent dat je vooruitbetaalde tegoed op is; vul aan met crypto om door te gaan. HTTP 429 signaleert dat de rate limit is bereikt; wacht of verlaag de concurrentie. Fouten verbruiken geen tegoed, dus je wordt niet gefactureerd voor mislukte verzoeken.

Prijzen zijn $0,15 per miljoen invoertokens en $0,50 per miljoen uitvoertokens. Krediet vervalt niet, en er zijn geen maandelijkse kosten. Opwaarderingen beginnen bij $20 met bonussen voor hogere bedragen. Restituties zijn niet beschikbaar, maar support kan dubbele charges repareren.