Alias, senaste och låsta versioner
På denna sida
Tre sätt att referera till en modell
Fältet model i din förfrågan accepterar tre namnkonventioner för att beteckna vad som vid en första anblick är samma modell. Det här är inte bara pedantisk dokumentation: beroende på vilken konvention du väljer kommer din applikation antingen att få exakt samma modell vid varje anrop i månader, eller en version som kan ändras utan förvarning. De flesta oförklarliga regressionsfel i produktion – “våra svar blev längre, men ingen ändrade något” – härrör från detta.
Enkelt alias
Det enkla aliaset använder modellens basnamn utan suffix:
{
"model": "grok-4.20"
}
Detta pekar på den senaste stabila versionen av modellen. xAI kan uppdatera den underliggande versionen när som helst, och du får bara reda på det genom att övervaka dina egna utdata. Denna flexibilitet är precis vad du vill ha under utveckling och prototyputveckling: du arbetar alltid med den bästa tillgängliga versionen utan att behöva uppdatera något. Så länge du itererar över prompts, utforskar modellens kapacitet och exakt reproducerbarhet i svaren inte spelar någon roll, fungerar denna konvention utmärkt.
Alias för senaste version
Aliaset latest pekar på den mest avancerade versionen, en som ännu inte har stabiliserats:
{
"model": "grok-4.20-latest"
}
Det du får här kan ändras ofta och inkludera ändringar som fortfarande valideras. Det är ett utvärderingsverktyg, användbart för att testa kommande versioner innan de blir standardalias, mäta kvalitets- eller prestandaförbättringar och förbereda din migration med god information.
Det hör hemma i testmiljöer, aldrig i produktion. En ändring kan ske över en natt, ändra hur din prompt beter sig och nå dina användare utan varning – du kommer inte att ha någon commit-rad eller ticket att skylla på för att förstå vad som hände.
Låst version
En låst version inkluderar ett datum i identifieraren:
{
"model": "grok-4.20-0309"
}
Suffixet -0309 motsvarar releasedatumet, här den 9 mars. Denna version rör sig inte: så länge den förblir aktiv kommer modellen som svarar idag att vara samma som svarar om sex månader. Det är det enda försvarbara alternativet för produktion, av fyra tunga skäl. Ditt applikationsbeteende blir reproducerbart, vilket gör dina integrations- och regressionstester giltiga på lång sikt. Inga tysta uppdateringar kan ta dig på sängen. Tidpunkten för migration blir ett planerat teambeslut, inte något som bara händer dig. Och om beteendet ändå ändras vet du att orsaken ligger hos dig själv.
En konvention per miljö
Bästa praxis handlar inte om att välja mellan de tre, utan om att tilldela var och en sin miljö:
import os
ENVIRONMENT = os.getenv("APP_ENV", "development")
MODEL = {
"development": "grok-4.20", # Enkelt alias: senaste stabila
"staging": "grok-4.20-latest", # Senaste: testa nya funktioner
"production": "grok-4.20-0309", # Låst version: maximal stabilitet
}[ENVIRONMENT]
Tänk på denna ordbok som ett tidigt varningssystem. Din staging-miljö körs permanent på latest: om en kommande ändring bryter en prompt fångar dina integrationstester upp det innan dina användare gör det. Din produktion hålls under tiden på en låst version. Du upptäcker ändringar uppströms utan att någonsin drabbas av dem nedströms.
Att gå från en låst version till nästa
När en ny låst version dyker upp – säg grok-4.20-0612 – förtjänar bytet en procedur snarare än en enkel strängändring. Distribuera först den nya versionen till staging via aliaset latest, kör din testsuite för prompts där och jämför sedan resultaten med dem från versionen som för närvarande finns i produktion. Om jämförelsen är tillfredsställande uppdaterar du produktionskonfigurationen, övervakar metriker i 48 timmar – svarskvalitet, nöjdhet, kostnad – och validerar migrationen eller återgår till föregående version.
Jämförelsesteget är kärnan i systemet, och det förutsätter att du har sparats utdatan från den version som finns på plats: utan denna referens reduceras “jämförelse” till en känsla. Observationsfasen inkluderar avsiktligt kostnad. En nyare version kan vara mer ordrik, generera fler utdatatokens och öka din faktura med flera procent för samma upplevda kvalitet. Fyrtioåtta timmar räcker oftast för att se detta, och att återgå till föregående version förblir en enkel konfigurationsrad.
Viktiga punkter
- Enkelt alias (
grok-4.20): senaste stabila version, för utveckling - Alias för senaste version (
grok-4.20-latest): version i framkant, endast för testning - Låst version (
grok-4.20-0309): oföränderlig, det enda rekommenderade alternativet för produktion - Använd olika konventioner per miljö (dev/staging/prod)
- Planera en strukturerad migrationsprocess när du går från en låst version till en annan