Formáid freagartha: id, choices, agus finish_reason
Ar an leathanach seo
Nuashonraithe an 3 Samhain, 2026 bunaithe ar thagairt API Chat Completions xAI: níl ach
stop,length, agus, i sruthú,end_turnnónulldoiciméadaithe le haghaidhfinish_reason; níl na luachannatool_callsaguscontent_filterón seanleagan liostaithe, agus braitear glaonna uirlisí trímessage.tool_calls. Támax_tokensimithe in éag in ionadmax_completion_tokens. Foinse: Chat Completions.
Anatamaíocht freagartha Chat Completions
Tugann gach glao ar an bpointe deiridh Chat Completions oibiacht JSON ar ais atá struchtúrtha le réimsí caighdeánaithe. Tá sé ríthábhachtach an struchtúr seo a thuiscint chun sonraí a eastósct go ceart, chun cásanna imeallacha a láimhseáil, agus chun do chomhtháthuithe a dhífhabhtú.
Struchtúr iomlán na freagartha
Seo sampla de ghnáthfhreagra a thugann an API ar ais:
{
"id": "chatcmpl-abc123xyz",
"object": "chat.completion",
"created": 1712345678,
"model": "grok-4.20-0309-reasoning",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Is brainse de fhoghlaim mheaisín é an fhoghlaim dhomhain..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 42,
"completion_tokens": 156,
"total_tokens": 198
},
"system_fingerprint": "fp_abc123"
}
Réimsí leibhéil barr
id: Aitheantóir uathúil don chríochnú (formáidchatcmpl-...). Úsáideach le haghaidh rianaithe agus dífhabhtaithe.object: I gcónaí"chat.completion".Ligeann sé duit an cineál freagartha seo a idirdhealú ó phointí deiridh eile.created: Stampa ama Unix nuair a cruthaíodh an fhreagra.model: An tsamhail a ghin an fhreagra. D’fhéadfadh sé a bheith beagán difriúil ón tsamhail a iarradh má úsáideann tú ailias.choices: Eagar ina bhfuil an fhreagra nó na freagraí a gineadh.usage: Comhairitheoirí token le haghaidh billeála.system_fingerprint: Méarlorg ar an gcumraíocht chórais a úsáideadh.
An t-eagar choices
Is eagar é an réimse choices a bhíonn de ghnáth ina aon eilimint amháin (innéacs 0). Tá an méid seo a leanas i ngach eilimint:
index: Suíomh san eagar (tosaíonn sé ag 0)message: Oibiacht lerole(i gcónaí"assistant") aguscontent(an téacs a gineadh)finish_reason: An fáth ar stop an ghiniúint
Chun an fhreagra téacs a eastóscadh:
# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;
Luachanna finish_reason
Léiríonn an réimse finish_reason cén fáth ar stop an tsamhail ag giniúint téacs:
stop
"finish_reason": "stop"
Chríochnaigh an tsamhail a freagra go nádúrtha. Is é seo an cás is coitianta agus is inmhianaithe: dúirt an tsamhail gach rud a bhí le rá aici.
length
"finish_reason": "length"
Stop an ghiniúint toisc gur sroicheadh an teorainn aschuir—max_completion_tokens, a tháinig in ionad max_tokens atá imithe in éag anois, agus ní áirítear ach an fhreagra infheicthe. Dá bhrí sin, tá an fhreagra giorraithe: méadaigh an teorainn nó atoscaigh iarratas leanúnachta.
end_turn nó null i sruthú
I sruthú, iompraíonn gach píosa idirmheánach "end_turn" nó null in finish_reason; ní léiríonn ach an píosa deiridh an fáth stoptha.
Cad nach ndoiciméadaíonn an tagairt
Ní dhoiciméadaíonn tagairt API xAI ach na luachanna seo. Ní luaitear content_filter ná an luach a thugtar le linn glaonna uirlisí: chun a fháil amach an iarrann an tsamhail uirlis, seiceáil láithreacht message.tool_calls seachas luach finish_reason.
Cásanna éagsúla a láimhseáil
Sa táirgeadh, caithfidh tú seiceáil a dhéanamh ar finish_reason chun d’iompar a oiriúnú:
choice = response.choices[0]
if choice.message.tool_calls:
# Ba mhaith leis an tsamhail glao a chur ar uirlis amháin nó níos mó
for tool_call in choice.message.tool_calls:
print(f"Uirlis iarrtha: {tool_call.function.name}")
elif choice.finish_reason == "length":
# Freagra giorraithe: cuir an t-úsáideoir ar an eolas nó lean ar aghaidh
print(choice.message.content)
print("[Freagra giorraithe: méadaigh max_completion_tokens]")
else:
# Freagra iomlán
print(choice.message.content)
Príomhphointí
- Tá
iduathúil, eagarchoices, agus oibiachtusagesa fhreagra - Tá an téacs a gineadh suite in
choices[0].message.content - Léiríonn
finish_reasoncén fáth ar stop an ghiniúint: doiciméadaíonn an tagairtstopaguslength(agusend_turnnónulli sruthú) - Seiceáil
finish_reasonchun freagraí giorraithe a aimsiú, agusmessage.tool_callsle haghaidh glaonna uirlisí - Aithníonn
system_fingerprintan chumraíocht chórais a úsáideadh don ghiniúint