Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Formāts atbildei: id, choices un finish_reason

Nodarbība 8 no 12 Atjaunota 2026. gada 3. novembris Programmētājs
Šajā lapā
  1. Chat Completions atbildes uzbūve
  2. Pilna atbildes struktūra
  3. Masīvs choices
  4. finish_reason vērtības
  5. Dažādu gadījumu apstrāde
  6. Galvenās atziņas

Atjaunināts 2026. gada 3. novembrī, pamatojoties uz xAI Chat Completions API dokumentāciju: laukam finish_reason ir dokumentētas tikai vērtības stop, length un straumēšanas režīmā end_turn vai null. Vecākajā versijā minētās vērtības tool_calls un content_filter nav iekļautas, un rīku izsaukumi tiek noteikti, pārbaudot message.tool_calls. Parametrs max_tokens ir novecojis; tā vietā izmanto max_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.

id
Unikāls identifikators
choices
Atbilžu masīvs
usage
Tokenu skaitītāji
system_fingerprint
Sistēmas pirkstu nospiedums

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āts chatcmpl-...). 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 ar role (vienmēr "assistant") un content (ģ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īvu choices un objektu usage
  • Ģenerētais teksts atrodas vietā choices[0].message.content
  • finish_reason norāda, kāpēc ģenerēšana apstājās: dokumentācijā minēti stop un length (kā arī end_turn vai null straumēšanas režīmā)
  • Pārbaudi finish_reason, lai noteiktu saīsinātas atbildes, un message.tool_calls, lai noteiktu rīku izsaukumus
  • system_fingerprint identificē ģenerēšanai izmantoto sistēmas konfigurāciju