Une clé API MiniMax provient le plus souvent de deux sources : la plateforme ouverte MiniMax, et un point d'entrée compatible comme ZSQH AI Gateway. Les deux permettent d'appeler les modèles, mais l'inscription, le périmètre de la clé et la facturation sont séparés. Cet article suit l'ordre réel des opérations : inscription, création, conservation, isolation des permissions, rotation et diagnostic des 401, avant de conclure sur le choix entre clé officielle et clé de passerelle.

Pour une équipe qui intègre pour la première fois, retenez une phrase : une clé n'est pas meilleure quand elle peut tout faire, mais quand elle est découpée par environnement, par personne et par usage, avec possibilité de désactivation, de traçabilité et de remplacement. Ainsi, même si une clé pose problème, l'ensemble de l'activité n'est pas affecté.

Note : MiniMax est une marque de son titulaire ; cet article est purement technique. Les points d'entrée, modes de gestion des clés et limites suivent la documentation et la console officielles de MiniMax ; les modèles et règles de facturation suivent la page Tarifs du site.

1. Distinguer d'abord les trois types de clés

MiniMax propose actuellement deux grandes catégories de clés : la clé d'interface facturée à l'usage, et la clé d'abonnement liée à M Plan. La première se crée dans la page « clés d'interface » du compte et couvre les modèles de langage, vidéo, voix et image ; la seconde se consulte dans la page abonnement et facturation, pour l'abonnement M Plan et les crédits achetés. La troisième catégorie est la clé ZSQH AI Gateway, valable uniquement dans la passerelle, pour appeler de façon unifiée plusieurs modèles activés.

Ne mélangez pas ces trois types. L'incident le plus courant consiste à mettre une clé officielle sur l'adresse de la passerelle, ou une clé de passerelle sur l'interface officielle, puis à vérifier le code encore et encore avant de découvrir que l'adresse et la clé ne correspondent pas.

Type de clé Où la créer ou la consulter Périmètre Scénario adapté
Clé officielle à l'usage « Clés d'interface » de la plateforme ouverte Modèles et interfaces activés sur le compte officiel MiniMax seul, règlement direct avec l'officiel
Clé d'abonnement M Plan Page abonnement et facturation Abonnement M Plan et crédits achetés Abonnement souscrit, usage par forfait
Clé de passerelle Console ZSQH Modèles activés dans la passerelle Point d'entrée multi-modèles, facturation unifiée

2. Inscription : confirmer d'abord le site Chine ou international

MiniMax dispose de deux points d'entrée, platform.minimax.cn et platform.minimax.io. Les entrées, consoles et URL de base diffèrent : avant de vous inscrire, confirmez à quel site l'équipe a accès et quel mode de règlement convient. Ne vous inscrivez pas sur le site Chine pour ensuite configurer la clé sur l'adresse internationale.

Pour un usage d'équipe, privilégiez le modèle « compte principal + sous-comptes ». La documentation du site Chine indique que le compte principal peut créer des sous-comptes ; ceux-ci partagent les droits, la limitation et la facturation API du compte principal, mais ne peuvent pas consulter ni gérer les paiements. Chaque personne dispose ainsi de son identité de connexion, et la désactivation du sous-compte suffit au départ d'un collaborateur, sans transmettre le mot de passe principal.

Si la console demande des informations d'entreprise ou un mode de vérification supplémentaire, suivez les indications de la page et le processus affiché au moment de l'inscription.

3. Étapes de création d'une clé

  1. Connectez-vous à la plateforme ouverte MiniMax et ouvrez la page « Clés d'interface » du centre utilisateur. Sur le site Chine, le chemin est platform.minimax.cn/user-center/basic-information/interface-key.
  2. Cliquez sur créer une clé et donnez un nom explicite, par exemple prod-service-client ou test-zhang.
  3. Suivez la page pour choisir ou confirmer le périmètre disponible. Si la page ne propose pas d'option de permission par modèle, cela signifie que les permissions du compte prévalent.
  4. Copiez la clé immédiatement après création et conservez-la dans un gestionnaire de mots de passe ou un service de gestion de secrets. Ne l'envoyez pas en capture dans un groupe, ne l'écrivez pas en commentaire de code.
  5. Si vous utilisez M Plan, la clé d'abonnement ne se trouve pas dans la page des clés d'interface, mais dans la page abonnement et facturation.
  6. Validez la clé avec une requête minimale, en confirmant que la région, l'URL de base et le nom du modèle correspondent.
  7. Notez dans le registre de l'équipe le responsable, l'usage, la date de création et les conditions de désactivation de la clé.

