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

Споразумения за именуване

Урок 13 от 14 Обновен 3 ноември 2026 г. Начинаещ
На тази страница
  1. Разбиране на идентификаторите на моделите
  2. Трите формата на идентификатори
  3. Текущи пълни идентификатори
  4. Животен цикъл на модела
  5. Препоръки според средата
  6. Миграция между версии
  7. API крайни точки (Endpoints)
  8. Ключови изводи

Обновено на 3 ноември 2026 г. Въз основа на страницата Models на xAI (раздел Model Aliases): таблицата включва grok-4.7, моделът, препоръчан от xAI, и grok-4.6. Препоръката за продукционна среда следва указанията на xAI, които съветват използването на псевдоним за повечето случаи на употреба, а версията с дата – за работни потоци, изискващи строга консистентност. Източник: Models.

Разбиране на идентификаторите на моделите

Когато извиквате API на xAI, полето model определя кой модел ще обработи вашата заявка. xAI използва структурирана система за именуване с псевдоними и фиксирани версии. Разбирането на тази система е от съществено значение за управлението на стабилността и миграцията на вашите приложения.

Трите формата на идентификатори

xAI предлага три начина за препратка към модел, всеки с различно поведение:

Обикновен псевдоним

{
  "model": "grok-4.20"
}

Обикновеният псевдоним сочи към последната стабилна версия на модела. Когато xAI пусне малка актуализация, псевдонимът автоматично се пренасочва към новата версия. Вашето приложение винаги използва най-новата стабилна версия без промени в кода.

Предимство: автоматично се възползвате от подобренията. Риск: поведението може леко да се промени от една версия към следващата.

Псевдоним „най-нова версия“ (latest)

{
  "model": "grok-4.20-latest"
}

Псевдонимът „най-нова версия“ сочи към най-експерименталната версия – самата последна итерация, включително версии, които все още не са promovирани като стабилни. Това е най-новата, но потенциално най-малко тествана версия.

Предимство: незабавен достъп до най-новите подобрения. Риск: поведението може да се промени по всяко време; възможни са регресии.

Фиксирана версия

{
  "model": "grok-4.20-0309"
}

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

Предимство: пълна стабилност, възпроизводими резултати. Риск: версията в крайна сметка ще бъде обявена за остаряла и след това премахната.

Текущи пълни идентификатори

API Identifier Type Behavior
grok-4.20-0309-reasoning Pinned version Never changes
grok-4.20-0309-non-reasoning Pinned version Never changes
grok-4.20-multi-agent-0309 Pinned version Never changes
grok-4.7 Alias Latest stable version of the model recommended by xAI
grok-4.6 Alias Latest stable version
grok-4.5 Alias Latest stable version (alias `grok-4.5-latest` for the very latest)
grok-4.3 Alias Latest stable version
grok-build-0.1 Alias Code model, latest stable version

Животен цикъл на модела

Всеки модел на xAI следва жизнен цикъл от три фази:

  1. Активен — моделът е наличен и се препоръчва за продукционна употреба.
  2. Обявен за остарял (Deprecated) — моделът все още работи, но xAI препоръчва миграция към по-нова версия. Обявява се краен срок преди премахването.
  3. Остарял (Obsolete) — моделът е премахнат. Заявките към този модел се провалят.

Следете за обявления за остаряване в конзолата на xAI и в бележките към изданията. Когато един модел бъде обявен за остарял, планирайте миграцията си, без да чакате датата на премахване.

Препоръки според средата

Разработка

Използвайте обикновени псевдоними (grok-4.7, grok-4.3), за да се възползвате автоматично от подобренията. При разработката лека промяна в поведението между версиите е приемлива и ви позволява да откриете несъвместимости преди продукционната среда.

Тестване и предпродукционна среда (Staging)

Използвайте фиксирани версии (grok-4.20-0309-reasoning), за да осигурите възпроизводимост на тестовете. Ако един тест премине днес, той трябва да премине утре с точно същия резултат.

Продукционна среда

xAI препоръчва обикновения псевдоним или псевдонима -latest за повечето случаи на употреба, което ви позволява автоматично да се възползвате от нови функции, и запазва версията с дата за работни потоци, изискващи строга консистентност. Ако вашата продукционна среда попада в тази категория – одитируеми резултати, съответствие с регулации, тестване на регресии – фиксирайте версията с дата и планирайте периодични миграции след валидиране в предпродукционната среда.

Миграция между версии

Когато мигрирате от една версия към друга:

  1. Актуализирайте полето model във вашите заявки.
  2. Тествайте съществуващите си подкани (prompts) – по-новите модели могат да отговарят различно.
  3. Проверете параметрите на API – нова версия може да поддържа или да обяви за остарели определени параметри.
  4. Валидирайте резултатите – сравнете качествено изходните данни от старата и новата версия.

API крайни точки (Endpoints)

xAI поддържа две основни крайни точки:

  • /v1/responses – основната крайна точка, препоръчителна за всички нови проекти.
  • /v1/chat/completions – остарялата крайна точка, поддържана за съвместимост със съществуващи клиенти.

Остарялата крайна точка вече не получава нови функции. Ако стартирате нов проект, използвайте изключително /v1/responses.

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

  • Три формата: обикновен псевдоним (стабилен), псевдоним „най-нова версия“ (експериментален), фиксирана версия (непроменлива).
  • В продукционна среда използвайте фиксирани версии за стабилност.
  • При разработка използвайте псевдоними, за да се възползвате от подобренията.
  • Следете за обявления за остаряване и планирайте миграциите си.
  • Препоръчителната крайна точка е /v1/responses, а не /v1/chat/completions.
  • Винаги тествайте подканите си при миграция между версии.