Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Svarformat: id, choices og finish_reason

Lektion 8 af 12 Opdateret 3. november 2026 Udvikler
På denne side
  1. Anatomien af et Chat Completions-svar
  2. Komplet svarstruktur
  3. Choices-arrayet
  4. Værdier for finish_reason
  5. Håndtering af forskellige tilfælde
  6. Vigtige pointer

Opdateret 3. november 2026 baseret på xAI Chat Completions API-referencen: Kun stop, length og i streaming end_turn eller null er dokumenteret for finish_reason; værdierne tool_calls og content_filter fra den ældre version er ikke listet, og tool-kald registreres via message.tool_calls. max_tokens er forældet til fordel for max_completion_tokens. Kilde: Chat Completions.

Anatomien af et Chat Completions-svar

Hvert kald til Chat Completions-endpointen returnerer et JSON-objekt struktureret med standardiserede felter. Det er afgørende at forstå denne struktur for at kunne udtrække data korrekt, håndtere kanttilfælde og fejlfinde dine integrationer.

id
Unik identifikator
choices
Svar-array
usage
Token-tællere
system_fingerprint
System-fingeraftryk

Komplet svarstruktur

Her er et eksempel på et typisk svar returneret af API’en:

{
  "id": "chatcmpl-abc123xyz",
  "object": "chat.completion",
  "created": 1712345678,
  "model": "grok-4.20-0309-reasoning",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Deep learning is a branch of machine learning..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 156,
    "total_tokens": 198
  },
  "system_fingerprint": "fp_abc123"
}

Topniveau-felter

  • id: Unik identifikator for fuldførelsen (format chatcmpl-...). Nyttig til sporing og fejlfinding.
  • object: Altid "chat.completion". Gør det muligt at skelne denne svarstype fra andre endpoints.
  • created: Unix-tidsstempel for, hvornår svaret blev oprettet.
  • model: Den model, der genererede svaret. Kan afvige lidt fra den anmodede model, hvis du bruger et alias.
  • choices: Array, der indeholder det eller de genererede svar.
  • usage: Token-tællere til fakturering.
  • system_fingerprint: Fingeraftryk af den systemkonfiguration, der blev brugt.

Choices-arrayet

Feltet choices er et array, der normalt indeholder et enkelt element (indeks 0). Hvert element indeholder:

  • index: Position i arrayet (starter ved 0)
  • message: Objekt med role (altid "assistant") og content (den genererede tekst)
  • finish_reason: Årsagen til, at genereringen stoppede

Sådan udtrækker du tekstsvar:

# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;

Værdier for finish_reason

Feltet finish_reason angiver, hvorfor modellen stoppede med at generere tekst:

stop

"finish_reason": "stop"

Modellen afsluttede sit svar naturligt. Dette er det mest almindelige og ønskede tilfælde: modellen har sagt alt, hvad den havde brug for at sige.

length

"finish_reason": "length"

Genereringen stoppede, fordi outputgrænsen blev nået – max_completion_tokens, som erstatter den nu forældede max_tokens, og kun tæller det synlige svar. Svaret er derfor afkortet: øg grænsen eller genstart med en fortsættelsesanmodning.

end_turn eller null i streaming

I streaming bærer hver mellemliggende chunk "end_turn" eller null i finish_reason; kun den sidste chunk angiver stopårsagen.

Hvad referencen ikke dokumenterer

xAI API-referencen dokumenterer kun disse værdier. Den nævner hverken content_filter eller den værdi, der returneres under et tool-kald: for at vide, om modellen anmoder om et tool, skal du tjekke for tilstedeværelsen af message.tool_calls snarere end værdien af finish_reason.

Håndtering af forskellige tilfælde

I produktion skal du tjekke finish_reason for at tilpasse din adfærd:

choice = response.choices[0]

if choice.message.tool_calls:
    # Modellen ønsker at kalde et eller flere tools
    for tool_call in choice.message.tool_calls:
        print(f"Tool requested: {tool_call.function.name}")

elif choice.finish_reason == "length":
    # Afkortet svar: underret brugeren eller fortsæt
    print(choice.message.content)
    print("[Truncated response: increase max_completion_tokens]")

else:
    # Komplet svar
    print(choice.message.content)

Vigtige pointer

  • Svaret indeholder en unik id, et choices-array og et usage-objekt
  • Genereret tekst findes i choices[0].message.content
  • finish_reason angiver, hvorfor genereringen stoppede: referencen dokumenterer stop og length (samt end_turn eller null i streaming)
  • Tjek finish_reason for at spotte afkortede svar og message.tool_calls for tool-kald
  • system_fingerprint identificerer den systemkonfiguration, der blev brugt til generering