Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Formát odpovede: id, choices a finish_reason

Lekcia 8 z 12 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Anatómia odpovede Chat Completions
  2. Kompletná štruktúra odpovede
  3. Pole choices
  4. Hodnoty finish_reason
  5. Spracovanie rôznych prípadov
  6. Kľúčové poznatky

Aktualizované 3. novembra 2026 na základe referencie API Chat Completions od xAI: pre finish_reason sú zdokumentované iba hodnoty stop, length a pri streamovaní end_turn alebo null. Hodnoty tool_calls a content_filter zo staršej verzie nie sú uvedené a volania nástrojov sa detegujú cez message.tool_calls. Parameter max_tokens je zastaraný v prospech max_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í.

id
Jedinečný identifikátor
choices
Pole odpovedí
usage
Počítadlá tokenov
system_fingerprint
Odtlačok systému

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át chatcmpl-...). 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 s role (vždy "assistant") a content (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, pole choices a objekt usage
  • Vygenerovaný text sa nachádza v choices[0].message.content
  • finish_reason indikuje, prečo sa generovanie zastavilo: referencia dokumentuje stop a length (a end_turn alebo null pri streamovaní)
  • Skontroluj finish_reason na odhalenie orezaných odpovedí a message.tool_calls pre volania nástrojov
  • system_fingerprint identifikuje konfiguráciu systému použitú na generovanie