Chat Completions vs. Responses API: Sammenligning
På denne side
To endpoints, to filosofier
xAI tilbyder to endpoints til interaktion med Grok-modeller: Chat Completions (/v1/chat/completions) og Responses API (/v1/responses). Det er afgørende at forstå forskellene mellem dem for at vælge det rigtige endpoint til dit projekt og planlægge eventuel migration.
| Aspekt | Chat Completions | API Responses |
|---|---|---|
| Status | Forældet (Legacy) | Primær (anbefalet) |
| Tilstandsstyring | Uden tilstand (send historik) | Med tilstand (previous_response_id) |
| Serverlagring | Nej | Ja (30 dage med store: true) |
| Samtale | Besked-array | Kædet via ID |
| Serverværktøjer | Kun funktionskald | web_search, x_search, code_interpreter, functions |
| Krypteret ræsonnement | Nej | Ja (encrypted_content) |
| Nye funktioner | Ikke prioriteret | Prioriteret |
| OpenAI-kompatibilitet | Fuld | Delvis |
Tilstandsstyring: Den fundamentale forskel
Chat Completions: Du styrer historikken
Ved hver anmodning skal du gensende hele samtalen:
# Chat Completions — gensend alt hver gang
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: Serveren styrer historikken
Med Responses API er en simpel identifikator nok til at fortsætte en samtale:
# Responses API — kun ID'et på det tidligere 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
)
Serveren bevarer konteksten og genopbygger historikken automatisk. Du betaler ikke færre tokens (historikken faktureres stadig), men du forenkler din kode og reducerer størrelsen på dine anmodninger.
Eksklusive værktøjer og funktioner
Responses API giver adgang til serverværktøjer, som Chat Completions ikke tilbyder:
web_search: Websøgning i realtidx_search: Søgning i indlæg på X (Twitter)code_interpreter: Server-side eksekvering af Python-kode
Disse værktøjer integreres direkte i anmodningen:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions understøtter funktionskald (værktøjer defineret af udvikleren), men ikke disse serverværktøjer administreret af xAI.
Hvornår skal du bruge Chat Completions?
Chat Completions forbliver det rigtige valg i flere scenarier:
- Migration fra OpenAI: Din eksisterende kode fungerer uden større ændringer
- Flere udbydere: Du vil skifte mellem OpenAI, Anthropic og xAI med den samme kode
- Tredjepartsframeworks: LangChain, LlamaIndex, Haystack og de fleste andre frameworks bruger Chat Completions-formatet
- Fuld kontrol: Du vil selv administrere historikken (sammendrag, filtrering, ændring)
Hvornår skal du bruge Responses API?
Responses API er at foretrække til:
- Nye projekter: Dra fordel af de nyeste funktioner fra starten
- Serverværktøjer: Behov for websøgning, kodeeksekvering eller X-søgning
- Lange samtaler: Ingen grund til at gensende historikken ved hver anmodning
- Krypteret ræsonnement: Adgang til ræsonnementsindhold for kontinuitet mellem anmodninger
Vigtige pointer
- Chat Completions er uden tilstand (du styrer historikken), mens Responses API er med tilstand (serveren styrer)
- Responses API tilbyder eksklusive serverværktøjer: web_search, x_search, code_interpreter
- Chat Completions har fuld OpenAI-kompatibilitet, mens Responses API er specifik for xAI
- Begge endpoints fakturerer for hele samtalehistorikken
- Brug Chat Completions til kompatibilitet og Responses API til nye funktioner