Mistral api documentatie: Snelle Startintegratie

Authenticatie: Je header instellen

Begin met het genereren van een sleutel op ons dashboard. Het proces is direct en vereist geen telefoonverificatie. Je hebt alleen een e-mailadres of een Google-account nodig om een account aan te maken. Eenmaal gegenereerd, verschijnt de sleutel direct op je scherm. Bewaar deze veilig, omdat we de volledige string niet opslaan voor ophalen. Je geeft deze string door in de Authorization header voor elk verzoek. Ons systeem valideert dit token tegen je vooruitbetaalde saldo voordat je prompt wordt verwerkt. Als de sleutel ongeldig of verlopen is, ontvang je een 401-fout. We staan slechts één actieve sleutel per account toe om de toegang eenvoudig te houden. Een nieuwe sleutel vervangt de oude direct wanneer je een vervanging genereert.

Het /v1/chat/completions-eindpunt

Verstuur je eerste verzoek naar onze basis-URL via het standaard chat-completions-eindpunt. Vervang de placeholder-sleutel door je daadwerkelijke referenties. De modelidentificatie is eenvoudigweg uncensored. Dit model is afgestemd om te antwoorden zonder afwijzingen voor wettelijke volwassen inhoud. Het verwerkt tekst in en tekst out efficiënt. Je hoeft geen complexe routing te configureren of specifieke modelversies te selecteren. Wijs je client gewoon naar onze basis-URL en stuur de payload. Onze servers verwerken de inferentie en retourneren de gegenereerde tekst. Deze aanpak zorgt voor compatibiliteit met bestaande tools en bibliotheken.

Streamingresponsen met SSE

Schakel streaming in om tokens te ontvangen zodra ze worden gegenereerd. Dit vermindert de waargenomen latentie voor lange uitvoer. Stel de stream parameter naar true in je request body. De server retourneert een reeks Server-Sent Events. Elk event bevat een gedeeltelijke delta van de respons. Je kunt deze tokens in realtime verwerken voor een chatinterface. De laatste chunk bevat het totale tokengebruik voor het verzoek. Dit stelt je in staat kosten nauwkeurig te volgen terwijl het gesprek vordert. Streaming is ideaal voor applicaties waar directe feedback de gebruikerservaring verbetert.

Function calling en JSON-modus

Structureer je outputs betrouwbaar met onze ondersteunde parameters. Schakel JSON-modus in door response_format naar {"type": "json_object"}. Dit forceert het model om geldige JSON terug te geven zonder markdown-fences. Je kunt ook funtieschemas definiëren voor tool-gebruik. Het model houdt zich strikt aan de verstrekte structuur. Dit is nuttig voor geautomatiseerde data-extractie of API-kettingen. Gebruik de tools parameter om beschikbare functies te definiëren. Het model kan kiezen welke functie het moet aanroepen op basis van de prompt. Deze mogelijkheid is essentieel voor het bouwen van agentic workflows zonder extra parseerlogica.

Parameters: Temperatuur, Top-p en Seeds

Stuur de willekeur en determinisme van je outputs aan. Pas de temperature naar creativiteit te variëren. Lagere waarden leveren meer gerichte antwoorden op. Hogere waarden introduceren meer variatie. Gebruik top_p om de woordkeuze te beperken. Dit werkt samen met temperature om de outputkwaliteit te verfijnen. Stel de seed parameter voor reproduceerbare resultaten. Identieke invoer en seeds leveren identieke uitvoer op. Dit is cruciaal voor het debuggen en testen van je integratie. Je kunt ook stop sequenties om de generatie te stoppen bij specifieke markeringen. Deze parameters geven je fijne controle over het modelgedrag.

Limieten, fouten en contextvenster

Monitor uw gebruik tegen onze gedefinieerde limieten. Het contextvenster ondersteunt 100.000 tokens in totaal. Dit maakt uitgebreide documentanalyse of lange gesprekken mogelijk. Elk verzoek kan maximaal 16.000 tokens uitvoeren. Als u niet specificeert max_tokens, de limiet is standaard 2.048. Je mag 300 verzoeken per minuut per sleutel uitvoeren. Slechts acht verzoeken kunnen gelijktijdig per sleutel draaien. De grootte van de request body is beperkt tot 8 MB. Fouten zoals 402 duiden op onvoldoende tegoed. Rate limits (429) treden op als je de limiet per minuut overschrijdt. Tegoed vervalt niet, dus je kunt gebruik pauzeren zonder geld te verliezen.

cURL

Copycurl https://api.apimistral.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set temperature to 0.7 for code generation"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)