Svarformat: id, choices og finish_reason
På denne side
Opdateret 3. november 2026 baseret på xAI Chat Completions API-referencen: Kun
stop,lengthog i streamingend_turnellernuller dokumenteret forfinish_reason; værdiernetool_callsogcontent_filterfra den ældre version er ikke listet, og tool-kald registreres viamessage.tool_calls.max_tokenser forældet til fordel formax_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.
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 (formatchatcmpl-...). 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 medrole(altid"assistant") ogcontent(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, etchoices-array og etusage-objekt - Genereret tekst findes i
choices[0].message.content finish_reasonangiver, hvorfor genereringen stoppede: referencen dokumentererstopoglength(samtend_turnellernulli streaming)- Tjek
finish_reasonfor at spotte afkortede svar ogmessage.tool_callsfor tool-kald system_fingerprintidentificerer den systemkonfiguration, der blev brugt til generering