Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Naamgevingsconventies

Les 13 van 14 Bijgewerkt op 3 november 2026 Beginner
Op deze pagina
  1. Model-identificatoren begrijpen
  2. De drie indelingsformaten
  3. Huidige volledige identificatoren
  4. Levenscyclus van het model
  5. Aanbevelingen per omgeving
  6. Migratie tussen versies
  7. API-eindpunten
  8. Belangrijkste punten

Bijgewerkt op 3 november 2026. Gebaseerd op de xAI-pagina Models (sectie Model Aliases): de tabel bevat grok-4.7, het model dat door xAI wordt aanbevolen, en grok-4.6. De productaanbeveling volgt de richtlijnen van xAI, die adviseren om voor de meeste use cases de alias te gebruiken en de gedateerde versie voor workflows die strikte consistentie vereisen. Bron: Models.

Model-identificatoren begrijpen

Wanneer u de xAI API aanroept, bepaalt het veld model welk model uw verzoek verwerkt. xAI hanteert een gestructureerd naamgevingssysteem met aliassen en gefixeerde versies. Inzicht in dit systeem is essentieel voor het beheer van de stabiliteit en migratie van uw applicaties.

De drie indelingsformaten

xAI biedt drie manieren om naar een model te verwijzen, elk met eigen gedrag:

Eenvoudige alias

{
  "model": "grok-4.20"
}

De eenvoudige alias verwijst naar de nieuwste stabiele versie van het model. Wanneer xAI een kleine update uitbrengt, wordt de alias automatisch doorgeschakeld naar de nieuwe versie. Uw applicatie gebruikt altijd de meest recente stabiele versie zonder codeaanpassingen.

Voordeel: u profiteert automatisch van verbeteringen. Risico: het gedrag kan per versie licht wijzigen.

Laatste alias

{
  "model": "grok-4.20-latest"
}

De laatste alias verwijst naar de allernieuwste versie (bleeding edge), inclusief versies die nog niet als stabiel zijn gemarkeerd. Dit is de meest recente, maar potentieel minst geteste versie.

Voordeel: directe toegang tot de nieuwste verbeteringen. Risico: het gedrag kan op elk moment wijzigen; regressies zijn mogelijk.

Gefixeerde versie

{
  "model": "grok-4.20-0309"
}

De gefixeerde versie identificeert een specifieke modelversie, geïndexeerd op de releasedatum (hier 9 maart). Deze versie wijzigt nooit: het gedrag dat u vandaag observeert, is over zes maanden identiek.

Voordeel: totale stabiliteit, reproduceerbare resultaten. Risico: de versie wordt uiteindelijk verouderd verklaard en vervolgens verwijderd.

Huidige volledige identificatoren

API-identificator Type Gedrag
grok-4.20-0309-reasoning Gefixeerde versie Wijzigt nooit
grok-4.20-0309-non-reasoning Gefixeerde versie Wijzigt nooit
grok-4.20-multi-agent-0309 Gefixeerde versie Wijzigt nooit
grok-4.7 Alias Nieuwste stabiele versie van het model aanbevolen door xAI
grok-4.6 Alias Nieuwste stabiele versie
grok-4.5 Alias Nieuwste stabiele versie (alias `grok-4.5-latest` voor de allernieuwste)
grok-4.3 Alias Nieuwste stabiele versie
grok-build-0.1 Alias Codemodel, nieuwste stabiele versie

Levenscyclus van het model

Elk xAI-model doorloopt een levenscyclus van drie fasen:

  1. Actief — het model is beschikbaar en wordt aanbevolen voor productiegebruik
  2. Verouderd (Deprecated) — het model werkt nog, maar xAI raadt migratie naar een nieuwere versie aan. Er wordt een deadline aangekondigd voordat verwijdering plaatsvindt
  3. Obsoleet — het model is verwijderd. Verzoeken naar dit model mislukken

Houd de aankondigingen over veroudering in de gaten op de xAI-console en in de release notes. Wanneer een model als verouderd wordt gemarkeerd, plant u uw migratie zonder te wachten op de verwijderingsdatum.

Aanbevelingen per omgeving

Ontwikkeling

Gebruik eenvoudige aliassen (grok-4.7, grok-4.3) om automatisch van verbeteringen te profiteren. Tijdens de ontwikkeling is een lichte wijziging in gedrag tussen versies acceptabel; hierdoor spot u incompatibiliteiten voordat ze naar productie gaan.

Staging en testen

Gebruik gefixeerde versies (grok-4.20-0309-reasoning) om reproduceerbaarheid van tests te garanderen. Als een test vandaag slaagt, moet deze morgen slagen met exact hetzelfde resultaat.

Productie

xAI raadt voor de meeste use cases de eenvoudige alias of de -latest alias aan, zodat u automatisch profiteert van nieuwe functies. De gedateerde versie is gereserveerd voor workflows die strikte consistentie vereisen. Val uw productie onder deze categorie—auditbare resultaten, compliance, regressietesten—fixeer dan de gedateerde versie en plan periodieke migraties na validatie in staging.

Migratie tussen versies

Wanneer u migreert van de ene naar de andere versie:

  1. Werk het veld model bij in uw verzoeken
  2. Test uw bestaande prompts—nieuwere modellen kunnen anders reageren
  3. Controleer API-parameters—een nieuwe versie kan bepaalde parameters ondersteunen of als verouderd markeren
  4. Valideer resultaten—vergelijk outputs van de oude en nieuwe versie kwalitatief

API-eindpunten

xAI onderhoudt twee hoofdeindpunten:

  • /v1/responses — het hoofdeindpunt, aanbevolen voor alle nieuwe projecten
  • /v1/chat/completions — het verouderde eindpunt, onderhouden voor compatibiliteit met bestaande clients

Het verouderde eindpunt ontvangt geen nieuwe functies meer. Als u een nieuw project start, gebruik dan uitsluitend /v1/responses.

Belangrijkste punten

  • Drie formaten: eenvoudige alias (stabiel), laatste alias (bleeding edge), gefixeerde versie (onveranderlijk)
  • Gebruik in productie gefixeerde versies voor stabiliteit
  • Gebruik in ontwikkeling aliassen om te profiteren van verbeteringen
  • Houd aankondigingen over veroudering in de gaten en plan uw migraties
  • Het aanbevolen eindpunt is /v1/responses, niet /v1/chat/completions
  • Test uw prompts altijd bij het migreren tussen versies