Format odgovora: id, choices i finish_reason
Na ovoj stranici
Ažurirano 3. studenoga 2026. na temelju referencije xAI Chat Completions API-ja: za
finish_reasondokumentirane su samo vrijednostistop,lengthte, kod strujanja (streaming),end_turnilinull. Vrijednostitool_callsicontent_filteriz starije verzije nisu navedene, a pozivi alata detektiraju se putemmessage.tool_calls.max_tokensje zastarjelo u koristmax_completion_tokens. Izvor: Chat Completions.
Anatomija odgovora Chat Completions
Svaki poziv krajnjoj točki Chat Completions vraća JSON objekt strukturiran sa standardiziranim poljima. Razumijevanje ove strukture ključno je za ispravno izvlačenje podataka, rukovanje rubnim slučajevima i otklanjanje grešaka u tvojim integracijama.
Potpuna struktura odgovora
Evo primjera tipičnog odgovora koji vraća API:
{
"id": "chatcmpl-abc123xyz",
"object": "chat.completion",
"created": 1712345678,
"model": "grok-4.20-0309-reasoning",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Duboko učenje je grana strojnog učenja..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 42,
"completion_tokens": 156,
"total_tokens": 198
},
"system_fingerprint": "fp_abc123"
}
Polja najviše razine
id: Jedinstveni identifikator za dovršetak (formatchatcmpl-...). Koristan za praćenje i otklanjanje grešaka.object: Uvijek"chat.completion". Omogućuje razlikovanje ove vrste odgovora od drugih krajnjih točaka.created: Unix vremenska oznaka kada je odgovor stvoren.model: Model koji je generirao odgovor. Može se neznatno razlikovati od zatraženog modela ako koristiš alias.choices: Niz koji sadrži generirani odgovor ili odgovore.usage: Brojači tokena za naplatu.system_fingerprint: Otisak korištene konfiguracije sustava.
Niz choices
Polje choices je niz koji obično sadrži jedan element (indeks 0). Svaki element sadrži:
index: Pozicija u nizu (počinje od 0)message: Objekt srole(uvijek"assistant") icontent(generirani tekst)finish_reason: Razlog zaustavljanja generiranja
Za izvlačenje tekstualnog odgovora:
# Python
response_text = response.choices[0].message.content
// JavaScript
const responseText = response.choices[0].message.content;
Vrijednosti finish_reason
Polje finish_reason označava zašto je model prestao generirati tekst:
stop
"finish_reason": "stop"
Model je prirodno završio svoj odgovor. Ovo je najčešći i najpoželjniji slučaj: model je rekao sve što je trebao reći.
length
"finish_reason": "length"
Generiranje je zaustavljeno jer je dosegnuto ograničenje izlaza – max_completion_tokens, koje zamjenjuje sada zastarjeli max_tokens, i broji samo vidljivi odgovor. Odgovor je stoga odrezan: povećaj ograničenje ili ponovno pokreni zahtjev za nastavak.
end_turn ili null kod strujanja
Kod strujanja (streaming), svaki međukomadić nosi "end_turn" ili null u finish_reason; samo završni komadić označava razlog zaustavljanja.
Što referenca ne dokumentira
Referenca xAI API-ja dokumentira samo ove vrijednosti. Ne spominje ni content_filter ni vrijednost vraćenu tijekom poziva alata: da bi saznao želi li model pozvati alat, provjeri prisutnost message.tool_calls umjesto vrijednosti finish_reason.
Rukovanje različitim slučajevima
U proizvodnji moraš provjeriti finish_reason kako bi prilagodio svoje ponašanje:
choice = response.choices[0]
if choice.message.tool_calls:
# Model želi pozvati jedan ili više alata
for tool_call in choice.message.tool_calls:
print(f"Zatražen alat: {tool_call.function.name}")
elif choice.finish_reason == "length":
# Odrezan odgovor: obavijesti korisnika ili nastavi
print(choice.message.content)
print("[Odrezan odgovor: povećaj max_completion_tokens]")
else:
# Potpun odgovor
print(choice.message.content)
Ključne točke
- Odgovor sadrži jedinstveni
id, nizchoicesi objektusage - Generirani tekst nalazi se u
choices[0].message.content finish_reasonoznačava zašto je generiranje stalo: referenca dokumentirastopilength(teend_turnilinullkod strujanja)- Provjeri
finish_reasonda uočiš odrezane odgovore, amessage.tool_callsza pozive alata system_fingerprintidentificira konfiguraciju sustava korištenu za generiranje