Chat Completions naspram Responses API: Usporedba
Na ovoj stranici
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 vremenux_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