Chat Completions vs Responses API: Tqabbil
F'din il-paġna
Żewġ endpoints, żewġ filosofiji
xAI toffri żewġ endpoints biex tinteraġixxi mal-mudelli Grok: Chat Completions (/v1/chat/completions) u r-Responses API (/v1/responses). Li tifhem id-differenzi tagħhom huwa essenzjali biex tagħżel l-endpoint it-tajjeb għall-proġett tiegħek u tippjana kwalunkwe migrazzjoni potenzjali.
| Aspett | Chat Completions | API Responses |
|---|---|---|
| Status | Antik (Legacy) | Primarju (rakkomandat) |
| Ġestjoni tal-istat | Mingħajr stat (ibgħat l-istorja) | B'stat (previous_response_id) |
| Ħażna fuq is-server | Le | Iva (30 jum b'store: true) |
| Konversazzjoni | Array ta' messaġġi | Imqabbad bl-ID |
| Għodod tas-server | Sejħa tal-funzjonijiet biss | web_search, x_search, code_interpreter, functions |
| Raġunar ikkriptat | Le | Iva (encrypted_content) |
| Karatteristiċi ġodda | Mhux prijorità | Prijorità |
| Kompatibbiltà ma' OpenAI | Sħiħa | Parzjali |
Ġestjoni tal-istat: id-differenza fundamentali
Chat Completions: inti timmaniġġja l-istorja
Ma’ kull talba, trid terġa’ tibgħat il-konversazzjoni kollha:
# Chat Completions — erġa' ibgħat kollox kull darba
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: is-server jimmaniġġja l-istorja
Mar-Responses API, identifikatur sempliċi huwa biżżejjed biex tkompli konversazzjoni:
# Responses API — biss l-ID tar-risposta preċedenti
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
)
Is-server iżomm il-kuntest u jerġa’ jibni l-istorja awtomatikament. Inti ma tħallasx inqas tokens (l-istorja xorta tiġi ffatturata), iżda tissimplifika l-kodiċi tiegħek u tnaqqas id-daqs tat-talbiet tiegħek.
Għodod u karatteristiċi esklużivi
Ir-Responses API jagħti aċċess għal għodod tas-server li Chat Completions ma joffrix:
web_search: tfittxija fuq il-web f’ħin realix_search: tfittxija fi ħdan posts fuq X (Twitter)code_interpreter: eżekuzzjoni ta’ kodiċi Python fuq in-naħa tas-server
Dawn l-għodod huma integrati direttament fit-talba:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions jappoġġja s-sejħa tal-funzjonijiet (għodod iddefiniti mill-iżviluppatur), iżda mhux dawn l-għodod tas-server immaniġġjati minn xAI.
Meta tuża Chat Completions?
Chat Completions jibqa’ l-għażla t-tajba f’diversi xenarji:
- Migrazzjoni minn OpenAI: il-kodiċi eżistenti tiegħek jaħdem mingħajr modifiki kbar
- Fornituri multipli: trid tibdel bejn OpenAI, Anthropic, u xAI bl-istess kodiċi
- Frameworks ta’ partijiet terzi: LangChain, LlamaIndex, Haystack, u l-biċċa l-kbira tal-frameworks jużaw il-format Chat Completions
- Kontroll sħiħ: trid timmaniġġja l-istorja int stess (sommarju, filtrar, modifika)
Meta tuża r-Responses API?
Ir-Responses API huwa preferibbli għal:
- Proġetti ġodda: ibbenefika mill-aħħar karatteristiċi mill-bidu nett
- Għodod tas-server: bżonn ta’ tfittxija fuq il-web, eżekuzzjoni ta’ kodiċi, jew tfittxija fuq X
- Konversazzjonijiet twal: l-ebda ħtieġa li terġa’ tibgħat l-istorja ma’ kull talba
- Raġunar ikkriptat: aċċess għal kontenut ta’ raġunar għall-kontinwità bejn it-talbiet
Punti Ewlenin
- Chat Completions huwa mingħajr stat (inti timmaniġġja l-istorja), ir-Responses API huwa b’stat (is-server jimmaniġġja)
- Ir-Responses API joffri għodod esklużivi tas-server: web_search, x_search, code_interpreter
- Chat Completions għandu kompatibbiltà sħiħa ma’ OpenAI, ir-Responses API huwa speċifiku għal xAI
- Ż-żewġ endpoints jiffatturaw l-istorja sħiħa tal-konversazzjoni
- Uża Chat Completions għall-kompatibbiltà, ir-Responses API għal karatteristiċi ġodda