Przejdź do głównej treści
Polski— Wybierz język
Menu

Konwencje nazewnictwa

Lekcja 13 z 14 Zaktualizowano 3 listopada 2026 Początkujący
Na tej stronie
  1. Zrozumienie identyfikatorów modeli
  2. Trzy formaty identyfikatorów
  3. Aktualne pełne identyfikatory
  4. Cykl życia modelu
  5. Rekomendacje w zależności od środowiska
  6. Migracja między wersjami
  7. Punkty końcowe API (Endpoints)
  8. Kluczowe wnioski

Zaktualizowano 3 listopada 2026 r. Na podstawie strony Models od xAI (sekcja Model Aliases): tabela zawiera model grok-4.7, rekomendowany przez xAI, oraz grok-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:

  1. Aktywny — model jest dostępny i rekomendowany do użytku produkcyjnego
  2. Przestarzały (Deprecated) — model nadal działa, ale xAI rekomenduje migrację do nowszej wersji. Przed usunięciem ogłaszany jest termin końcowy
  3. 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ą:

  1. Zaktualizuj pole model w swoich żądaniach
  2. Przetestuj istniejące prompty – nowsze modele mogą odpowiadać inaczej
  3. Sprawdź parametry API – nowa wersja może obsługiwać lub wycofywać określone parametry
  4. 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