Namnkonventioner
På denna sida
Uppdaterat den 3 november 2026. Baserat på xAI:s sida Models (avsnittet Model Aliases): tabellen inkluderar
grok-4.7, modellen som rekommenderas av xAI, samtgrok-4.6. Rekommendationen för produktion följer xAI:s riktlinjer, som råder att använda aliaset för de flesta användningsfall och den datumstämplade versionen för arbetsflöden som kräver strikt konsekvens. Källa: Models.
Förstå modellidentifierare
När du anropar xAI:s API avgör fältet model vilken modell som bearbetar din begäran. xAI använder ett strukturerat namngivningssystem med alias och låsta versioner. Att förstå detta system är avgörande för att hantera stabilitet och migrering av dina applikationer.
De tre identifierarformaten
xAI erbjuder tre sätt att referera till en modell, var och en med distinkt beteende:
Enkelt alias
{
"model": "grok-4.20"
}
Det enkla aliaset pekar på den senaste stabila versionen av modellen. När xAI släpper en mindre uppdatering omdirigeras aliaset automatiskt till den nya versionen. Din applikation använder alltid den senaste stabila versionen utan kodändringar.
Fördel: du får automatiskt del av förbättringar. Risk: beteendet kan ändras något från en version till nästa.
Senaste aliaset
{
"model": "grok-4.20-latest"
}
Det senaste aliaset pekar på den allra nyaste versionen – den absolut senaste iterationen, inklusive versioner som ännu inte befordrats till stabil status. Detta är den senaste men potentiellt minst testade versionen.
Fördel: omedelbar tillgång till de senaste förbättringarna. Risk: beteendet kan ändras när som helst; regressioner är möjliga.
Låst version
{
"model": "grok-4.20-0309"
}
Den låsta versionen identifierar en specifik modellversion, indexerad efter dess releasedatum (här 9 mars). Denna version ändras aldrig: beteendet du observerar idag kommer att vara identiskt om sex månader.
Fördel: total stabilitet, reproducerbara resultat. Risk: versionen kommer så småningom att avvecklas och sedan tas bort.
Nuvarande fullständiga identifierare
| API-identifierare | Typ | Beteende |
|---|---|---|
| grok-4.20-0309-reasoning | Låst version | Ändras aldrig |
| grok-4.20-0309-non-reasoning | Låst version | Ändras aldrig |
| grok-4.20-multi-agent-0309 | Låst version | Ändras aldrig |
| grok-4.7 | Alias | Senaste stabila versionen av modellen som rekommenderas av xAI |
| grok-4.6 | Alias | Senaste stabila versionen |
| grok-4.5 | Alias | Senaste stabila versionen (aliaset `grok-4.5-latest` för den allra senaste) |
| grok-4.3 | Alias | Senaste stabila versionen |
| grok-build-0.1 | Alias | Kodmodell, senaste stabila versionen |
Modellens livscykel
Varje xAI-modell följer en livscykel i tre faser:
- Aktiv – modellen är tillgänglig och rekommenderas för produktionsanvändning
- Avvecklad – modellen fungerar fortfarande, men xAI rekommenderar migrering till en nyare version. En deadline meddelas innan borttagning
- Föråldrad – modellen tas bort. Begäranden till denna modell misslyckas
Håll utkik efter aviseringsmeddelanden om avveckling i xAI-konsolen och i versionsanteckningarna. När en modell avvecklas bör du planera din migrering utan att vänta på borttagningsdatumet.
Rekommendationer efter miljö
Utveckling
Använd enkla alias (grok-4.7, grok-4.3) för att automatiskt dra nytta av förbättringar. I utvecklingsmiljö är en liten beteendeförändring mellan versioner acceptabel och låter dig upptäcka inkompatibiliteter innan produktion.
Staging och testning
Använd låsta versioner (grok-4.20-0309-reasoning) för att säkerställa reproducerbarhet i tester. Om ett test klaras idag måste det klara sig imorgon med exakt samma resultat.
Produktion
xAI rekommenderar det enkla aliaset eller -latest-aliaset för de flesta användningsfall, vilket låter dig automatiskt dra nytta av nya funktioner, och reserverar den datumstämplade versionen för arbetsflöden som kräver strikt konsekvens. Om din produktion faller inom denna kategori – granskningsbara resultat, regelefterlevnad, regressionstestning – lås den datumstämplade versionen och planera periodiska migreringar efter validering i staging.
Migrering mellan versioner
När du migrerar från en version till en annan:
- Uppdatera fältet
modeli dina begäranden - Testa dina befintliga prompts – nyare modeller kan svara annorlunda
- Kontrollera API-parametrar – en ny version kan stödja eller avveckla vissa parametrar
- Validera resultat – jämför utdata från den gamla och den nya versionen kvalitativt
API-slutpunkter
xAI underhåller två huvudsakliga slutpunkter:
/v1/responses– huvudslutpunkten, rekommenderas för alla nya projekt/v1/chat/completions– den äldre slutpunkten, underhållen för kompatibilitet med befintliga klienter
Den äldre slutpunkten får inte längre nya funktioner. Om du startar ett nytt projekt ska du uteslutande använda /v1/responses.
Viktiga punkter
- Tre format: enkelt alias (stabilt), senaste alias (bleeding edge), låst version (oföränderlig)
- Använd låsta versioner i produktion för stabilitet
- Använd alias i utveckling för att dra nytta av förbättringar
- Håll utkik efter aviseringsmeddelanden om avveckling och planera dina migreringar
- Den rekommenderade slutpunkten är
/v1/responses, inte/v1/chat/completions - Testa alltid dina prompts när du migrerar versioner