Snelstartgids voor Mistral-gebruikers

Basis-URL & Authenticatie

Onze API is volledig compatibel met de OpenAI SDK's. Je hoeft alleen de basis-URL aan te passen en je API-sleutel op te geven. De basis-URL voor deze service is https://api.mistralapi.com/v1. Authenticatie verloopt via de Authorization-header met een Bearer-token. In tegenstelling tot sommige providers hoeven ze geen complexe routing of vendor-specifieke headers; je geeft je sleutel gewoon door zoals je dat normaal doet.

• Basis-URL: https://api.mistralapi.com/v1
• Koptekst: Authorization: Bearer YOUR_API_KEY

Je API-sleutel wordt direct gegenereerd na het aanmaken van een account. Bewaar deze veilig, omdat deze toegang geeft tot je prepaid tegoed. Er zijn geen maandelijkse abonnementskosten, alleen pay-as-you-go prijzen gebaseerd op token-gebruik.

Chat Completions Endpoint

De kern van onze API is het POST /v1/chat/completions-endpoint. Het accepteert een lijst met berichten en retourneert een gegenereerd antwoord. Dit endpoint ondersteunt het standaard berichtformaat dat door de meeste LLM-clients wordt gebruikt. Je moet de model-ID opgeven als "uncensored". Dit model is een open-weight taalmodel gehost op onze servers, afgestemd om te antwoorden zonder inhoudsweigeringen voor wettelijk volwassen gebruik.

• Endpoint: POST /v1/chat/completions
• Model-ID: uncensored

De API retourneert alleen tekstantwoorden. Het ondersteunt geen afbeeldingen, audio, video of embeddings. Voor de meeste ontwikkelaars vervangt dit endpoint het standaard OpenAI chat-endpoint met nul code-aanpassingen behalve de basis-URL en model-ID.

Python SDK Integratie

Het gebruik van de officiële OpenAI Python library is de snelste manier om te integreren. Stel de basis-URL in op ons endpoint en verstrek je API-sleutel. De onderstaande code toont een eenvoudig tekstcompletieverzoek.

• Installeer de library: pip install openai
• Stel base_url in op https://api.mistralapi.com/v1
• Gebruik model="uncensored"

Deze aanpak werkt omdat onze API de OpenAI responsstructuur nabootst. Je kunt bestaande bibliotheken gebruiken voor streaming, function calling en JSON-modus zonder aanpassingen.

Node SDK Integratie

Voor JavaScript/TypeScript ontwikkelaars werkt het openai npm package naadloos. Configureer de client met onze basis-URL en je API-sleutel. Dit stelt je in staat dezelfde codebase te gebruiken voor zowel OpenAI als onze ongecensureerde model.

• Installeer de library: npm install openai
• Configureer baseUrl naar https://api.mistralapi.com/v1
• Specificeer model: "uncensored"

Deze compatibiliteit geldt voor alle standaardparameters zoals temperature, top_p en stop sequenties. Je kunt eenvoudig van provider wisselen door de clientconfiguratie aan te passen.

Streaming Reacties

We ondersteunen streaming reacties via Server-Sent Events (SSE). Dit stelt je in staat tokens te ontvangen zodra ze worden gegenereerd, wat de waargenomen latentie voor gebruikers vermindert. De laatste chunk van de stream bevat de token-gebruiksstatistieken voor facturatie.

• Stel stream: true in in je verzoek
• Lees chunks van de respons
• Parse de laatste chunk voor gebruiksgegevens

Streaming is ideaal voor chatinterfaces en realtime applicaties. De responsformaat komt overeen met de OpenAI streaming standaard, dus je bestaande streaming logica werkt zonder aanpassingen.

Limieten, Fouten & Contextvenster

Onze API heeft specifieke limieten om stabiliteit te garanderen. Elke API-sleutel ondersteunt 300 verzoeken per minuut en 8 gelijktijdige verzoeken. De maximale grootte van de request body is 8 MB. Het contextvenster is 100.000 tokens in totaal (prompt + voltooiing). Als je max_tokens niet instelt, is de standaard uitvoer 2.048 tokens; anders is de maximale uitvoer 32.000 tokens.

• 401: Ongeldige API-sleutel
• 402: Onvoldoende tegoed
• 429: Rate limit overschreden

Premium tegoed verloopt nooit. Fouten en weigeringen zijn gratis. Als je problemen ondervindt, gebruik dan de Support pagina voor restitutie of account hulp.

cURL

Kopiërencurl https://api.mistralapi.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

Kopiërenfrom openai import OpenAI

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

Kopiërenimport OpenAI from "openai";

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

Kopiërenstream = 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)