Modellens livscykel
På denna sida
Att förutse modellförändringar
Din produktionsapplikation är beroende av ett specifikt modell-ID som lagras i konfigurationen. Det ID:t är inte permanent: nya versioner lanseras, gamla avvecklas och tas sedan bort. Team som ignorerar denna tidslinje upptäcker problemet den dag deras förfrågningar börjar misslyckas i stor skala – trots att ingenting har ändrats i deras distributioner. Att förstå livscykeln gör att du kan omvandla detta driftstopp till en planerad migration.
Aktiv
Modellen är tillgänglig och rekommenderas för produktionsanvändning. Den får optimeringar och felrättningar.
Avvecklad (Deprecated)
Modellen fungerar fortfarande men kommer att tas bort. Planera din migration till efterföljaren så snart detta tillkännages.
Föråldrad (Borttagen)
Modellen har tagits bort från API:t. Alla förfrågningar som använder detta ID kommer att misslyckas med ett fel.
Modellens tre tillstånd
En aktiv modell är fullt operativ och det är det enda tillstånd du bör använda i produktion. xAI kan tillämpa mindre optimeringar utan att ändra ID:t: modellen du anropar med detta namn idag är inte nödvändigtvis byte-för-byte identisk med den från för tre månader sedan – en nyans som nästa lektion kommer att behandla praktiskt.
Att gå över till statusen avvecklad bryter ingenting. Modellen fortsätter att svara normalt, men xAI tillkännager dess framtida borttagning. Detta är signalen du har väntat på: från detta tillkännagivande har du ett fönster – vanligtvis flera veckor – på dig att förbereda, testa och distribuera bytet till efterföljaren. Ett team som övervakar avvecklingsmeddelanden migrerar i sin egen takt; ett team som inte gör det migrerar i all hast.
Tillståndet föråldrad är slutet på vägen: modellen dras tillbaka och alla förfrågningar med dess ID misslyckas. Det finns ingen automatisk reservlösning till en närliggande version, ingen nådeperiod. Om din applikation fortfarande refererar till denna modell den dagen, slutar den att fungera.
Slutpunkter och deras status
Slutpunkter följer en liknande logik, med sina egna statusar.
| Slutpunkt | Status |
|---|---|
/v1/responses | primär slutpunkt, rekommenderas för alla nya projekt |
/v1/chat/completions | äldre (legacy), underhålls för kompatibilitet |
/v1/images/generations | aktiv, bildgenerering |
/v1/tokenize-text | aktiv, token-räkning |
Fallet med /v1/chat/completions förtjänar en förklaring, eftersom dess långlivade existens skapar förvirring. Dess kompatibilitet med OpenAI-formatet gjorde den till den naturliga ingångspunkten för alla team som kom från en annan leverantör: du ändrar bas-URL:en och nyckeln, så fungerar befintlig kod. Denna fördel har en nackdel – slutpunkten får inte längre nya funktioner, eftersom utvecklingen nu fokuserar på /v1/responses. Du kan fortsätta använda den, men varje ny funktion kommer att gå dig förbi.
Isolera modellreferensen
All svårighet med en migration uppstår innan den sker, i hur din kod namnger modellen. Om den förekommer hårdkodad i femton filer blir ändringen av ID:t en skattjakt med oundvikliga förbiseenden. Om den deklareras på ett ställe tar migrationen en minut:
# config.py
GROK_MODEL = "grok-4.20-0309" # Fast version för produktion
GROK_MODEL_FAST = "grok-build-0.1"
# Underlättar migration: bara ett ställe att ändra
Prova denna övning på din egen kodbas: sök efter alla förekomster av ett modellnamn som literaler. Om antalet överstiger ett har du teknisk skuld att reglera inför nästa avveckling, inte efteråt.
Migrationsprocess
När denna centralisering är på plats följer bytet fyra steg:
- Uppdatera fältet
modeli din konfiguration - Testa dina befintliga prompts med den nya modellen i en testmiljö
- Justera vid behov: nyare modeller kan svara annorlunda, med variationer i ton, längd eller format
- Distribuera gradvis: börja med en procentandel av trafiken innan du byter helt
Steg 3 är det mest underskattade. En nyare modell är generellt bättre, men “bättre” betyder inte “identisk”: ett mer detaljerat svar bryter en kalibrerad vy, ett något annorlunda format misslyckas med JSON-tolkning, en mer försiktig ton förändrar användarupplevelsen. Det är precis detta som den gradvisa distributionen i steg 4 låter dig upptäcka på riktig trafik innan alla dina användare drabbas av det.
Viktiga punkter
- Modeller genomgår tre tillstånd: Aktiv, Avvecklad och sedan Föråldrad (borttagen)
- Slutpunkten
/v1/responsesär primär;/v1/chat/completionsär äldre och får inte längre nya funktioner - Centralisera modellnamnet i en konfigurationsfil för att underlätta migrationer
- Testa alltid dina prompts med den nya modellen innan du migrerar till produktion
- Övervaka avvecklingsmeddelanden för att planera dina migrationer i god tid