Chat Completions proti Responses API: Primerjava
Na tej strani
Dve končni točki, dve filozofiji
xAI ponuja dve končni točki za interakcijo z modeli Grok: Chat Completions (/v1/chat/completions) in Responses API (/v1/responses). Razumevanje razlik med njima je ključno za izbiro prave končne točke za tvoj projekt in načrtovanje morebitne selitve.
| Vidiki | Chat Completions | API Responses |
|---|---|---|
| Status | Zastarelo | Primarno (priporočeno) |
| Upravljanje stanja | Brez stanja (pošiljanje zgodovine) | Z ohranjanjem stanja (previous_response_id) |
| Shranjevanje na strežniku | Ne | Da (30 dni z store: true) |
| Pogovor | Polje sporočil | Povezano z ID-jem |
| Orodja na strežniku | Samo klicanje funkcij | web_search, x_search, code_interpreter, functions |
| Šifrirano sklepanje | Ne | Da (encrypted_content) |
| Nove funkcije | Niso prednostne | Prednostne |
| Združljivost z OpenAI | Popolna | Delna |
Upravljanje stanja: temeljna razlika
Chat Completions: zgodovino upravljaš ti
Pri vsaki zahtevi moraš znova poslati celoten pogovor:
# Chat Completions — vsakič znova pošlji vse
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: zgodovino upravlja strežnik
Pri Responses API je za nadaljevanje pogovora dovolj preprost identifikator:
# Responses API — samo ID prejšnjega 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
)
Strežnik ohranja kontekst in samodejno rekonstruira zgodovino. Ne plačaš manj žetonov (zgodovina se še vedno zaračuna), vendar poenostaviš svojo kodo in zmanjšaš velikost svojih zahtev.
Ekskluzivna orodja in funkcije
Responses API omogoča dostop do orodij na strežniku, ki jih Chat Completions ne ponuja:
web_search: iskanje po spletu v realnem časux_search: iskanje po objavah na X (Twitter)code_interpreter: izvajanje kode Python na strežniku
Ta orodja so neposredno vključena v zahtevo:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions podpira klicanje funkcij (orodja, ki jih določi razvijalec), ne pa tudi teh orodij na strežniku, ki jih upravlja xAI.
Kdaj uporabiti Chat Completions?
Chat Completions ostaja prava izbira v več scenarijih:
- Selitev z OpenAI: tvoja obstoječa koda deluje brez večjih sprememb
- Več ponudnikov: želiš prehajati med OpenAI, Anthropic in xAI z isto kodo
- Okvirji tretjih strani: LangChain, LlamaIndex, Haystack in večina okvirjev uporablja format Chat Completions
- Popoln nadzor: želiš sam upravljati zgodovino (povzemanje, filtriranje, spreminjanje)
Kdaj uporabiti Responses API?
Responses API je prednostna izbira za:
- Nove projekte: izkoristi najnovejše funkcije že od začetka
- Orodja na strežniku: potrebuješ iskanje po spletu, izvajanje kode ali iskanje po X
- Dolge pogovore: ni treba znova pošiljati zgodovine z vsako zahtevo
- Šifrirano sklepanje: dostop do vsebine sklepanja za kontinuiteto med zahtevami
Ključne ugotovitve
- Chat Completions je brez stanja (zgodovino upravljaš ti), Responses API pa ohranja stanje (upravlja strežnik)
- Responses API ponuja ekskluzivna orodja na strežniku: web_search, x_search, code_interpreter
- Chat Completions ima popolno združljivost z OpenAI, Responses API pa je specifičen za xAI
- Obe končni točki zaračunavata celotno zgodovino pogovora
- Uporabi Chat Completions za združljivost, Responses API pa za nove funkcije