Chat Completions срещу Responses API: Сравнение
На тази страница
Две крайни точки, две философии
xAI предлага две крайни точки за взаимодействие с моделите на Grok: Chat Completions (/v1/chat/completions) и Responses API (/v1/responses). Разбирането на разликите между тях е от съществено значение за избора на правилната крайна точка за Вашия проект и планирането на всяка потенциална миграция.
| Аспект | Chat Completions | API Responses |
|---|---|---|
| Статус | Остарял (Legacy) | Основен (препоръчителен) |
| Управление на състоянието | Без състояние (изпращане на историята) | Съхраняващо състояние (previous_response_id) |
| Сървърно съхранение | Не | Да (30 дни със store: true) |
| Разговор | Масив от съобщения | Свързан чрез ID |
| Сървърни инструменти | Само извикване на функции | web_search, x_search, code_interpreter, functions |
| Шифровано разсъждение | Не | Да (encrypted_content) |
| Нови функции | Не са приоритет | Приоритетни |
| Съвместимост с OpenAI | Пълна | Частична |
Управление на състоянието: фундаменталната разлика
Chat Completions: Вие управлявате историята
При всяка заявка трябва да изпратите отново целия разговор:
# Chat Completions — изпращане на всичко всеки път
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: Сървърът управлява историята
При Responses API обикновен идентификатор е достатъчен, за да продължите разговора:
# Responses API — само ID на предишния отговор
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
)
Сървърът запазва контекста и автоматично реконструира историята. Не плащате по-малко токени (историята все още се таксува), но опростявате кода си и намалявате размера на заявките си.
Ексклузивни инструменти и функции
Responses API предоставя достъп до сървърни инструменти, които Chat Completions не предлага:
web_search: търсене в уеб в реално времеx_search: търсене в публикациите на X (Twitter)code_interpreter: изпълнение на Python код от страна на сървъра
Тези инструменти са интегрирани директно в заявката:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions поддържа извикване на функции (инструменти, дефинирани от разработчика), но не и тези сървърни инструменти, управлявани от xAI.
Кога да използвате Chat Completions?
Chat Completions остава правилният избор в няколко сценария:
- Миграция от OpenAI: съществуващият Ви код работи без сериозни промени
- Няколко доставчика: искате да превключвате между OpenAI, Anthropic и xAI с един и същи код
- Frameworks на трети страни: LangChain, LlamaIndex, Haystack и повечето frameworks използват формата на Chat Completions
- Пълен контрол: искате сами да управлявате историята (обобщаване, филтриране, модифициране)
Кога да използвате Responses API?
Responses API е за предпочитане за:
- Нови проекти: възползвайте се от най-новите функции от самото начало
- Сървърни инструменти: нужда от уеб търсене, изпълнение на код или търсене в X
- Дълги разговори: няма нужда да изпращате историята отново с всяка заявка
- Шифровано разсъждение: достъп до съдържание на разсъждения за непрекъснатост между заявките
Ключови изводи
- Chat Completions е без състояние (Вие управлявате историята), докато Responses API е съхраняващо състояние (сървърът управлява)
- Responses API предлага ексклузивни сървърни инструменти: web_search, x_search, code_interpreter
- Chat Completions има пълна съвместимост с OpenAI, докато Responses API е специфичен за xAI
- И двете крайни точки таксуват пълната история на разговора
- Използвайте Chat Completions за съвместимост, а Responses API за нови функции