Quota MiniMax M Plan ou Token Plan épuisé : vérifier les fenêtres et continuer à coder

Lorsqu’un outil de programmation connecté à MiniMax s’arrête, ne changez pas de client ou de clé au hasard. Commencez par déterminer si une fenêtre M Plan est épuisée, un rate limit temporaire s’est déclenché, le compte utilise encore un Token Plan conservé ou l’outil emploie le mauvais type de clé. Ce diagnostic permet de choisir entre attendre, utiliser des Credits compatibles ou déplacer uniquement le travail de texte vers une API pay-as-you-go indépendante.

Commencez par ce tableau de décision

Ce que vous observez	Ce qu’il faut vérifier	Première action
La console n’affiche plus de quota dans la fenêtre de 5 heures ou hebdomadaire	Le nom du plan et l’heure de fin de chaque fenêtre	Attendre le reset concerné ou vérifier si les Credits couvrent la capacité
Du quota reste disponible, mais les appels s’arrêtent après une rafale	Fréquence, concurrence et limitation dynamique aux heures de pointe	Réduire la fréquence ou la concurrence, puis réessayer plus tard
Le compte affiche toujours Token Plan	S’il s’agit d’un abonnement conservé et s’il a été mis à niveau	Suivre l’avis du plan conservé sans appliquer automatiquement toutes les règles M Plan
Le solde commence à être débité après un changement de clé	Subscription Key ou API key pay-as-you-go	Cesser de mélanger les clés et configurer le chemin de facturation voulu
Le code texte doit continuer immédiatement	Si une facturation séparée convient et qu’aucun avantage exclusif à M Plan n’est requis	Configurer un fournisseur indépendant avec sa propre clé, son endpoint et son Model ID

Des symptômes proches dans le client peuvent avoir des causes différentes. L’ordre sûr est : plan et fenêtres, puis type de clé, et seulement ensuite changement de fournisseur.

M Plan utilise deux fenêtres indépendantes : 5 heures et 7 jours

Les règles d’utilisation de M Plan décrivent deux fenêtres qui se réinitialisent automatiquement :

• Les modèles texte, image, audio et les autres modèles non vidéo nécessitent du quota dans la fenêtre de 5 heures et dans la fenêtre hebdomadaire de 7 jours.
• Les modèles vidéo dépendent uniquement de la fenêtre hebdomadaire.
• Les deux fenêtres démarrent au premier usage. Lorsqu’une fenêtre se termine, la limite complète du niveau est restaurée et l’usage suivant ouvre une nouvelle fenêtre.
• Elles se réinitialisent séparément : le reset de 5 heures ne restaure pas l’usage hebdomadaire.
• Le quota inutilisé ne s’accumule pas dans la fenêtre suivante et n’est pas reporté au cycle de facturation suivant.

Attendre cinq heures peut donc ne rien changer si la fenêtre hebdomadaire reste épuisée. L’inverse est également possible : du quota est encore visible, mais un rate limit temporaire bloque les appels.

Tous les outils compatibles partagent le même usage M Plan

M Plan n’attribue pas une réserve distincte à chaque client. L’usage dans MiniMax Code et dans les outils compatibles reliés par la même Subscription Key compte dans les mêmes limites.

Passer de Claude Code à OpenCode, ouvrir une nouvelle session ou placer la même Subscription Key dans un autre outil ne crée pas de quota neuf. Consultez la page d’usage MiniMax pour voir le plan, les fenêtres, les Credits et l’historique. Avec MiniMax CLI, vous pouvez aussi exécuter :

mmx quota

Cette commande affiche l’usage M Plan et le quota restant. Elle est plus fiable qu’une interprétation de l’erreur générique affichée par un agent de code.

Un rate limit n’est pas un quota épuisé

MiniMax sépare les limites d’usage des limites de fréquence. Un grand nombre de requêtes en peu de temps, une forte concurrence ou un contrôle dynamique aux heures de pointe peut bloquer temporairement les appels alors que du quota reste disponible.

Réduisez la fréquence et la concurrence, puis réessayez plus tard. N’achetez pas de Credits, ne mettez pas le plan à niveau et ne remplacez pas la clé pour une limitation brève. Suivez le scénario « quota épuisé » seulement lorsque la console montre que la fenêtre de 5 heures ou la fenêtre hebdomadaire est réellement vide.

Vérifiez s’il s’agit de M Plan ou d’un Token Plan conservé

Après l’arrivée de M Plan, Token Plan n’a plus été proposé aux nouveaux achats, mais les abonnés existants ont pu conserver leur plan ou effectuer une mise à niveau. Le libellé du compte est donc décisif :

• Si Plan Details indique M Plan, appliquez les règles des fenêtres indépendantes, de l’usage partagé et des Credits.
• S’il indique encore Token Plan, consultez Existing Token Plan subscribers et vérifiez l’état de l’abonnement conservé et du renouvellement automatique.
• La mise à niveau est irréversible : l’avis officiel précise qu’il n’est pas possible de revenir à Token Plan et que le nouveau niveau M Plan régit ensuite modèles, limites, avantages et renouvellement.

Ne déduisez pas les règles actuelles d’un ancien article ou d’une configuration enregistrée. Vérifiez d’abord le nom et l’état affichés dans Plan Details.

Quand le quota est vraiment épuisé, choisissez selon la dépendance

1. Vous avez besoin de fonctions propres à l’abonnement : attendez le bon reset

