Atsakymo formatas: id, choices ir finish_reason
Šiame puslapyje
Atnaujinta 2026 m. lapkričio 3 d. remiantis xAI „Chat Completions“ API dokumentacija:
finish_reasonlaukui dokumentuoti tikstop,lengthir, srautiniu režimu,end_turnarbanull; senesnėje versijoje buvusiostool_callsircontent_filterreikšmės nėra išvardytos, o įrankių kvietimai aptinkami permessage.tool_calls.max_tokensyra pasenęs, vietoj jo naudokitemax_completion_tokens. Šaltinis: Chat Completions.
„Chat Completions“ atsakymo sandara
Kiekvienas užklausimas „Chat Completions“ galiniam taškui grąžina JSON objektą su standartizuotais laukais. Šios sandaros supratimas yra būtinas norint teisingai išgauti duomenis, valdyti kraštutinius atvejus ir derinti savo integracijas.
Pilna atsakymo struktūra
Štai tipinio API grąžinamo atsakymo pavyzdys:
{
"id": "chatcmpl-abc123xyz",
"object": "chat.completion",
"created": 1712345678,
"model": "grok-4.20-0309-reasoning",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Giluminis mokymasis yra mašininio mokymosi šaka..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 42,
"completion_tokens": 156,
"total_tokens": 198
},
"system_fingerprint": "fp_abc123"
}
Aukščiausio lygio laukai
id: Unikalus užbaigimo identifikatorius (formataschatcmpl-...). Naudingas sekimui ir derinimui.object: Visada `“chat.completion”. Leidžia atskirti šį atsakymo tipą nuo kitų galinių taškų.created: Unix laiko žyma, nurodanti, kada atsakymas buvo sukurtas.model: Modelis, sugeneravęs atsakymą. Gali šiek tiek skirtis nuo prašyto modelio, jei naudojate aliasą.choices: Masyvas, kuriame yra sugeneruotas atsakymas arba atsakymai.usage: Tokenų skaitliukai atsiskaitymams.system_fingerprint: Naudotos sistemos konfigūracijos piršto atspaudas.
choices masyvas
Laukas choices yra masyvas, kuris paprastai turi vieną elementą (indeksas 0). Kiekvienas elementas turi:
index: Pozicija masyve (prasideda nuo 0)message: Objektas surole(visada"assistant") ircontent(sugeneruotas tekstas)finish_reason: Priežastis, kodėl generavimas sustojo
Norėdami išgauti tekstinį atsakymą:
# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;
finish_reason reikšmės
Laukas finish_reason nurodo, kodėl modelis nustojė generuoti tekstą:
stop
"finish_reason": "stop"
Modelis natūraliai užbaigė savo atsakymą. Tai dažniausias ir pageidautiniausias atvejis: modelis pasakė viską, ką turėjo pasakyti.
length
"finish_reason": "length"
Generavimas sustojo, nes buvo pasiektas išvesties limitas – max_completion_tokens, kuris pakeitė dabar jau pasenusį max_tokens ir skaičiuoja tik matomą atsakymą. Todėl atsakymas yra nukirptas: padidinkite limitą arba inicijuokite tęstinio generavimo užklausą.
end_turn arba null srautiniu režimu
Srautiniu režimu kiekvienas tarpinis fragmentas finish_reason lauke turi "end_turn" arba null; tik paskutinis fragmentas nurodo sustojimo priežastį.
Ko dokumentacija nemini
xAI API dokumentacijoje nurodytos tik šios reikšmės. Joje neminimas nei content_filter, nei reikšmė, grąžinama įrankio kvietimo metu: norėdami sužinoti, ar modelis prašo įrankio, tikrinkite, ar yra message.tool_calls, o ne finish_reason reikšmę.
Skirtingų atvejų valdymas
Gamybinėje aplinkoje turite tikrinti finish_reason, kad pritaikytumėte savo elgseną:
choice = response.choices[0]
if choice.message.tool_calls:
# Modelis nori iškviesti vieną ar daugiau įrankių
for tool_call in choice.message.tool_calls:
print(f"Prašomas įrankis: {tool_call.function.name}")
elif choice.finish_reason == "length":
# Nukirptas atsakymas: informuokite vartotoją arba tęskite
print(choice.message.content)
print("[Nukirptas atsakymas: padidinkite max_completion_tokens]")
else:
# Pilnas atsakymas
print(choice.message.content)
Svarbiausi punktai
- Atsakyme yra unikalus
id,choicesmasyvas irusageobjektas - Sugeneruotas tekstas yra
choices[0].message.content finish_reasonnurodo, kodėl generavimas sustojo: dokumentacijoje nurodytosstopirlength(beiend_turnarbanullsrautiniu režimu)- Tikrinkite
finish_reason, kad aptiktumėte nukirptus atsakymus, irmessage.tool_calls– įrankių kvietimams system_fingerprintidentifikuoja generavimui naudotą sistemos konfigūraciją