Споразумения за именуване
На тази страница
Обновено на 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 следва жизнен цикъл от три фази:
- Активен — моделът е наличен и се препоръчва за продукционна употреба.
- Обявен за остарял (Deprecated) — моделът все още работи, но xAI препоръчва миграция към по-нова версия. Обявява се краен срок преди премахването.
- Остарял (Obsolete) — моделът е премахнат. Заявките към този модел се провалят.
Следете за обявления за остаряване в конзолата на xAI и в бележките към изданията. Когато един модел бъде обявен за остарял, планирайте миграцията си, без да чакате датата на премахване.
Препоръки според средата
Разработка
Използвайте обикновени псевдоними (grok-4.7, grok-4.3), за да се възползвате автоматично от подобренията. При разработката лека промяна в поведението между версиите е приемлива и ви позволява да откриете несъвместимости преди продукционната среда.
Тестване и предпродукционна среда (Staging)
Използвайте фиксирани версии (grok-4.20-0309-reasoning), за да осигурите възпроизводимост на тестовете. Ако един тест премине днес, той трябва да премине утре с точно същия резултат.
Продукционна среда
xAI препоръчва обикновения псевдоним или псевдонима -latest за повечето случаи на употреба, което ви позволява автоматично да се възползвате от нови функции, и запазва версията с дата за работни потоци, изискващи строга консистентност. Ако вашата продукционна среда попада в тази категория – одитируеми резултати, съответствие с регулации, тестване на регресии – фиксирайте версията с дата и планирайте периодични миграции след валидиране в предпродукционната среда.
Миграция между версии
Когато мигрирате от една версия към друга:
- Актуализирайте полето
modelвъв вашите заявки. - Тествайте съществуващите си подкани (prompts) – по-новите модели могат да отговарят различно.
- Проверете параметрите на API – нова версия може да поддържа или да обяви за остарели определени параметри.
- Валидирайте резултатите – сравнете качествено изходните данни от старата и новата версия.
API крайни точки (Endpoints)
xAI поддържа две основни крайни точки:
/v1/responses– основната крайна точка, препоръчителна за всички нови проекти./v1/chat/completions– остарялата крайна точка, поддържана за съвместимост със съществуващи клиенти.
Остарялата крайна точка вече не получава нови функции. Ако стартирате нов проект, използвайте изключително /v1/responses.
Ключови изводи
- Три формата: обикновен псевдоним (стабилен), псевдоним „най-нова версия“ (експериментален), фиксирана версия (непроменлива).
- В продукционна среда използвайте фиксирани версии за стабилност.
- При разработка използвайте псевдоними, за да се възползвате от подобренията.
- Следете за обявления за остаряване и планирайте миграциите си.
- Препоръчителната крайна точка е
/v1/responses, а не/v1/chat/completions. - Винаги тествайте подканите си при миграция между версии.