Le point 3 mérite une précision : d'après la documentation publique, il n'existe pas de description générale d'une permission de clé par modèle ; la console fait foi. Si vous devez isoler plusieurs activités, privilégiez des sous-comptes ou des clés distinctes par environnement, plutôt que de faire porter tous les usages par une seule clé.

4. Isolation des permissions : une clé par environnement

Découpez au moins en trois : développement, préproduction et production. La clé de production reste uniquement dans les variables d'environnement du serveur ou un service de gestion de secrets, et n'est jamais transmise au navigateur, au mobile ou au client de bureau. Une clé de test peut avoir un plafond plus bas, pour être désactivée à tout moment.

Si l'équipe gère plusieurs lignes d'activité, découpez aussi par activité : une clé pour le service client, une pour la génération de contenu, une pour le traitement par lots. Une anomalie sur une activité peut alors être traitée par une désactivation isolée, sans impacter les autres ; l'analyse d'usage devient aussi plus simple.

L'objectif de l'isolation n'est pas d'ajouter de la bureaucratie, mais de donner des frontières aux incidents ; une clé unique pour tout simplifie le court terme et complique le diagnostic sur la durée.

5. Placer la clé dans une variable d'environnement

N'écrivez jamais la clé dans le code. L'exemple minimal ci-dessous utilise .env uniquement en local ; en production, utilisez le gestionnaire de secrets de la plateforme ou un Secret de conteneur.

# .env (ne pas versionner dans Git)
MINIMAX_API_KEY=votre_cle
# exemple site Chine officiel ; via la passerelle, remplacez par l'adresse de la passerelle et un nom de modèle du site
MINIMAX_BASE_URL=https://api.minimax.cn/v1
MINIMAX_MODEL=MiniMax-M3.1-Flash

# .gitignore
.env
.env.*

En Python, lisez la clé avec os.environ["MINIMAX_API_KEY"], sans la mettre comme valeur par défaut d'un paramètre de fonction. Trois précautions : premièrement, .env doit figurer dans .gitignore ; deuxièmement, ne l'intégrez pas dans les couches d'image de conteneur ni dans le CI ; troisièmement, anonymisez les en-têtes avant de journaliser, pour éviter d'écrire Authorization dans les logs.

Si vous utilisez un service de gestion de secrets, accordez à l'application un accès en lecture seule et journalisez chaque lecture. Ne copiez pas la clé dans un outil de messagerie ou le corps d'un document.

6. Rotation et traitement d'une fuite

La documentation officielle ne fixe pas de cycle de rotation : définissez-le selon le risque. Une clé de production critique peut être renouvelée tous les 90 jours, et immédiatement en cas de changement de personnel, de perte d'appareil ou de suspicion de fuite.

La rotation suit l'ordre « créer la nouvelle, basculer, puis désactiver l'ancienne » :

  • Créer une nouvelle clé, avec la date dans le nom, par exemple prod-2026-10.
  • Enregistrer la nouvelle clé dans le gestionnaire de secrets et la valider en préproduction.
  • Basculer progressivement le trafic de production, en surveillant taux d'erreur et usage.
  • Après stabilisation, désactiver l'ancienne clé en conservant la trace des opérations.
  • Vérifier si l'ancienne clé a connu des appels anormaux avant sa désactivation.

En cas de fuite suspectée, ne vous contentez pas de modifier la chaîne dans le code. Désactivez ou supprimez immédiatement la clé dans la console, créez-en une nouvelle, vérifiez facture et journaux d'appels, et contactez le support si nécessaire. La documentation officielle mentionne que les clés exposées publiquement peuvent être désactivées automatiquement par la plateforme, mais cette désactivation automatique ne doit pas servir de filet de sécurité.

