Mistral api-dokumentation: Snabbstartintegration

Autentisering: Ange ditt huvud

Börja med att generera en nyckel på vår dashboard. Processen är omedelbar och kräver ingen telefonnummerverifiering. Du behöver bara en e-postadress eller ett Google-konto för att skapa ett konto. När den har genererats visas nyckeln på skärmen omedelbart. Spara den säkert eftersom vi inte lagrar hela strängen för återhämtning. Du skickar denna sträng i Authorization header för varje begäran. Vårt system validerar denna token mot ditt förbetala saldo innan din prompt bearbetas. Om nyckeln är ogiltig eller utgången får du ett 401-fel. Vi tillåter endast en aktiv nyckel per konto för att hålla åtkomsten enkel. En ny nyckel ersätter den gamla omedelbart när du genererar en ersättning.

Slutpunkten /v1/chat/completions

Skicka din första förfrågan till vår bas-URL med standardändpunkten för chattkomplettering. Ersätt platshållar-nyckeln med dina faktiska inloggningsuppgifter. Modellidentifieraren är helt enkelt uncensored. Denna modell är finjusterad för att svara utan avvisningar för lagligt vuxeninnehåll. Den hanterar text in och text ut effektivt. Du behöver inte konfigurera komplex routning eller välja specifika modellversioner. Pecka bara din klient mot vår bas-URL och skicka payloaden. Våra servrar hanterar inferensen och returnerar den genererade texten. Denna metod säkerställer kompatibilitet med befintliga verktyg och bibliotek.

Strömsvar med SSE

Aktivera strömning för att ta emot tokens när de genereras. Detta minskar den upplevda latensen för långa utdata. Ställ in stream parameter till true i din begärans kropp. Servern returnerar en serie Server-Sent Events. Varje händelse innehåller en delvis delta av svaret. Du kan bearbeta dessa tokens i realtid för ett chattgränssnitt. Den sista biten inkluderar total tokenanvändning för begäran. Detta gör att du kan spåra kostnader noggrant när konversationen fortskrider. Strömning är idealiskt för applikationer där omedelbar återkoppling förbättrar användarupplevelsen.

Function calling och JSON-läge

Strukturera dina utdata tillförlitligt med våra stödda parametrar. Aktivera JSON-läge genom att ställa in response_format för {"type": "json_object"}. Detta tvingar modellen att returnera giltig JSON utan markdown-gränser. Du kan också definiera funktionsscheman för verktygsanvändning. Modellen kommer att följa den tillhandahållna strukturen strikt. Detta är användbart för automatisk dataextrahering eller API-kedjning. Använd tools parameter för att definiera tillgängliga funktioner. Modellen kan välja vilken funktion som ska anropas baserat på prompten. Denna funktion är avgörande för att bygga agentic arbetsflöden utan extra parsning av logik.

Parametrar: Temperatur, Top-p och Seed

Styr slumpmässigheten och determinismen i dina utdata. Justera temperature till att variera kreativitet. Lägre värden ger mer fokuserade svar. Högre värden introducerar mer variation. Använd top_p för att begränsa ordförrådsval. Detta fungerar tillsammans med temperaturen för att förbättra utdatakvaliteten. Ställ in den seed parametern för reproducerbara resultat. Identiska indata och frö kommer att ge identiska utdata. Detta är kritiskt för att felsöka och testa din integration. Du kan också ställa in stop sekvenser för att avbryta genereringen vid specifika markörer. Dessa parametrar ger dig finjusterad kontroll över modellbeteendet.

Gränser, fel och kontextfönster

Övervaka din användning mot våra definierade gränser. Kontextfönstret stödjer 100 000 tokens tillsammans. Detta möjliggör omfattande dokumentanalys eller långa samtal. Varje begäran kan mata ut upp till 16 000 tokens. Om du inte anger max_tokens, gränsen är 2 048 som standard. Du har tillgång till 300 anrop per minut per nyckel. Endast åtta anrop kan köras samtidigt per nyckel. Storleken på begärans kropp är begränsad till 8 MB. Fel som 402 indikerar otillräckligt kredit. Hastighetsbegränsningar (429) inträffar om du överskrider gränsen per minut. Krediten löper aldrig ut, så du kan pausa användningen utan att förlora medel.

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);

Strömning

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)