Limites de débit de l’API Grok : niveaux, plafonds RPS et erreurs 429 expliqués

Comment fonctionnent les limites de débit de l’API Grok

SpaceXSI (anciennement xAI) plafonne le trafic API par modèle, à l’aide de deux chiffres :

• RPS (requêtes par seconde) : le nombre d’appels que vous pouvez envoyer chaque seconde. SpaceXSI le déduit d’un chiffre par minute : le RPS est égal au RPM divisé par 48, avec un minimum de 2.
• TPM (tokens par minute) : le nombre de tokens que vous pouvez faire passer chaque minute. Les tokens en cache comptent dans le TPM.

Les limites s’appliquent à chaque modèle séparément. Une charge de travail intense sur grok-4.7 n’entame pas votre quota grok-4.3. Quand vous dépassez une limite, l’API renvoie une erreur HTTP 429 et la requête n’est pas traitée.

Comme les tokens en cache comptent dans le TPM, le cache réduit votre facture mais pas votre budget de tokens par minute. Les longs prompts peuvent atteindre le plafond TPM bien avant le plafond de requêtes.

Niveaux de dépense de $0 à $5,000

Votre niveau dépend du total de vos dépenses sur l’API depuis le 1er janvier 2026.

Quatre règles tirées de la documentation :

• Les niveaux augmentent automatiquement dès que vous franchissez un seuil.
• Les niveaux ne baissent jamais, même si vos dépenses ralentissent.
• Seuls les achats de crédits prépayés et les factures payées comptent.
• Les limites plus élevées pour les modèles d’image et de vidéo Grok Imagine passent par le service commercial de SpaceXSI.

Exemples de limites par modèle

La documentation publie un tableau par modèle. Les chiffres ci-dessous sont ceux que nous avons lus le 18 octobre 2026. Le tableau était mal mis en forme sur la page : considérez-les comme approximatifs et vérifiez votre console pour connaître les limites de votre compte.

Les niveaux 1 à 3 se situent entre ces valeurs. La console affiche les limites exactes qui s’appliquent à votre équipe.

L’API vocale a ses propres plafonds. La documentation de Grok Voice indique 10 sessions simultanées par équipe et une session de 120 minutes maximum. Voir notre guide de l’API Grok Voice.

Que faire face à une erreur 429

Une erreur 429 signifie que vous avez envoyé plus que ce que votre niveau autorise pour ce modèle sur cette période. Ce n’est pas une erreur de facturation. Une 429 est différente d’un épuisement de crédits, qui fait refuser les requêtes jusqu’à ce que vous rechargiez.

Les pratiques habituelles pour toute API à débit limité s’appliquent :

1. Réessayez après une courte attente, et allongez l’attente après chaque échec (backoff exponentiel).
2. Ajoutez un léger délai aléatoire pour que les workers parallèles ne réessaient pas au même moment.
3. Étalez les tâches en rafale dans le temps avec une file d’attente au lieu de tout lancer d’un coup.
4. Journalisez le modèle et la limite atteints. Les problèmes de RPS et de TPM se règlent différemment.

Si vous atteignez le plafond TPM, raccourcir les prompts aide davantage que réduire le nombre de requêtes. Si vous atteignez le plafond RPS, regroupez les petits appels quand c’est possible.

Comment tirer le meilleur parti de vos limites

• Utilisez la Batch API pour ce qui peut attendre. Les appels en batch ne comptent pas dans les limites de débit, et ils sont 20 % moins chers sur grok-4.3 et les modèles grok-4.20.
• Définissez une clé de cache. SpaceXSI recommande vivement prompt_cache_key ou l’en-tête x-grok-conv-id. Cela n’augmente pas votre TPM, mais réduit le prix des entrées répétées.
• Adaptez l’effort de raisonnement à la tâche. Grok 4.7 utilise par défaut un effort élevé. Artificial Analysis a constaté que Grok 4.7 produisait environ 81k tokens de sortie par tâche dans ses tests, plus du double de Grok 4.6 : un raisonnement poussé entame donc vite les budgets de tokens.
• Choisissez le modèle aux bonnes limites. Dans le tableau publié, la famille grok-4.5 à 4.7 démarre avec un RPS plus élevé que grok-4.3.
• Achetez des crédits à l’avance. Comme seuls les achats prépayés et les factures payées comptent pour les niveaux, une recharge plus importante vous fait monter plus tôt.

Enterprise et limites plus élevées

Au-delà du niveau 4, SpaceXSI propose un niveau Enterprise sur demande. La facturation sur facture s’organise aussi via le service commercial ; elle est désactivée par défaut. Les équipes qui ont besoin de plus de débit sur Grok Imagine doivent également contacter le service commercial.

Pour les données professionnelles, SpaceXSI affirme ne pas s’entraîner sur les entrées ou sorties professionnelles et les supprimer sous 30 jours, sauf obligation de les conserver. Les prix de chaque modèle sont sur notre page des tarifs de l’API Grok, et la mise en place dans la vue d’ensemble de l’API Grok.

Questions fréquentes