Премини към основното съдържание
Български— Изберете език
Меню

Статут на наследена версия и принципът на липсата на състояние

Урок 1 от 12 Обновен 3 ноември 2026 г. Програмист
На тази страница
  1. Крайната точка Chat Completions в екосистемата на xAI
  2. Крайна точка без състояние: Изпращайте всичко с всяка заявка
  3. Ключови изводи

Обновено на 3 ноември 2026 г. въз основа на най-добрите практики на xAI: xAI вече класифицира Chat Completions като остаряла (deprecated) и препоръчва Responses API за моделите за разсъждения на Grok. Конкретната причина е, че Chat Completions липсва поле за криптираното разсъждение на модела, поради което всеки многократен разговор или извикване на инструмент губи разсъжденията от предишните стъпки. Новите функции също се внедряват първо в Responses API. Източници: Най-добри практики на xAI · Chat Completions (наследена версия).

Крайната точка Chat Completions в екосистемата на xAI

API на xAI предлага две основни крайни точки за взаимодействие с моделите на Grok: Responses API (основната крайна точка) и крайната точка Chat Completions. Последната е маркирана като наследена версия (legacy): тя остава напълно функционална, но новите функции вече имат приоритет за Responses API.

Защо тогава да я използвате? Защото Chat Completions остава най-широко възприетата крайна точка в екосистемата. Всички съществуващи SDK на OpenAI, рамки като LangChain или LlamaIndex и хиляди уроци използват този формат. Ако мигрирате от друг доставчик или работите с инструменти на трети страни, това е вероятно крайната точка, която ще използвате първоначално.

Наследена версия
Официален статут
Без състояние
Липса на сървърно състояние
OpenAI
Съвместим формат
3600s
Препоръчителен таймаут

Крайна точка без състояние: Изпращайте всичко с всяка заявка

Фундаменталният принцип на Chat Completions е, че тя е без състояние (stateless): сървърът не пази история на разговора. При всяко извикване трябва да включите цялата история на предишните съобщения във вашата заявка.

Конкретно това означава, че за разговор с 10 размени, вашата 11-та заявка трябва да съдържа предишните 10 съобщения (потребител + асистент) плюс новото съобщение. Вашето приложение управлява тази история.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

В този пример първите три съобщения представляват историята на разговора. Само последното е новото потребителско съобщение. Моделът се нуждае от целия този контекст, за да генерира последователен отговор.

Практически последици

Този подход без състояние има няколко последици:

  • Пълен контрол: Вие решавате точно кои съобщения да бъдат изпратени до модела. Можете да филтрирате, обобщавате или модифицирате историята преди всяко извикване.
  • Пропорционална цена: Всяка заявка се таксува за всички изпратени токени, включително историята. Колкото по-дълъг е разговорът, толкова по-скъпа става всяка размяна.
  • Липса на сървърно запазване: Никакви данни не се съхраняват от страна на xAI между заявките. Това е предимство за поверителността, но изисква от Вас сами да управлявате запазването на данните.

Сравнение с Responses API

Responses API обаче е със състояние (stateful): тя пази историята на сървъра чрез previous_response_id. Не е необходимо да изпращате отново предишните съобщения – достатъчен е един прост идентификатор. Отговорите могат да се съхраняват до 30 дни с store: true.

Изборът между двете зависи от Вашия случай на употреба. Ако работите със съществуващ SDK на OpenAI или мигрирате от друг доставчик, Chat Completions е логичната отправна точка. За нов проект се препоръчва Responses API.

Ключови изводи

  • Chat Completions е маркирана като наследена версия, но остава напълно функционална и съвместима с екосистемата на OpenAI
  • Крайната точка е без състояние: трябва да изпращате отново пълната история с всяка заявка
  • Цената на всяка заявка включва всички токени от историята
  • Responses API предлага алтернатива със състояние със сървърно запазване
  • За моделите за разсъждения се препоръчва таймаут от 3600 секунди