Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Format odgovora: id, choices i finish_reason

Lekcija 8 od 12 Ažurirano 3. studenoga 2026. Programer
Na ovoj stranici
  1. Anatomija odgovora Chat Completions
  2. Potpuna struktura odgovora
  3. Niz choices
  4. Vrijednosti finish_reason
  5. Rukovanje različitim slučajevima
  6. Ključne točke

Ažurirano 3. studenoga 2026. na temelju referencije xAI Chat Completions API-ja: za finish_reason dokumentirane su samo vrijednosti stop, length te, kod strujanja (streaming), end_turn ili null. Vrijednosti tool_calls i content_filter iz starije verzije nisu navedene, a pozivi alata detektiraju se putem message.tool_calls. max_tokens je zastarjelo u korist max_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.

id
Jedinstveni identifikator
choices
Niz odgovora
usage
Brojači tokena
system_fingerprint
Otisak sustava

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 (format chatcmpl-...). 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 s role (uvijek "assistant") i content (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, niz choices i objekt usage
  • Generirani tekst nalazi se u choices[0].message.content
  • finish_reason označava zašto je generiranje stalo: referenca dokumentira stop i length (te end_turn ili null kod strujanja)
  • Provjeri finish_reason da uočiš odrezane odgovore, a message.tool_calls za pozive alata
  • system_fingerprint identificira konfiguraciju sustava korištenu za generiranje