Formát odpovede: id, choices a finish_reason
Na tejto strane
Aktualizované 3. novembra 2026 na základe referencie API Chat Completions od xAI: pre
finish_reasonsú zdokumentované iba hodnotystop,lengtha pri streamovaníend_turnalebonull. Hodnotytool_callsacontent_filterzo staršej verzie nie sú uvedené a volania nástrojov sa detegujú cezmessage.tool_calls. Parametermax_tokensje zastaraný v prospechmax_completion_tokens. Zdroj: Chat Completions.
Anatómia odpovede Chat Completions
Každé volanie koncového bodu Chat Completions vráti JSON objekt so štandardizovanými poľami. Pochopenie tejto štruktúry je kľúčové pre správne extrahovanie dát, ošetrenie hraničných prípadov a ladenie tvojich integrácií.
Kompletná štruktúra odpovede
Tu je príklad typickej odpovede vrátenej API:
{
"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"
}
Polia najvyššej úrovne
id: Jedinečný identifikátor dokončenia (formátchatcmpl-...). Užitočné na sledovanie a ladenie.object: Vždy"chat.completion". Umožňuje rozlíšiť tento typ odpovede od iných koncových bodov.created: Unixový časová pečiatka vytvorenia odpovede.model: Model, ktorý vygeneroval odpoveď. Môže sa mierne líšiť od požadovaného modelu, ak používaš alias.choices: Pole obsahujúce vygenerovanú odpoveď alebo odpovede.usage: Počítadlá tokenov pre fakturáciu.system_fingerprint: Odtlačok použitej konfigurácie systému.
Pole choices
Pole choices je pole, ktoré zvyčajne obsahuje jeden prvok (index 0). Každý prvok obsahuje:
index: Pozícia v poli (začína na 0)message: Objekt srole(vždy"assistant") acontent(vygenerovaný text)finish_reason: Dôvod zastavenia generovania
Na extrakciu textovej odpovede:
# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;
Hodnoty finish_reason
Pole finish_reason indikuje, prečo model prestal generovať text:
stop
"finish_reason": "stop"
Model prirodzene dokončil svoju odpoveď. Toto je najbežnejší a žiaduci prípad: model povedal všetko, čo potreboval.
length
"finish_reason": "length"
Generovanie sa zastavilo, pretože sa dosiahol limit výstupu – max_completion_tokens, ktorý nahrádza teraz zastaraný max_tokens a počíta iba viditeľnú odpoveď. Odpoveď je preto orezaná: zvýš limit alebo reštartuj požiadavku na pokračovanie.
end_turn alebo null pri streamovaní
Pri streamovaní každý priebežný chunk nesie v finish_reason hodnotu "end_turn" alebo null; iba posledný chunk indikuje dôvod zastavenia.
Čo referencia nedokumentuje
Referencia API xAI dokumentuje iba tieto hodnoty. Nespomína ani content_filter, ani hodnotu vrátenú počas volania nástroja: aby si zistil, či model požaduje nástroj, skontroluj prítomnosť message.tool_calls namiesto hodnoty finish_reason.
Spracovanie rôznych prípadov
V produkčnom prostredí musíš skontrolovať finish_reason, aby si prispôsobil svoje správanie:
choice = response.choices[0]
if choice.message.tool_calls:
# Model chce zavolať jeden alebo viacero nástrojov
for tool_call in choice.message.tool_calls:
print(f"Tool requested: {tool_call.function.name}")
elif choice.finish_reason == "length":
# Orezaná odpoveď: upozorni používateľa alebo pokračuj
print(choice.message.content)
print("[Truncated response: increase max_completion_tokens]")
else:
# Kompletná odpoveď
print(choice.message.content)
Kľúčové poznatky
- Odpoveď obsahuje jedinečné
id, polechoicesa objektusage - Vygenerovaný text sa nachádza v
choices[0].message.content finish_reasonindikuje, prečo sa generovanie zastavilo: referencia dokumentujestopalength(aend_turnalebonullpri streamovaní)- Skontroluj
finish_reasonna odhalenie orezaných odpovedí amessage.tool_callspre volania nástrojov system_fingerprintidentifikuje konfiguráciu systému použitú na generovanie