7. Diagnostic 401 : d'abord l'adresse, ensuite la clé

Un 401 signifie un échec d'authentification ; cela ne veut pas dire solde insuffisant ou limitation de débit. Procédez dans cet ordre :

  • L'en-tête est-il Authorization: Bearer <clé>, avec un espace entre Bearer et la clé ?
  • La clé est-elle copiée en entier, sans espace, retour à la ligne ou guillemet autour ?
  • Une clé du site Chine est-elle associée à l'adresse du site Chine, et une clé internationale à l'adresse internationale ?
  • Une clé officielle a-t-elle été saisie par erreur sur l'adresse de la passerelle, ou une clé de passerelle sur l'adresse officielle ?
  • La clé a-t-elle été supprimée, désactivée, ou appartient-elle à un abonnement expiré ?
  • La variable d'environnement est-elle réellement chargée ? Dans un conteneur, affichez le nom de la variable, jamais sa valeur.

Un 403 signale généralement un problème de permission ou de quota ; un 429 une limitation de débit ; seule une information du type insufficient balance indique un solde insuffisant. Traitez 401 séparément de ces erreurs.

8. Choisir entre clé officielle et clé de passerelle

Si vous n'utilisez que MiniMax, que l'inscription et le règlement officiels sont réalisables directement et que l'équipe peut gérer les clés de chaque fournisseur, l'accès direct est plus simple. Si vous devez intégrer simultanément MiniMax, Claude, GPT, DeepSeek et d'autres modèles, ou si vous voulez une clé, une facturation et une vue d'usage unifiées, une passerelle simplifie la gestion.

Le coût d'une passerelle est une couche de dépendance supplémentaire : vérifiez donc trois points — quels modèles MiniMax sont pris en charge, si la règle de facturation est claire, et quel canal de support existe en cas d'anomalie. Testez avec un petit montant avant d'envoyer le trafic de production. Consultez Tarifs pour les modèles et la facturation, puis créez une clé de test depuis l'inscription.

Questions fréquentes

Où créer une clé API MiniMax ?

La clé officielle à l'usage se crée dans la page « Clés d'interface » du centre utilisateur de la plateforme ouverte ; la clé d'abonnement M Plan se consulte dans la page abonnement et facturation. Le chemin précis dépend de la console du site utilisé.

Une clé peut-elle appeler du texte, de la voix et de la vidéo ?

La clé d'interface officielle à l'usage couvre les modèles de langage, vidéo, voix et image, mais la disponibilité dépend des droits du compte, de l'activation des modèles et du type d'interface. Les interfaces voix et vidéo sont souvent asynchrones et ne se substituent pas directement à l'interface de chat.

Peut-on placer la clé dans le front-end ou un mini-programme ?

Non. Le code front-end, les requêtes du navigateur et les paquets de mini-programme peuvent être décompilés ou interceptés. La clé doit rester côté serveur, qui relaie la requête ; si un accès direct est indispensable, utilisez un jeton de courte durée ou des permissions restreintes, en acceptant le risque de fuite.

La rotation impose-t-elle une interruption de service ?

Non. Créez la nouvelle clé, validez-la en préproduction, basculez progressivement la production, puis désactivez l'ancienne. L'essentiel est de faire coexister ancienne et nouvelle clés un certain temps, pour éviter un échec massif au moment de la bascule.

Peut-on mélanger clé officielle et clé de passerelle ?

Non. Chaque clé n'est valable que sur sa plateforme et son adresse. Un mélange se traduit généralement par un 401 ou un 404 ; vérifiez d'abord que l'URL de base et la clé viennent de la même plateforme.

Étape suivante

Déterminez d'abord si vous n'avez besoin que de MiniMax ou d'un point d'entrée multi-modèles. Pour un seul modèle, créez la clé selon la documentation officielle ; pour un point d'entrée unifié, créez un compte ZSQH AI Gateway, générez une clé de test, puis vérifiez modèles et facturation sur la page Tarifs. Dans tous les cas, placez la clé dans une variable d'environnement et séparez test et production.

Pour aller plus loin