Indelingsformaat: id, choices en finish_reason
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van de xAI Chat Completions API-referentie: voor
finish_reasonzijn alleenstop,lengthen, bij streaming,end_turnofnullgedocumenteerd. De waardentool_callsencontent_filteruit de oudere versie staan er niet in vermeld; tool-aanroepen worden gedetecteerd viamessage.tool_calls.max_tokensis verouderd ten gunste vanmax_completion_tokens. Bron: Chat Completions.
Anatomie van een Chat Completions-antwoord
Elke aanroep naar het Chat Completions-eindpunt retourneert een JSON-object met gestandaardiseerde velden. Inzicht in deze structuur is essentieel om gegevens correct te extraheren, randgevallen af te handelen en uw integraties te debuggen.
Volledige antwoordstructuur
Hieronder ziet u een voorbeeld van een typisch antwoord dat door de API wordt teruggegeven:
{
"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"
}
Velden op het hoogste niveau
id: Unieke identificatie voor de voltooiing (formaatchatcmpl-...). Handig voor tracking en debugging.object: Altijd"chat.completion". Hiermee onderscheidt u dit antwoordtype van andere eindpunten.created: Unix-tijdstempel van het moment waarop het antwoord is gemaakt.model: Het model dat het antwoord heeft gegenereerd. Kan licht afwijken van het gevraagde model als u een alias gebruikt.choices: Array met het gegenereerde antwoord of de gegenereerde antwoorden.usage: Tokentellers voor facturatie.system_fingerprint: Vingerafdruk van de gebruikte systeemconfiguratie.
De choices-array
Het veld choices is een array die doorgaans één element bevat (index 0). Elk element bevat:
index: Positie in de array (begint bij 0)message: Object metrole(altijd"assistant") encontent(de gegenereerde tekst)finish_reason: De reden waarom de generatie is gestopt
Om de tekstrespons te extraheren:
# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;
Waarden voor finish_reason
Het veld finish_reason geeft aan waarom het model is gestopt met het genereren van tekst:
stop
"finish_reason": "stop"
Het model heeft zijn antwoord op natuurlijke wijze voltooid. Dit is de meest voorkomende en gewenste situatie: het model heeft gezegd wat het nodig had om te zeggen.
length
"finish_reason": "length"
De generatie is gestopt omdat de uitvoerlimiet is bereikt—max_completion_tokens, dat het inmiddels verouderde max_tokens vervangt en alleen de zichtbare respons telt. Het antwoord is daarom afgekapt: verhoog de limiet of start een vervolgverzoek.
end_turn of null bij streaming
Bij streaming bevat elk tussentijds chunk "end_turn" of null in finish_reason; alleen het laatste chunk geeft de stopreden aan.
Wat de referentie niet documenteert
De xAI API-referentie documenteert alleen deze waarden. Er wordt geen melding gemaakt van content_filter noch van de waarde die tijdens een tool-aanroep wordt teruggegeven: om te weten of het model een tool aanvraagt, controleert u de aanwezigheid van message.tool_calls in plaats van de waarde van finish_reason.
Afhandeling van verschillende gevallen
In productie moet u finish_reason controleren om uw gedrag aan te passen:
choice = response.choices[0]
if choice.message.tool_calls:
# Het model wil een of meer tools aanroepen
for tool_call in choice.message.tool_calls:
print(f"Tool requested: {tool_call.function.name}")
elif choice.finish_reason == "length":
# Afgekapt antwoord: informeer de gebruiker of ga verder
print(choice.message.content)
print("[Truncated response: increase max_completion_tokens]")
else:
# Volledig antwoord
print(choice.message.content)
Belangrijkste punten
- Het antwoord bevat een unieke
id, eenchoices-array en eenusage-object - De gegenereerde tekst staat in
choices[0].message.content finish_reasongeeft aan waarom de generatie is gestopt: de referentie documenteertstopenlength(enend_turnofnullbij streaming)- Controleer
finish_reasonom afgekapte antwoorden op te sporen, enmessage.tool_callsvoor tool-aanroepen - De
system_fingerprintidentificeert de systeemconfiguratie die voor de generatie is gebruikt