Chat Completions vs Responses API: Jämförelse
På denna sida
Två slutpunkter, två filosofier
xAI erbjuder två slutpunkter för att interagera med Grok-modeller: Chat Completions (/v1/chat/completions) och Responses API (/v1/responses). Att förstå skillnaderna mellan dem är avgörande för att välja rätt slutpunkt för ditt projekt och planera eventuell migration.
| Aspekt | Chat Completions | API Responses |
|---|---|---|
| Status | Legacy | Primär (rekommenderas) |
| Hantering av tillstånd | Tillståndslös (skicka historik) | Tillståndsbaserad (previous_response_id) |
| Lagring på servern | Nej | Ja (30 dagar med store: true) |
| Konversation | Meddelandearray | Länkad via ID |
| Serververktyg | Endast funktionsanrop | web_search, x_search, code_interpreter, functions |
| Krypterad resonemangsförmåga | Nej | Ja (encrypted_content) |
| Nya funktioner | Inte prioriterat | Prioriterat |
| Kompatibilitet med OpenAI | Fullständig | Delvis |
Hantering av tillstånd: den fundamentala skillnaden
Chat Completions: du hanterar historiken
Vid varje begäran måste du skicka hela konversationen på nytt:
# Chat Completions — skicka allt varje gång
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: servern hanterar historiken
Med Responses API räcker det med en enkel identifierare för att fortsätta en konversation:
# Responses API — bara ID:t för föregående svar
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
)
Servern behåller kontexten och återskapar historiken automatiskt. Du betalar inte färre tokens (historiken debiteras fortfarande), men du förenklar din kod och minskar storleken på dina begäranden.
Exklusiva verktyg och funktioner
Responses API ger tillgång till serververktyg som Chat Completions inte erbjuder:
web_search: webbsökning i realtidx_search: sökning i inlägg på X (Twitter)code_interpreter: körning av Python-kod på servern
Dessa verktyg integreras direkt i begäran:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions stöder funktionsanrop (verktyg definierade av utvecklaren), men inte dessa serververktyg som hanteras av xAI.
När ska du använda Chat Completions?
Chat Completions är fortfarande det rätta valet i flera scenarier:
- Migration från OpenAI: din befintliga kod fungerar utan större ändringar
- Flera leverantörer: du vill växla mellan OpenAI, Anthropic och xAI med samma kod
- Tredjepartsramverk: LangChain, LlamaIndex, Haystack och de flesta ramverk använder formatet Chat Completions
- Full kontroll: du vill hantera historiken själv (sammanfattning, filtrering, modifiering)
När ska du använda Responses API?
Responses API är att föredra för:
- Nya projekt: dra nytta av de senaste funktionerna från start
- Serververktyg: behov av webbsökning, kodkörning eller sökning på X
- Långa konversationer: inget behov av att skicka historiken på nytt vid varje begäran
- Krypterad resonemangsförmåga: tillgång till resonemangsinnehåll för kontinuitet mellan begäranden
Viktiga punkter
- Chat Completions är tillståndslöst (du hanterar historiken), medan Responses API är tillståndsbaserat (servern hanterar)
- Responses API erbjuder exklusiva serververktyg: web_search, x_search, code_interpreter
- Chat Completions har fullständig kompatibilitet med OpenAI, medan Responses API är specifikt för xAI
- Båda slutpunkterna debiterar för hela konversationshistoriken
- Använd Chat Completions för kompatibilitet och Responses API för nya funktioner