Formát odpovědi: id, choices a finish_reason
Na této stránce
Aktualizováno 3. listopadu 2026 na základě reference API Chat Completions od xAI: pro
finish_reasonjsou zdokumentovány pouze hodnotystop,lengtha v režimu streamováníend_turnnebonull. Hodnotytool_callsacontent_filterze starší verze nejsou uvedeny; volání nástrojů se detekují přesmessage.tool_calls. Parametrmax_tokensje zastaralý ve prospěchmax_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í.
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átchatcmpl-...). 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 srole(vždy"assistant") acontent(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, polechoicesa objektusage - Vygenerovaný text se nachází v
choices[0].message.content finish_reasonindikuje, proč se generování zastavilo: reference dokumentujestopalength(aend_turnnebonullpři streamování)- Zkontrolujte
finish_reasonpro odhalení useknutých odpovědí amessage.tool_callspro volání nástrojů system_fingerprintidentifikuje konfiguraci systému použitou pro generování