Grok Build

Grok Build est l'agent de programmation en terminal de xAI ; il appelle par défaut l'interface officielle xAI, mais il permet de déclarer dans ~/.grok/config.toml n'importe quel point de terminaison compatible OpenAI sous la forme [model.*]. Pointez le point de terminaison vers aicentos pour appeler, avec la même clé, les modèles de la famille grok comme ceux des autres fournisseurs.

PrérequisCopier le lien d’ancre

• Installez Grok Build (script officiel) :

  Copier

  curl -fsSL https://x.ai/cli/install.sh | bash

• Créez une clé dédiée dans la console aicentos (nommez-la par exemple grok-build).

Configuration à renseignerCopier le lien d’ancre

Étapes de configurationCopier le lien d’ancre

• Écrivez la clé dans les variables d'environnement du shell (dans ~/.zshrc ou ~/.bashrc, puis source pour l'appliquer) :

  Copier

  export AICENTOS_API_KEY="your_api_key_here"

• Éditez ~/.grok/config.toml en ajoutant un modèle personnalisé :

  Copier

  [models]
  default = "aicentos-grok"
  
  [model.aicentos-grok]
  base_url          = "https://aicentos.com/v1"
  env_key           = "AICENTOS_API_KEY"
  api_backend       = "chat_completions"
  context_window    = 200000
  max_completion_tokens = 8192
  description       = "aicentos gateway - grok-4.7"

  Le <name> de [model.<name>] est l'ID du modèle ; pour intégrer plusieurs modèles, par exemple grok-4.7 et claude-opus-4-8, ajoutez respectivement un bloc [model.grok-4.7] et [model.claude-opus-4-8].

• Lancez Grok Build, puis basculez avec le sélecteur de modèles ou en commande :

  Copier

  grok
  /model aicentos-grok

TestCopier le lien d’ancre

Vérifiez d'abord que les modèles sont reconnus :

grok models

Envoyez ensuite une invite légère (par ex. grok -p "présente le répertoire courant en une phrase" -m aicentos-grok) pour vérifier que la réponse arrive normalement.

RemarquesCopier le lien d’ancre

• Grok Build n'a pas de paramètre de ligne de commande --base-url ; le point de terminaison personnalisé ne peut être précisé que par le fichier de configuration ou les variables d'environnement.
• api_backend vaut chat_completions par défaut ; si vous écrivez explicitement responses ou messages, vérifiez que la passerelle prend en charge le point de terminaison correspondant, sinon l'appel échouera.
• L'ordre de résolution des identifiants est : api_key dans la configuration du modèle → variable d'environnement désignée par env_key → token de la session connectée → XAI_API_KEY global. Ici, utilisez env_key avec votre propre nom de variable, sans risque de mélange avec le compte officiel xAI.
• Si un nouveau modèle omet context_window, Grok Build applique par défaut 200 000 ; il est conseillé de le renseigner explicitement selon le modèle choisi.
• Une fois le point de terminaison personnalisé en place, l'abonnement xAI n'est plus nécessaire, mais le modèle sélectionné reste facturé côté aicentos ; vérifiez d'abord le solde sur la page du portefeuille.