Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Endpointet /v1/chat/completions

Lektion 1 af 16 Opdateret 3. november 2026 Udvikler
På denne side
  1. Din indgang til Mistral-modeller
  2. Base-URL’en
  3. Anatomien af en anmodning
  4. Python-ækvivalent med SDK’et
  5. Struktur af svaret
  6. Almindelige fejlkode
  7. Vigtige pointer

Opdatering 2. november 2026 — Modeller. Mistral Large 3 (mistral-large-2512) og Mistral Medium 3.5 blev udfaset den 31. oktober 2026 og vil blive trukket tilbage den 30. april 2027. Deres udpegede efterfølger, Mistral Large 4 (mistral-large-4), har været tilgængelig i offentlig forhåndsvisning siden den 6. oktober. Eksemplerne i dette kursus bruger aliaset mistral-large-latest, som i øjeblikket peger på Mistral Large 3 i henhold til den officielle specifikation (verificeret 3. november 2026). Tilsvarende peger mistral-medium-latest på Mistral Medium 3.5. Disse aliaser forbliver gyldige indtil den 30. april 2027. Til nye projekter bør du teste mistral-large-4, som er deres udpegede efterfølger.

Din indgang til Mistral-modeller

Alt, hvad du gør med Mistral API’en, går gennem én enkelt sti: /v1/chat/completions. Dette er platformens centrale hub, der håndterer alle dine samtaleinteraktioner med sprogmodeller. Uanset om du bygger en intern support-chatbot, en ekstraktor, der omdanner PDF-fakturaer til databaserækker, eller en skriveassistent integreret i dit CMS, kalder disse tre tilsyneladende forskellige applikationer præcis det samme endpoint med forskellige beskeder og parametre. Du behøver ikke lære tre separate integrationer; du skal blot mestre én.

Fra april 2026 håndterer dette endpoint milliarder af anmodninger dagligt på verdensplan. At forstå dets struktur er det første skridt mod at udnytte Mistral-modeller i produktion.

1 endpoint
Til alle samtaler
POST
Enkel HTTP-metode
< 500 ms
Latens for første token (streaming)
JSON
Input/output-format

Base-URL’en

Alle anmodninger til Mistral API’en starter fra samme base:

https://api.mistral.ai/v1/chat/completions

Du sender en POST-anmodning med en JSON-brødtekst, der indeholder dine beskeder og parametre, og API’en returnerer et struktureret JSON-svar. Der er ingen sessioner, der skal åbnes, og ingen server-side tilstand, der skal vedligeholdes: hvert kald er selvindholdt.

Anatomien af en anmodning

Den hurtigste måde at verificere, at din nøgle fungerer, er at sende en minimal anmodning ved hjælp af curl direkte fra din terminal:

curl https://api.mistral.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -d '{
    "model": "mistral-large-latest",
    "messages": [
      {"role": "user", "content": "Hello, how does your API work?"}
    ]
  }'

To headere er obligatoriske: Content-Type: application/json beskriver formatet på anmodningens brødtekst, og Authorization: Bearer <din-nøgle> bærer din autentificering. Selve brødteksten skal indeholde mindst to felter: model, som er identifikatoren for den model, der skal bruges, og messages, som er arrayet, der bærer samtalen.

Python-ækvivalent med SDK’et

Når du er kommet forbi testfasen, skriver ingen rå curl-kommandoer i produktion. Det officielle SDK foretager det samme kald på blot få linjer:

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

response = client.chat.complete(
    model="mistral-large-latest",
    messages=[
        {"role": "user", "content": "Hello, how does your API work?"}
    ]
)

print(response.choices[0].message.content)

SDK’et håndterer headere, JSON-serialisering og svar-parsing for dig. Det administrerer også automatiske genforsøg ved midlertidige fejl, hvilket sparer dig for at skrive din egen genforsøgslogik, når en trafikspids forårsager en kortvarig fejl.

Struktur af svaret

Uanset hvordan du kalder API’en, returnerer den altid det samme JSON-objekt:

{
  "id": "cmpl-abc123",
  "object": "chat.completion",
  "created": 1712150400,
  "model": "mistral-large-latest",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! The Mistral API works..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 87,
    "total_tokens": 102
  }
}

Tre felter fortjener din øjeblikkelige opmærksomhed. choices er et array, der indeholder det/de genererede svar; det er her, du finder teksten til at vise brugeren. usage giver antallet af tokens for input, output og det samlede antal, hvilket giver dig mulighed for at spore de reelle omkostninger ved hver funktion i stedet for at opdage regningen ved månedens udgang. Endelig forklarer finish_reason, hvorfor modellen stoppede: stop for en naturlig afslutning, length, når token-grænsen afbrød svaret, eller tool_calls, når modellen anmoder om værktøjsudførelse. Et sammendrag, der slutter midt i en sætning, er næsten aldrig et modelproblem; det er en finish_reason på length, som ingen har læst.

Almindelige fejlkode

Når noget går galt, returnerer API’en standard HTTP-koder:

  • 400 — Forkert udformet anmodning (ugyldig JSON, manglende parameter)
  • 401 — Ugyldig eller manglende API-nøgle
  • 429 – Grænse for anmodningshastighed nået (for mange anmodninger)
  • 500 — Serverfejl (prøv igen efter få sekunder)

I Python rejser SDK’et typede undtagelser, som du kan fange, så du kan skelne mellem en udløbet nøgle og midlertidig mætning og reagere forskelligt i hvert tilfælde:

from mistralai.client import Mistral
from mistralai.client.errors import SDKError

client = Mistral(api_key=os.getenv("MISTRAL_API_KEY"))

try:
    response = client.chat.complete(
        model="mistral-large-latest",
        messages=[{"role": "user", "content": "Test"}]
    )
except SDKError as e:
    print(f"API Error: {e.status_code} — {e.message}")

Gør det til en vane at omslutte hvert kald med denne blok fra dit allerførste script. Den dag din applikation kører uden opsyn, vil den fortælle dig, hvad der fejlede, i stedet for at stoppe stille.

Vigtige pointer

  • Endpointet /v1/chat/completions er det eneste, der er nødvendigt til samtaleinteraktioner
  • Hver anmodning kræver en model og et messages-array
  • Svaret indeholder altid choices, usage og finish_reason
  • Python SDK’et forenkler kald betydeligt sammenlignet med curl
  • Brugstokens giver dig mulighed for præcist at beregne dine omkostninger