Générer une clé API

L’accès programmatique à Grok

La clé API est le jeton d’authentification qui permet à vos applications de communiquer avec les modèles Grok. Sans elle, aucune requête n’aboutira. Cette leçon vous guide dans la création et la gestion de vos clés depuis la console xAI.

Accéder à la console

Rendez-vous sur console.x.ai et connectez-vous avec le compte créé à l’étape précédente. La console est votre tableau de bord central pour gérer les clés, surveiller la consommation et configurer la facturation.

Dans le menu latéral, accédez à API Keys (chemin complet : console.x.ai/team/default/api-keys).

Créer votre première clé

Cliquez sur Create API Key. Vous pouvez donner un nom descriptif à chaque clé pour identifier son usage :

• dev-local pour votre environnement de développement
• prod-backend pour votre serveur de production
• test-ci pour votre pipeline d’intégration continue

La clé est affichée une seule fois lors de sa création. Copiez-la immédiatement et stockez-la dans un endroit sécurisé (gestionnaire de mots de passe, coffre-fort de secrets). Si vous perdez une clé, vous devrez en générer une nouvelle.

Format des clés

Les clés API xAI commencent par le préfixe xai- suivi d’une chaîne alphanumérique. Ce préfixe vous aide à les identifier rapidement dans vos fichiers de configuration et à les détecter si elles sont accidentellement exposées dans du code source.

Bonnes pratiques de gestion

Une clé par environnement

Créez des clés distinctes pour chaque contexte d’utilisation. En cas de fuite d’une clé, vous pourrez la révoquer sans impacter les autres environnements.

Rotation régulière

Renouvelez vos clés périodiquement, surtout pour les environnements de production. La procédure est simple : créez une nouvelle clé, mettez à jour votre application, puis supprimez l’ancienne.

Vérification des droits

Avant de partager un projet, assurez-vous qu’aucune clé n’est codée en dur dans le code source. Utilisez des fichiers .env exclus du versionnage (ajoutez .env à votre .gitignore).

Facturation liée aux clés

Chaque appel API effectué avec une clé est comptabilisé et facturé. xAI propose deux modes :

• Crédits prépayés : vous achetez des crédits à l’avance. Les appels sont débités immédiatement
• Facturation mensuelle : la consommation au-delà des crédits est facturée en fin de mois

Vérifiez vos informations de facturation dans la console avant de commencer à utiliser l’API, car les factures ne peuvent pas être modifiées rétroactivement.

Points clés à retenir

• Les clés se créent sur console.x.ai/team/default/api-keys
• Elles commencent par xai- et ne sont affichées qu’une seule fois
• Créez une clé par environnement et stockez-les dans un coffre-fort de secrets
• Vérifiez votre mode de facturation avant tout appel API