Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Formát odpovědi: id, choices a finish_reason

Lekce 8 z 12 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Anatomie odpovědi Chat Completions
  2. Kompletní struktura odpovědi
  3. Pole choices
  4. Hodnoty finish_reason
  5. Zpracování různých případů
  6. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě reference API Chat Completions od xAI: pro finish_reason jsou zdokumentovány pouze hodnoty stop, length a v režimu streamování end_turn nebo null. Hodnoty tool_calls a content_filter ze starší verze nejsou uvedeny; volání nástrojů se detekují přes message.tool_calls. Parametr max_tokens je zastaralý ve prospěch max_completion_tokens. Zdroj: Chat Completions.

Anatomie odpovědi Chat Completions

Každé volání koncového bodu Chat Completions vrací objekt JSON strukturovaný pomocí standardizovaných polí. Porozumění této struktuře je zásadní pro správné extrahování dat, zpracování hraničních případů a ladění vašich integrací.

id
Jedinečný identifikátor
choices
Pole odpovědí
usage
Počítadla tokenů
system_fingerprint
Otisk systému

Kompletní struktura odpovědi

Zde je příklad typické odpovědi vrácené 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"
}

Pole nejvyšší úrovně

  • id: Jedinečný identifikátor pro dokončení (formát chatcmpl-...). Užitečné pro sledování a ladění.
  • object: Vždy "chat.completion". Umožňuje rozlišit tento typ odpovědi od ostatních koncových bodů.
  • created: Časové razítko Unix udávající, kdy byla odpověď vytvořena.
  • model: Model, který vygeneroval odpověď. Může se mírně lišit od požadovaného modelu, pokud používáte alias.
  • choices: Pole obsahující vygenerovanou odpověď nebo odpovědi.
  • usage: Počítadla tokenů pro fakturaci.
  • system_fingerprint: Otisk použité konfigurace systému.

Pole choices

Pole choices je pole, které obvykle obsahuje jediný prvek (index 0). Každý prvek obsahuje:

  • index: Pozice v poli (začíná na 0)
  • message: Objekt s role (vždy "assistant") a content (vygenerovaný text)
  • finish_reason: Důvod zastavení generování

Pro extrakci textové odpovědi:

# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;

Hodnoty finish_reason

Pole finish_reason indikuje, proč model přestal generovat text:

stop

"finish_reason": "stop"

Model přirozeně dokončil svou odpověď. Toto je nejběžnější a nejžádoucí případ: model řekl vše, co potřeboval říci.

length

"finish_reason": "length"

Generování se zastavilo, protože byl dosažen limit výstupu – max_completion_tokens, který nahrazuje nyní zastaralý max_tokens a počítá pouze viditelnou odpověď. Odpověď je tedy useknutá: zvyšte limit nebo restartujte žádost o pokračování.

end_turn nebo null při streamování

Při streamování nese každý průběžný chunk v finish_reason hodnotu "end_turn" nebo null; pouze finální chunk indikuje důvod zastavení.

Co reference nedokumentuje

Reference API xAI dokumentuje pouze tyto hodnoty. Nezmiňuje ani content_filter, ani hodnotu vrácenou během volání nástroje: chcete-li zjistit, zda model požaduje nástroj, zkontrolujte přítomnost message.tool_calls spíše než hodnotu finish_reason.

Zpracování různých případů

V produkčním prostředí musíte zkontrolovat finish_reason, abyste přizpůsobili své chování:

choice = response.choices[0]

if choice.message.tool_calls:
    # Model chce zavolat jeden nebo více nástrojů
    for tool_call in choice.message.tool_calls:
        print(f"Tool requested: {tool_call.function.name}")

elif choice.finish_reason == "length":
    # Useknutá odpověď: upozorni uživatele nebo pokračuj
    print(choice.message.content)
    print("[Useknutá odpověď: zvyšte max_completion_tokens]")

else:
    # Kompletní odpověď
    print(choice.message.content)

Klíčové poznatky

  • Odpověď obsahuje jedinečné id, pole choices a objekt usage
  • Vygenerovaný text se nachází v choices[0].message.content
  • finish_reason indikuje, proč se generování zastavilo: reference dokumentuje stop a length (a end_turn nebo null při streamování)
  • Zkontrolujte finish_reason pro odhalení useknutých odpovědí a message.tool_calls pro volání nástrojů
  • system_fingerprint identifikuje konfiguraci systému použitou pro generování