Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Stanje zastarelosti in načelo brezstanjnosti

Lekcija 1 od 12 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Končna točka Chat Completions v ekosistemu xAI
  2. Brezstanjna končna točka: ob vsaki zahtevi pošlji vse
  3. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi najboljših praks xAI: xAI zdaj označuje Chat Completions kot zastarelo in priporoča API Responses za razumske modele Grok. Konkreten razlog: Chat Completions nima polja za šifrirano razmišljanje modela, zato se pri vsakem večkratnem pogovoru ali klicu orodja izgubi razmišljanje iz prejšnjih korakov. Nove funkcije so prav tako najprej na voljo v API-ju Responses. Viri: Najboljše prakse xAI · Chat Completions (zastarelo).

Končna točka Chat Completions v ekosistemu xAI

API xAI ponuja dve glavni končni točki za interakcijo z modeli Grok: API Responses (primarna končna točka) in končno točko Chat Completions. Slednja je označena kot zastarela: še vedno je popolnoma funkcionalna, vendar imajo nove funkcije zdaj prednost v API-ju Responses.

Zakaj se torej ukvarjati z njo? Ker Chat Completions ostaja najbolj razširjena končna točka v ekosistemu. Vsi obstoječi SDK-ji OpenAI, ogrodja, kot sta LangChain ali LlamaIndex, in na tisoče vajenic uporabljajo to obliko. Če prehajaš od drugega ponudnika ali delaš z orodji tretjih strani, bo to verjetno prva končna točka, ki jo boš uporabil.

Zastarelo
Uradni status
Brezstanjnost
Brez stanja na strežniku
OpenAI
Združljiva oblika
3600s
Priporočeni časovni limit

Brezstanjna končna točka: ob vsaki zahtevi pošlji vse

Temeljno načelo Chat Completions je, da je brezstanjna: strežnik ne hrani zgodovine pogovora. Ob vsakem klicu moraš v svojo zahtevo vključiti celotno zgodovino prejšnjih sporočil.

To konkretno pomeni, da mora tvoja 11. zahteva pri pogovoru z 10 izmenjavami vsebovati 10 prejšnjih sporočil (uporabnik + asistent) plus novo sporočilo. Tvoja aplikacija upravlja to zgodovino.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

V tem primeru prva tri sporočila predstavljajo zgodovino pogovora. Le zadnje je novo uporabniško sporočilo. Model potrebuje ves ta kontekst, da proizvede koherenten odgovor.

Praktične posledice

Ta brezstanjni pristop ima več posledic:

  • Popoln nadzor: sam se odločiš, katera sporočila so točno poslana modelu. Pred vsakim klicem lahko zgodovino filtriraš, povzameš ali spremeniš.
  • Sorazmerni stroški: vsaka zahteva se zaračuna za vse poslane žetone, vključno z zgodovino. Daljši kot je pogovor, dražja je vsaka izmenjava.
  • Brez trajnosti na strežniku: med zahtevami na strani xAI ni shranjenih nobenih podatkov. To je prednost za zasebnost, vendar zahteva, da trajnost upravljaš sam.

Primerjava z API-jem Responses

API Responses pa je stanjen: zgodovino hrani na strani strežnika prek previous_response_id. Prejšnjih sporočil ni treba ponovno pošiljati – zadostuje preprost identifikator. Odzive je mogoče hraniti do 30 dni z nastavitvijo store: true.

Izbira med obema je odvisna od tvoje uporabe. Če delaš z obstoječim SDK-jem OpenAI ali prehajaš od drugega ponudnika, je Chat Completions logična izhodiščna točka. Za nov projekt je priporočljiv API Responses.

Ključne ugotovitve

  • Chat Completions je označen kot zastarel, vendar ostaja popolnoma funkcionalen in združljiv z ekosistemom OpenAI
  • Končna točka je brezstanjna: ob vsaki zahtevi moraš ponovno poslati celotno zgodovino
  • Strošek vsake zahteve vključuje vse žetone zgodovine
  • API Responses ponuja stanjno alternativo s trajnostjo na strani strežnika
  • Za razumske modele je priporočljiv časovni limit 3600 sekund