Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Indelingsformaat: id, choices en finish_reason

Les 8 van 12 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Anatomie van een Chat Completions-antwoord
  2. Volledige antwoordstructuur
  3. De choices-array
  4. Waarden voor finish_reason
  5. Afhandeling van verschillende gevallen
  6. Belangrijkste punten

Bijgewerkt op 3 november 2026 op basis van de xAI Chat Completions API-referentie: voor finish_reason zijn alleen stop, length en, bij streaming, end_turn of null gedocumenteerd. De waarden tool_calls en content_filter uit de oudere versie staan er niet in vermeld; tool-aanroepen worden gedetecteerd via message.tool_calls. max_tokens is verouderd ten gunste van max_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.

id
Unieke identificatie
choices
Antwoordarray
usage
Tokentellers
system_fingerprint
Systeem-vingerafdruk

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 (formaat chatcmpl-...). 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 met role (altijd "assistant") en content (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, een choices-array en een usage-object
  • De gegenereerde tekst staat in choices[0].message.content
  • finish_reason geeft aan waarom de generatie is gestopt: de referentie documenteert stop en length (en end_turn of null bij streaming)
  • Controleer finish_reason om afgekapte antwoorden op te sporen, en message.tool_calls voor tool-aanroepen
  • De system_fingerprint identificeert de systeemconfiguratie die voor de generatie is gebruikt