Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Atsakymo formatas: id, choices ir finish_reason

Paskaita 8 iš 12 Atnaujinta 2026 m. lapkričio 3 d. Kūrėjas
Šiame puslapyje
  1. „Chat Completions“ atsakymo sandara
  2. Pilna atsakymo struktūra
  3. choices masyvas
  4. finish_reason reikšmės
  5. Skirtingų atvejų valdymas
  6. Svarbiausi punktai

Atnaujinta 2026 m. lapkričio 3 d. remiantis xAI „Chat Completions“ API dokumentacija: finish_reason laukui dokumentuoti tik stop, length ir, srautiniu režimu, end_turn arba null; senesnėje versijoje buvusios tool_calls ir content_filter reikšmės nėra išvardytos, o įrankių kvietimai aptinkami per message.tool_calls. max_tokens yra pasenęs, vietoj jo naudokite max_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.

id
Unikalus identifikatorius
choices
Atsakymų masyvas
usage
Tokenų skaitliukai
system_fingerprint
Sistemos piršto atspaudas

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 (formatas chatcmpl-...). 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 su role (visada "assistant") ir content (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, choices masyvas ir usage objektas
  • Sugeneruotas tekstas yra choices[0].message.content
  • finish_reason nurodo, kodėl generavimas sustojo: dokumentacijoje nurodytos stop ir length (bei end_turn arba null srautiniu režimu)
  • Tikrinkite finish_reason, kad aptiktumėte nukirptus atsakymus, ir message.tool_calls – įrankių kvietimams
  • system_fingerprint identifikuoja generavimui naudotą sistemos konfigūraciją