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

Chat Completions naspram Responses API: Usporedba

Lekcija 11 od 12 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Dvije krajnje točke, dvije filozofije
  2. Upravljanje stanjem: temeljna razlika
  3. Ekskluzivni alati i značajke
  4. Kada koristiti Chat Completions?
  5. Kada koristiti Responses API?
  6. Ključne točke

Dvije krajnje točke, dvije filozofije

xAI nudi dvije krajnje točke za interakciju s modelima Grok: Chat Completions (/v1/chat/completions) i Responses API (/v1/responses). Razumijevanje njihovih razlika ključno je za odabir prave krajnje točke za tvoj projekt i planiranje eventualne migracije.

Aspekt Chat Completions API Responses
Status Zastarjelo Primarno (preporučeno)
Upravljanje stanjem Bez stanja (šalješ povijest) Sa stanjem (previous_response_id)
Pohrana na poslužitelju Ne Da (30 dana uz store: true)
Razgovor Polje poruka Povezano ID-om
Alati poslužitelja Samo pozivanje funkcija web_search, x_search, code_interpreter, functions
Šifrirano rezoniranje Ne Da (encrypted_content)
Nove značajke Nisu prioritet Prioritet
Kompatibilnost s OpenAI Potpuna Djelomična

Upravljanje stanjem: temeljna razlika

Chat Completions: ti upravljaš poviješću

Svakim zahtjevom moraš ponovno poslati cijeli razgovor:

# Chat Completions — svaki put pošalji sve
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, my name is Alice."},
        {"role": "assistant", "content": "Hello Alice! How can I help you?"},
        {"role": "user", "content": "What is my first name?"}
    ]
)

Responses API: poslužitelj upravlja poviješću

Kod Responses API-ja, jednostavan identifikator dovoljan je za nastavak razgovora:

# Responses API — samo ID prethodnog odgovora
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Hello, my name is Alice."
)

response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is my first name?",
    previous_response_id=response1.id
)

Poslužitelj zadržava kontekst i automatski rekonstruira povijest. Ne plaćaš manje tokena (povijest se i dalje naplaćuje), ali pojednostavljuješ svoj kod i smanjuješ veličinu zahtjeva.

Ekskluzivni alati i značajke

Responses API daje pristup alatima poslužitelja koje Chat Completions ne nudi:

  • web_search: pretraživanje weba u stvarnom vremenu
  • x_search: pretraživanje objava na X-u (Twitter)
  • code_interpreter: izvršavanje Python koda na strani poslužitelja

Ovi alati integrirani su izravno u zahtjev:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Chat Completions podržava pozivanje funkcija (alati koje definira programer), ali ne i ove alate poslužitelja kojima upravlja xAI.

Kada koristiti Chat Completions?

Chat Completions ostaje pravi izbor u nekoliko scenarija:

  • Migracija s OpenAI-ja: tvoj postojeći kod radi bez većih izmjena
  • Više pružatelja usluga: želiš se prebacivati između OpenAI-ja, Anthropic i xAI-ja istim kodom
  • Okviri trećih strana: LangChain, LlamaIndex, Haystack i većina okvira koriste format Chat Completions
  • Potpuna kontrola: želiš sam upravljati poviješću (sažimanje, filtriranje, modificiranje)

Kada koristiti Responses API?

Responses API poželjniji je za:

  • Nove projekte: iskoristi najnovije značajke od samog početka
  • Alate poslužitelja: trebaš pretraživanje weba, izvršavanje koda ili pretraživanje X-a
  • Duge razgovore: nema potrebe za ponovnim slanjem povijesti sa svakim zahtjevom
  • Šifrirano rezoniranje: pristup sadržaju rezoniranja za kontinuitet između zahtjeva

Ključne točke

  • Chat Completions je bez stanja (ti upravljaš poviješću), dok je Responses API sa stanjem (upravlja poslužitelj)
  • Responses API nudi ekskluzivne alate poslužitelja: web_search, x_search, code_interpreter
  • Chat Completions ima potpunu kompatibilnost s OpenAI-jem, dok je Responses API specifičan za xAI
  • Obje krajnje točke naplaćuju cijelu povijest razgovora
  • Koristi Chat Completions radi kompatibilnosti, a Responses API za nove značajke