Chat Completions vs Responses API: Comparație
Pe această pagină
Două puncte finale, două filosofii
xAI oferă două puncte finale pentru interacțiunea cu modelele Grok: Chat Completions (/v1/chat/completions) și API-ul Responses (/v1/responses). Înțelegerea diferențelor dintre ele este esențială pentru a alege punctul final potrivit pentru proiectul dumneavoastră și pentru a planifica orice migrare potențială.
| Aspect | Chat Completions | API Responses |
|---|---|---|
| Stare | Moștenit (Legacy) | Principal (recomandat) |
| Gestionarea stării | Fără stare (trimiteți istoricul) | Cu stare (previous_response_id) |
| Stocare pe server | Nu | Da (30 de zile cu store: true) |
| Conversație | Tablou de mesaje | Înlănțuit prin ID |
| Instrumente server | Doar apeluri de funcții | web_search, x_search, code_interpreter, functions |
| Raționament criptat | Nu | Da (encrypted_content) |
| Funcționalități noi | Ne prioritizate | Prioritizate |
| Compatibilitate OpenAI | Totală | Parțială |
Gestionarea stării: diferența fundamentală
Chat Completions: dumneavoastră gestionați istoricul
La fiecare cerere, trebuie să retrimiteți întreaga conversație:
# Chat Completions — retrimiteți totul de fiecare dată
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?"}
]
)
API-ul Responses: serverul gestionează istoricul
Cu API-ul Responses, un simplu identificator este suficient pentru a continua o conversație:
# Responses API — doar ID-ul răspunsului anterior
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
)
Serverul păstrează contextul și reconstruiește istoricul automat. Nu plătiți mai puțini tokeni (istoricul este facturat în continuare), dar vă simplificați codul și reduceți dimensiunea cererilor dumneavoastră.
Instrumente și funcționalități exclusive
API-ul Responses oferă acces la instrumente server pe care Chat Completions nu le oferă:
web_search: căutare web în timp realx_search: căutare în postările de pe X (Twitter)code_interpreter: executarea codului Python lato parte a serverului
Aceste instrumente sunt integrate direct în cerere:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions suportă apeluri de funcții (instrumente definite de dezvoltator), dar nu și aceste instrumente server gestionate de xAI.
Când să utilizați Chat Completions?
Chat Completions rămâne alegerea corectă în mai multe scenarii:
- Migrare de la OpenAI: codul dumneavoastră existent funcționează fără modificări majore
- Multi-furnizor: doriți să comutați între OpenAI, Anthropic și xAI folosind același cod
- Framework-uri terțe: LangChain, LlamaIndex, Haystack și majoritatea framework-urilor utilizează formatul Chat Completions
- Control total: doriți să gestionați dumneavoastră istoricul (sumarizare, filtrare, modificare)
Când să utilizați API-ul Responses?
API-ul Responses este preferabil pentru:
- Proiecte noi: beneficiați de cele mai recente funcționalități de la început
- Instrumente server: aveți nevoie de căutare web, executare de cod sau căutare pe X
- Conversații lungi: nu este nevoie să retrimiteți istoricul la fiecare cerere
- Raționament criptat: acces la conținutul raționamentului pentru continuitate între cereri
Puncte cheie
- Chat Completions este fără stare (dumneavoastră gestionați istoricul), iar API-ul Responses este cu stare (serverul gestionează)
- API-ul Responses oferă instrumente server exclusive: web_search, x_search, code_interpreter
- Chat Completions are compatibilitate totală cu OpenAI, în timp ce API-ul Responses este specific xAI
- Ambele puncte finale facturează întregul istoric al conversației
- Utilizați Chat Completions pentru compatibilitate și API-ul Responses pentru funcționalități noi