Attendre est le choix le plus clair lorsque le travail dépend d’un modèle réservé à M Plan, d’un avantage MiniMax Code ou du même flux avec Subscription Key. Identifiez si la fenêtre de 5 heures, la fenêtre hebdomadaire ou les deux sont épuisées, puis suivez l’heure de fin affichée dans la console.

Pendant l’attente, retirez les fichiers inutiles du contexte, ouvrez une session plus ciblée et découpez un gros travail en étapes vérifiables. Cela n’avance pas le reset, mais peut réduire la consommation dans la fenêtre suivante.

2. Le compte possède des Credits : vérifiez l’éligibilité

Le quota inclus dans M Plan est utilisé en premier. Une fois la limite atteinte, les Credits disponibles peuvent couvrir un dépassement éligible, mais les packs ne s’appliquent qu’aux modèles et capacités qu’ils prennent en charge.

Sur la page d’usage, vérifiez le solde, l’expiration et la compatibilité de la capacité. La présence de Credits ne garantit pas que toute opération puisse continuer.

3. Vous devez continuer le code texte maintenant : utilisez une route séparée

Si la tâche ne dépend pas d’un avantage exclusif à M Plan, un fournisseur API indépendant peut maintenir le travail de texte. Il utilisera sa propre clé et sa propre facturation. Cette route ne réinitialise pas M Plan, ne transfère pas les Credits et ne déplace pas les avantages MiniMax Code.

Chez MiniMax, l’API key pay-as-you-go standard est déjà séparée de la Subscription Key et elles ne sont pas interchangeables. Respectez la même frontière avec un fournisseur externe : chaque configuration doit utiliser sa clé, son Base URL et son Model ID exact.

Exemple : une route OpenCode indépendante avec BetterToken

BetterToken est ici un exemple de fournisseur séparé, pas une recharge de M Plan. Au 10 octobre 2026, son catalogue actuel affiche l’ID exact MiniMax-M3, et son guide OpenCode utilise le Base URL compatible OpenAI https://www.bettertoken.ai/v1.

La documentation des modèles MiniMax précise que MiniMax-M3.1-Flash-Preview est actuellement disponible uniquement via M Plan et MiniMax Code. Ne copiez pas cet ID de préversion dans une configuration externe : utilisez l’ID exact du catalogue du fournisseur choisi.

Configurer sans mélanger les clés

1. Créez une API key dans votre compte BetterToken. Ne collez pas une MiniMax Subscription Key.
2. Dans OpenCode, exécutez /connect, choisissez Other, indiquez bettertoken comme provider id et saisissez la clé BetterToken dans l’invite d’identifiants.
3. Créez opencode.json à la racine du projet ou mettez à jour ~/.config/opencode/opencode.json :

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/MiniMax-M3",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "MiniMax-M3": {
          "name": "MiniMax-M3"
        }
      }
    }
  }
}

4. Redémarrez OpenCode, choisissez bettertoken/MiniMax-M3 et envoyez une courte question de programmation.
5. Une réponse normale confirme que la route API indépendante fonctionne. Elle ne signifie pas que le quota d’abonnement MiniMax a été restauré ou transféré.

Consultez le guide BetterToken pour OpenCode et vérifiez l’ID dans le catalogue de modèles actuel avant d’enregistrer la configuration.

Si la route indépendante échoue, vérifiez chaque couche

• Échec d’authentification : relancez /connect et assurez-vous d’avoir saisi une clé BetterToken, pas une MiniMax Subscription Key.
• Erreur d’endpoint : conservez exactement https://www.bettertoken.ai/v1 comme Base URL, sans ajouter /chat/completions.
• Modèle introuvable : vérifiez la casse et l’ID complet. Utilisez MiniMax-M3 et bettertoken/MiniMax-M3 dans les champs correspondants.
• Configuration inchangée : redémarrez OpenCode et vérifiez si un opencode.json de projet remplace le fichier global.
• L’outil MiniMax d’origine reste bloqué : c’est une limite attendue. Un fournisseur séparé ne modifie ni les fenêtres, ni les Credits, ni l’état de l’abonnement MiniMax.

Cinq erreurs qui font perdre le plus de temps

1. Prendre une limitation temporaire pour un quota épuisé. S’il reste du quota, réduisez la concurrence et réessayez.
2. Attendre uniquement le reset de 5 heures. Les modèles non vidéo ont aussi besoin de quota hebdomadaire.
3. Déplacer la même Subscription Key entre les outils. Ils partagent tous le même usage M Plan.
4. Mélanger Subscription Key et API key pay-as-you-go. Elles utilisent des droits et des modes de facturation différents.
5. Considérer MiniMax-M3.1-Flash-Preview comme un ID externe universel. Chaque fournisseur exige l’ID exact de son catalogue actuel.

L’ordre pratique des opérations

Vérifiez le plan et les fenêtres restantes dans la console ou avec mmx quota. S’il s’agit seulement d’un rate limit, réduisez fréquence et concurrence. Si le quota est épuisé, attendez lorsque les fonctions d’abonnement sont nécessaires, utilisez les Credits uniquement pour une tâche éligible ou configurez un fournisseur pay-as-you-go séparé lorsque la continuité du code texte est prioritaire.

N’essayez pas de résoudre le problème en faisant tourner les clés au hasard. Séparer M Plan ou le Token Plan conservé, la Subscription Key, l’API key pay-as-you-go standard et la clé d’un fournisseur externe évite un mauvais diagnostic et une facturation sur le mauvais compte.