Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Levenscyclus van het model

Les 12 van 14 Bijgewerkt op 29 juli 2026 Gevorderd
Op deze pagina
  1. Veranderingen in het model anticiperen
  2. De drie staten van een model
  3. Endpoints en hun status
  4. De modelreferentie isoleren
  5. Migratieproces
  6. Belangrijkste punten

Veranderingen in het model anticiperen

Uw productieapplicatie is afhankelijk van een specifieke model-ID die in de configuratie is opgeslagen. Die ID is niet permanent: er komen nieuwe versies uit, oude worden verouderd verklaard en vervolgens verwijderd. Teams die deze tijdlijn negeren, ontdekken het probleem pas op de dag dat hun verzoeken massaal beginnen te falen—terwijl er niets aan hun deployments is veranderd. Inzicht in de levenscyclus maakt van deze uitval een geplande migratie.

1

Actief

Het model is beschikbaar en aanbevolen voor productiegebruik. Het ontvangt optimalisaties en fixes.

2

Verouderd (Deprecated)

Het model werkt nog, maar zal worden verwijderd. Plan uw migratie naar de opvolger zodra dit wordt aangekondigd.

3

Obsoleet (Verwijderd)

Het model is verwijderd uit de API. Elk verzoek dat deze ID gebruikt, zal mislukken met een foutmelding.

De drie staten van een model

Een actief model is volledig operationeel en dit is de enige staat die u in productie moet gebruiken. xAI kan kleine optimalisaties toepassen zonder de ID te wijzigen: het model dat u vandaag onder deze naam aanroept, is niet noodzakelijkerwijs byte-voor-byte identiek aan dat van drie maanden geleden—een nuance die de volgende les praktisch zal behandelen.

De overstap naar de status verouderd breekt niets. Het model blijft normaal reageren, maar xAI kondigt de toekomstige verwijdering aan. Dit is het signaal waarop u hebt gewacht: vanaf deze aankondiging heeft u een venster—meestal enkele weken—om de overstap naar de opvolger voor te bereiden, te testen en uit te rollen. Een team dat aankondigingen van veroudering monitort, migreert in zijn eigen tempo; een team dat dit niet doet, migreert in paniek.

De staat obsoleet is het eindstation: het model is ingetrokken en elk verzoek met de bijbehorende ID mislukt. Er is geen automatische fallback naar een nabije versie, geen genadeperiode. Als uw applicatie op die dag nog steeds naar dit model verwijst, stopt deze met werken.

Endpoints en hun status

Endpoints volgen een vergelijkbare logica, met hun eigen status.

EndpointStatus
/v1/responsesprimair endpoint, aanbevolen voor alle nieuwe projecten
/v1/chat/completionsverouderd (legacy), onderhouden voor compatibiliteit
/v1/images/generationsactief, beeldgeneratie
/v1/tokenize-textactief, token-telling

Het geval van /v1/chat/completions verdient uitleg, omdat de lange levensduur verwarring zaakt. De compatibiliteit met het OpenAI-formaat maakte dit het natuurlijke instappunt voor alle teams die van een andere provider kwamen: u wijzigt de basis-URL en de sleutel, en bestaande code werkt. Dit voordeel heeft een keerzijde: het endpoint ontvangt geen nieuwe functies meer, omdat de ontwikkeling zich nu richt op /v1/responses. U kunt het blijven gebruiken, maar elke nieuwe mogelijkheid gaat aan u voorbij.

De modelreferentie isoleren

De hele moeilijkheid van een migratie speelt zich af voordat deze plaatsvindt, in de manier waarop uw code het model benoemt. Als het hardcoded in vijftien bestanden staat, wordt het wijzigen van de ID een speurtocht met onvermijdelijke omissies. Als het op één plek is gedeclareerd, duurt de migratie een minuut:

# config.py
GROK_MODEL = "grok-4.20-0309"  # Vaste versie voor productie
GROK_MODEL_FAST = "grok-build-0.1"

# Vergemakkelijkt migratie: slechts één plek om aan te passen

Probeer deze oefening op uw eigen codebase: zoek naar alle letterlijke voorkomens van een modelnaam. Als het aantal hoger is dan één, heeft u technische schuld die u moet aflossen vóór de volgende veroudering, niet erna.

Migratieproces

Zodra deze centralisatie is ingericht, verloopt de overstap in vier stappen:

  1. Werk het veld model bij in uw configuratie
  2. Test uw bestaande prompts met het nieuwe model in een staging-omgeving
  3. Pas indien nodig aan: nieuwere modellen kunnen anders reageren, met variaties in toon, lengte of formaat
  4. Rol geleidelijk uit: begin met een percentage van het verkeer voordat u volledig overschakelt

Stap 3 wordt het meest onderschat. Een nieuwer model is over het algemeen beter, maar “beter” betekent niet “identiek”: een gedetailleerder antwoord verstoort een gekalibreerde weergave, een iets ander formaat laat JSON-parsing mislukken, een voorzichtiger toon verandert de gebruikerservaring. Dit is precies wat de geleidelijke uitrol in stap 4 u in staat stelt te detecteren op echt verkeer, voordat al uw gebruikers er last van hebben.

Belangrijkste punten

  • Modellen doorlopen drie staten: Actief, Verouderd en vervolgens Obsoleet (verwijderd)
  • Het endpoint /v1/responses is primair; /v1/chat/completions is verouderd en ontvangt geen nieuwe functies meer
  • Centraliseer de modelnaam in een configuratiebestand om migraties te vergemakkelijken
  • Test uw prompts altijd met het nieuwe model voordat u migreert naar productie
  • Monitor aankondigingen van veroudering om uw migraties tijdig te plannen