Formāts atbildei: id, choices un finish_reason
Šajā lapā
Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI Chat Completions API dokumentāciju: laukam
finish_reasonir dokumentētas tikai vērtībasstop,lengthun straumēšanas režīmāend_turnvainull. Vecākajā versijā minētās vērtībastool_callsuncontent_filternav iekļautas, un rīku izsaukumi tiek noteikti, pārbaudotmessage.tool_calls. Parametrsmax_tokensir novecojis; tā vietā izmantomax_completion_tokens. Avots: Chat Completions.
Chat Completions atbildes uzbūve
Katrs pieprasījums Chat Completions galapunktam atgriež JSON objektu ar standartizētiem laukiem. Šīs struktūras izpratne ir būtiska, lai pareizi iegūtu datus, apstrādātu robežgadījumus un atkļūdotu savas integrācijas.
Pilna atbildes struktūra
Lūk, piemērs tipiskai API atgrieztai atbildei:
{
"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"
}
Augšējā līmeņa lauki
id: Unikāls pabeigtās ģenerēšanas identifikators (formātschatcmpl-...). Noder izsekošanai un atkļūdošanai.object: Vienmēr ir"chat.completion". Ļauj atšķirt šo atbildes veidu no citiem galapunktiem.created: Unix laika zīmogs, kad atbilde tika ģenerēta.model: Modelis, kas ģenerēja atbildi. Tas var nedaudz atšķirties no pieprasītā modeļa, ja izmantojat aliasu.choices: Masīvs, kas satur ģenerēto atbildi vai atbildes.usage: Tokenu skaitītāji rēķinu veidošanai.system_fingerprint: Izmantotās sistēmas konfigurācijas pirkstu nospiedums.
Masīvs choices
Lauks choices ir masīvs, kas parasti satur vienu elementu (indekss 0). Katrs elements satur:
index: Pozīcija masīvā (sākas ar 0)message: Objekts arrole(vienmēr"assistant") uncontent(ģenerētais teksts)finish_reason: Iemesls, kāpēc ģenerēšana tika apturēta
Lai iegūtu teksta atbildi:
# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;
finish_reason vērtības
Lauks finish_reason norāda, kāpēc modelis pārtrauca teksta ģenerēšanu:
stop
"finish_reason": "stop"
Modelis ir dabiski pabeidzis savu atbildi. Tas ir visbiežāk sastopamais un vēlamais gadījums: modelis ir pateicis visu, kas bija nepieciešams.
length
"finish_reason": "length"
Ģenerēšana tika apturēta, jo tika sasniegts izvades limits – max_completion_tokens, kas aizstāj novecojušo max_tokens un skaita tikai redzamo atbildi. Tādējādi atbilde ir saīsināta: palielini limitu vai atsāk pieprasījumu turpinājumam.
end_turn vai null straumēšanas režīmā
Straumēšanas režīmā katrs starpposma fragments satur "end_turn" vai null laukā finish_reason; tikai pēdējais fragments norāda apturēšanas iemeslu.
Ko dokumentācija nemin
xAI API dokumentācijā ir minētas tikai šīs vērtības. Tajā nav pieminēts ne content_filter, ne vērtība, kas tiek atgriezta rīka izsaukuma laikā: lai uzzinātu, vai modelis pieprasa rīku, pārbaudi message.tool_calls esamību, nevis finish_reason vērtību.
Dažādu gadījumu apstrāde
Darba vidē tev ir jāpārbauda finish_reason, lai pielāgotu savu darbību:
choice = response.choices[0]
if choice.message.tool_calls:
# Modelis vēlas izsaukt vienu vai vairākus rīkus
for tool_call in choice.message.tool_calls:
print(f"Tool requested: {tool_call.function.name}")
elif choice.finish_reason == "length":
# Saīsināta atbilde: informē lietotāju vai turpini
print(choice.message.content)
print("[Saīsināta atbilde: palielini max_completion_tokens]")
else:
# Pilnīga atbilde
print(choice.message.content)
Galvenās atziņas
- Atbilde satur unikālu
id, masīvuchoicesun objektuusage - Ģenerētais teksts atrodas vietā
choices[0].message.content finish_reasonnorāda, kāpēc ģenerēšana apstājās: dokumentācijā minētistopunlength(kā arīend_turnvainullstraumēšanas režīmā)- Pārbaudi
finish_reason, lai noteiktu saīsinātas atbildes, unmessage.tool_calls, lai noteiktu rīku izsaukumus system_fingerprintidentificē ģenerēšanai izmantoto sistēmas konfigurāciju