API Documentatie

Authenticatie & basis-URL

Wijs je client eerst naar de juiste basis-URL. We accepteren standaard OpenAI-headers voor compatibiliteit. Je API-sleutel gaat in de Authorization-header als een bearer-token. Geef deze direct door vanuit je omgevingsvariabelen om het hardcoderen van geheimen te voorkomen. Deze opstelling werkt met elke bibliotheek die het OpenAI-protocol ondersteunt.

Eerste verzoek

Stuur een eenvoudige chatcompletion om de connectiviteit te verifiëren. Gebruik de model-ID "uncensored" voor tekstgeneratie. Het endpoint retourneert standaard JSON met keuzes en gebruiksmetrics. Als je een 401 krijgt, controleer dan je sleutelformaat. Een 402 geeft onvoldoende vooruitbetaald saldo aan. Deze snelle test bevestigt dat je integratie klaar is voor productieverkeer.

Copycurl https://api.mistralbaseurl.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List installed python packages with versions"}]
  }'

Python SDK Integratie

Configureer het OpenAI Python-pakket om onze basis-URL te gebruiken. Stel de API-sleutel en modelnaam expliciet in. Geef je berichten door als een lijst van dictionaries met role- en content-keys. Het antwoordobject bevat de gegenereerde tekst in choices[0].message.content. Behandel uitzonderingen zorgvuldig om netwerk- of rate limit-fouten tijdens de uitvoering op te vangen.

Copyfrom openai import OpenAI

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

Initialiseer de OpenAI-client met uw basis-URL en sleutel. Definieer de messages-array met user- en assistant-rollen. Roep chat.completions.create aan met het uncensored-model. De respons bevat de gegenereerde tekst in de eerste keuze. Gebruik dit patroon voor zowel synchrone als asynchrone aanroepen in uw Node-toepassingen.

Copyimport OpenAI from "openai";

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

Schakel streamen in door stream in te stellen op true. De API verzendt chunks van gegevens zodra ze worden gegenereerd. Elke chunk bevat tekstdelta die je aan een buffer kunt toevoegen. Deze aanpak vermindert de waargenomen latentie bij lange outputs. Monitor token-gebruik in de laatste chunk om facturering nauwkeurig bij te houden.

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)

Limieten & Contextvenster

Je account ondersteunt een contextvenster van 100.000 tokens. Maximaal 16.000 tokens output per verzoek. Je kunt 300 verzoeken per minuut versturen. Slechts 8 verzoeken lopen gelijktijdig. Verzoeken met een body groter dan 8 MB zullen falen. Gebruik deze limieten om je retry-logica te ontwerpen. Fouten zoals 429 geven een rate limit-miss aan. Weigeringen verbruiken geen credits.