Konwencje nazewnictwa
Na tej stronie
Zaktualizowano 3 listopada 2026 r. Na podstawie strony Models od xAI (sekcja Model Aliases): tabela zawiera model
grok-4.7, rekomendowany przez xAI, orazgrok-4.6. Zalecenie produkcyjne follows wytyczne xAI, które doradzają używanie aliasu w większości przypadków, a wersji z datą dla przepływów pracy wymagających ścisłej spójności. Źródło: Models.
Zrozumienie identyfikatorów modeli
Gdy wywołujesz API xAI, pole model decyduje o tym, który model przetworzy Twoje żądanie. xAI stosuje ustrukturyzowany system nazewnictwa z aliasami i przypiętymi wersjami. Zrozumienie tego systemu jest kluczowe dla zarządzania stabilnością i migracją Twoich aplikacji.
Trzy formaty identyfikatorów
xAI oferuje trzy sposoby odwoływania się do modelu, każdy o odmiennym zachowaniu:
Prosty alias
{
"model": "grok-4.20"
}
Prosty alias wskazuje na najnowszą stabilną wersję modelu. Gdy xAI wypuszcza drobną aktualizację, alias automatycznie przekierowuje do nowej wersji. Twoja aplikacja zawsze korzysta z najnowszej stabilnej wersji bez konieczności zmian w kodzie.
Zaleta: automatycznie korzystasz z ulepszeń. Ryzyko: zachowanie może się nieznacznie zmienić z wersji na wersję.
Alias najnowszy (latest)
{
"model": "grok-4.20-latest"
}
Alias najnowszy wskazuje na wersję typu „bleeding edge“ – samą najnowszą iterację, włączając w to wersje, które nie zostały jeszcze promowane do statusu stabilnego. Jest to wersja najbardziej aktualna, ale potencjalnie najmniej przetestowana.
Zaleta: natychmiastowy dostęp do najnowszych ulepszeń. Ryzyko: zachowanie może zmienić się w dowolnym momencie; możliwe są regresje.
Wersja przypięta
{
"model": "grok-4.20-0309"
}
Wersja przypięta identyfikuje konkretną wersję modelu, indeksowaną według daty wydania (tutaj: 9 marca). Ta wersja nigdy się nie zmienia: zachowanie, które obserwujesz dzisiaj, będzie identyczne za sześć miesięcy.
Zaleta: całkowita stabilność, powtarzalne wyniki. Ryzyko: wersja zostanie w końcu wycofana z eksploatacji, a następnie usunięta.
Aktualne pełne identyfikatory
| Identyfikator API | Typ | Zachowanie |
|---|---|---|
| grok-4.20-0309-reasoning | Wersja przypięta | Nigdy się nie zmienia |
| grok-4.20-0309-non-reasoning | Wersja przypięta | Nigdy się nie zmienia |
| grok-4.20-multi-agent-0309 | Wersja przypięta | Nigdy się nie zmienia |
| grok-4.7 | Alias | Najnowsza stabilna wersja modelu rekomendowana przez xAI |
| grok-4.6 | Alias | Najnowsza stabilna wersja |
| grok-4.5 | Alias | Najnowsza stabilna wersja (alias `grok-4.5-latest` dla samej najnowszej) |
| grok-4.3 | Alias | Najnowsza stabilna wersja |
| grok-build-0.1 | Alias | Model kodu, najnowsza stabilna wersja |
Cykl życia modelu
Każdy model xAI przechodzi przez trzyfazowy cykl życia:
- Aktywny — model jest dostępny i rekomendowany do użytku produkcyjnego
- Przestarzały (Deprecated) — model nadal działa, ale xAI rekomenduje migrację do nowszej wersji. Przed usunięciem ogłaszany jest termin końcowy
- Przeterminowany (Obsolete) — model zostaje usunięty. Żądania skierowane do tego modelu kończą się niepowodzeniem
Śledź ogłoszenia o wycofaniu wsparcia w konsoli xAI i w notatkach wydania (release notes). Gdy model zostanie oznaczony jako przestarzały, zaplanuj migrację, nie czekając do daty jego usunięcia.
Rekomendacje w zależności od środowiska
Dewelopment
Używaj prostych aliasów (grok-4.7, grok-4.3), aby automatycznie korzystać z ulepszeń. W środowisku deweloperskim niewielka zmiana zachowania między wersjami jest akceptowalna i pozwala wykryć niezgodności przed wdrożeniem produkcyjnym.
Staging i testy
Używaj wersji przypiętych (grok-4.20-0309-reasoning), aby zapewnić powtarzalność testów. Jeśli test powiedzie się dzisiaj, musi powieść się jutro z dokładnie tym samym rezultatem.
Produkcja
xAI rekomenduje używanie prostego aliasu lub aliasu -latest w większości przypadków, co pozwala automatycznie korzystać z nowych funkcji, rezerwując wersję z datą dla przepływów pracy wymagających ścisłej spójności. Jeśli Twoje środowisko produkcyjne falls into tej kategorii – wyniki podlegające audytowi, zgodność z przepisami, testy regresji – przypnij wersję z datą i zaplanuj okresowe migracje po walidacji na środowisku staging.
Migracja między wersjami
Gdy migrujesz z jednej wersji na drugą:
- Zaktualizuj pole
modelw swoich żądaniach - Przetestuj istniejące prompty – nowsze modele mogą odpowiadać inaczej
- Sprawdź parametry API – nowa wersja może obsługiwać lub wycofywać określone parametry
- Zweryfikuj wyniki – porównaj jakościowo wyjścia ze starej i nowej wersji
Punkty końcowe API (Endpoints)
xAI utrzymuje dwa główne punkty końcowe:
/v1/responses– główny punkt końcowy, rekomendowany dla wszystkich nowych projektów/v1/chat/completions– punkt końcowy legacy, utrzymany dla kompatybilności z istniejącymi klientami
Punkt końcowy legacy nie otrzymuje już nowych funkcji. Jeśli rozpoczynasz nowy projekt, używaj wyłącznie /v1/responses.
Kluczowe wnioski
- Trzy formaty: prosty alias (stabilny), alias najnowszy (bleeding edge), wersja przypięta (niezmienna)
- W produkcji używaj wersji przypiętych dla zapewnienia stabilności
- W dewelopmencie używaj aliasów, aby korzystać z ulepszeń
- Śledź ogłoszenia o wycofaniu wsparcia i planuj swoje migracje
- Rekomendowanym punktem końcowym jest
/v1/responses, a nie/v1/chat/completions - Zawsze testuj swoje prompty podczas migracji między wersjami