Configuration de l'API MiniMax : clé, URL de base et première requête première requête
Voici une configuration étape par étape pour l'API compatible OpenAI sur minimaxapikey.com : compte, clé, URL de base, première requête. Il s'agit d'un service indépendant, et non l'API officielle d'un quelconque fournisseur de modèle.
Mis à jour

Points clés
- Inscrivez-vous avec Google ou par e-mail, puis réclamez 0,50 $ de crédit d'essai sur la page de la clé. Aucune carte bancaire n'est requise.
- L'URL de base est https://api.minimaxapikey.com/v1, l'ID du modèle est uncensored, l'authentification utilise une clé Bearer.
- Deux méthodes existent : POST /v1/chat/completions et GET /v1/models.
- Un 401 signifie une clé invalide, et un 429 signifie qu'une limite a été atteinte, donc vérifiez le code d'erreur dans le corps de la réponse.
Ce que vous configurez
Les gens recherchent la configuration de l'API MiniMax en s'attendant à l'une des deux choses suivantes : la plateforme développeur officielle de MiniMax, ou un endpoint de style OpenAI prêt à l'emploi. Cette page couvre le second cas. Le service derrière minimaxapikey.com est une API textuelle compatible OpenAI hébergée, fonctionnant avec un seul modèle à poids ouverts, exploité par un fournisseur indépendant. Ce n'est pas l'API officielle de MiniMax ou d'un autre fournisseur de modèle, et elle ne route pas les requêtes entre fournisseurs. Si vous avez besoin de la plateforme du fournisseur lui-même, utilisez son site.
Ce que vous obtenez est simple. Tout SDK ou client OpenAI fonctionne une fois que vous avez modifié l'URL de base et première requête la clé. Il y a deux méthodes, POST /v1/chat/completions et GET /v1/models, un seul ID de modèle, uncensored, et une fenêtre de contexte de 100 000 tokens partagée par le prompt et la complétion. Il gère uniquement du texte, donc pas de génération d'images, d'audio ou de vidéo, pas d'embeddings ni de fine-tuning. Le streaming, l'appel de fonctions et le mode JSON sont pris en charge.
La configuration complète prend quelques minutes. Les étapes ci-dessous sont dans l'ordre, et chacune se termine par une vérification pour vous assurer que cela a fonctionné avant de passer à la suite.
Étapes 1 et 2 : créer un compte et obtenir le crédit d'essai
- Ouvrez la page de la clé. Rendez-vous sur la page de la clé API et connectez-vous. Vous pouvez utiliser Google, ou une adresse e-mail et un mot de passe.
- Réclamez le crédit d'essai. Après la connexion, la page de la clé propose un bouton pour 0,50 $ de crédit d'essai. Cela prend un clic, ne nécessite pas de carte, est valable 7 jours et est limité à un par personne.
Le crédit d'essai est petit intentionnellement. À 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie, 0,50 $ couvre un bon nombre de requêtes de test. Un prompt de 1 000 tokens avec une réponse de 500 tokens coûte 0,00015 $ pour l'entrée plus 0,00025 $ pour la sortie, soit 0,0004 $. Diviser 0,50 $ par ce montant donne 1 250 requêtes de ce type, donc vous avez largement de quoi expérimenter.
Notez les limites de la clé d'essai : 2 requêtes simultanées et 60 requêtes par minute. Une clé complète, que vous obtenez après avoir rechargé du crédit, permet 8 requêtes simultanées et 300 par minute. Si votre boucle de test s'exécute en parallèle et que vous voyez des erreurs 429, c'est la première chose à vérifier.
Étape 3 : créer la clé et la stocker en toute sécurité
Sur la même page, créez une clé API et copiez-la. Traitez-la comme un mot de passe. Placez-la dans une variable d'environnement ou un gestionnaire de secrets, jamais dans un dépôt, un bundle front-end ou une capture d'écran. Si une clé fuit, supprimez-la et créez-en une nouvelle.
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
Le code côté serveur doit lire la variable au moment de l'exécution. Le code navigateur ne doit jamais conserver la clé : envoyez des requêtes depuis votre backend, car tout ce qui est livré au navigateur est visible par tous les visiteurs.
Étape 4 : lister les modèles pour confirmer la clé
Le test le moins cher possible est l'endpoint models. Il ne génère pas de texte, c'est donc une vérification propre de la clé, de l'URL et de votre réseau.
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
Vous devriez obtenir une liste JSON incluant uncensored. Si vous obtenez un 401, la clé est incorrecte ou contient un espace ou un guillemet parasite. Si la connexion échoue, vérifiez que l'URL se termine par /v1 et que vous avez utilisé https.
Étape 5 : envoyer la première requête de chat
Maintenant une vraie complétion. Le corps est au format standard des complétions de chat.
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
La réponse contient choices[0].message.content et un bloc usage avec les comptes de tokens de prompt et de complétion. Regardez aussi les en-têtes de réponse, avec curl -i. Vous verrez X-Request-Id, que le support peut utiliser pour trouver votre requête, X-Balance-USD, votre crédit restant, et les en-têtes de limite de débit X-RateLimit-Limit-Requests et X-RateLimit-Limit-Concurrency.
Les paramètres tels que temperature, top_p, stop, seed et les pénalités sont transmis. max_tokens est optionnel. Si vous l'omettez, la complétion peut utiliser tout ce qui reste de la fenêtre.
Étape 6 : le même appel depuis un SDK
Une fois que curl fonctionne, passez au langage que vous utiliserez réellement. Seuls deux arguments changent par rapport à une configuration OpenAI standard.
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
Pour le streaming, ajoutez stream: true et lisez les événements envoyés par le serveur. Les chiffres d'utilisation arrivent à la fin du flux. La page de documentation couvre le streaming, l'appel de fonctions et le mode JSON avec response_format: {"type":"json_object"}.
Migration d'un projet OpenAI existant
La plupart du temps, le projet que vous souhaitez connecter fonctionne déjà avec la bibliothèque cliente d'OpenAI. Dans ce cas, vous modifiez rarement le code. Les SDK officiels lisent les variables d'environnement OPENAI_API_KEY et OPENAI_BASE_URL lorsque vous ne passez pas d'arguments, donc un changement de déploiement peut suffire.
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
La seule modification restante est le nom du modèle. Une chaîne telle qu'un ID de modèle OpenAI n'existera pas ici, donc remplacez-la par uncensored, idéalement via une valeur de configuration afin que vous puissiez revenir en arrière. Parcourez ensuite le code à la recherche des fonctionnalités que le service n'offre pas. La génération d'images, l'audio, les embeddings et le fine-tuning ne sont pas disponibles, car il s'agit d'une API de chat textuel uniquement. Si votre application appelle des embeddings pour la recherche, vous aurez besoin d'un autre fournisseur pour cette partie et pouvez garder le chat sur celui-ci.
Il est également utile de savoir quel est le modèle. Il s'agit d'un seul modèle à poids ouverts, optimisé pour répondre sans refus de contenu pour un usage adulte légal, et une limite stricte s'applique indépendamment des paramètres : pas de contenu sexuel impliquant des mineurs. Les prompts écrits pour un autre modèle peuvent nécessiter de petits ajustements, car chaque modèle réagit différemment au même prompt système. Exécutez vos propres prompts de test côte à côte avant de basculer le trafic réel.
Paramètres à choisir dès le premier jour
Certaines décisions sont plus faciles à prendre au moment de la configuration qu'après le lancement. Aucune n'est difficile, mais chacune évite une surprise plus tard.
- Un prompt système. Mettez vos instructions sur le ton, le format et le rôle dans un message
system. Gardez-le court et spécifique, car chaque requête le répète comme tokens d'entrée. - Un plafond de tokens.
max_tokensest optionnel, mais un plafond est une sauvegarde peu coûteuse. Sans cela, une seule réponse peut utiliser le reste de la fenêtre de 100 000 tokens. - Le streaming pour une utilisation interactive. Définissez
stream: truesi une personne attend la réponse. Pour les travaux par lots, les requêtes simples sont plus simples. - Une règle de retry pour le 429. Traitez le 429 comme un signal d'attente, pas comme un échec. Lorsque la réponse inclut
Retry-After: 5, dormir cette durée et réessayer est la bonne démarche. - La taille de la requête. La limite du corps est de 8 Mo. C'est bien plus qu'un prompt normal n'en a besoin, mais des logs ou des documents collés peuvent l'atteindre.
Les prompts ne sont pas utilisés pour l'entraînement, ce qui est important si vous prévoyez d'envoyer des documents internes ou des messages utilisateurs. Vous êtes toujours responsable de ce que vous envoyez, donc évitez de mettre des secrets que le modèle n'a pas besoin de voir dans un prompt.
Recharger après le crédit d'essai
Le crédit d'essai sert à vérifier que tout fonctionne. Lorsque vous êtes prêt à construire, ajoutez du crédit prépayé. Il n'y a pas d'abonnement : vous payez pour les tokens utilisés, à 0,15 $ par 1M de tokens d'entrée et 0,50 $ par 1M de tokens de sortie, et le crédit n'expire jamais, donc un solde inutilisé ne disparaît pas à la fin du mois.
Tout montant entier de 20 $ à 500 $ fonctionne. Un rechargement de 50 $ ajoute un bonus de 5 %, 100 $ ajoute 10 %, et 200 $ ajoute 15 %. À titre d'exemple rapide, un rechargement de 100 $ avec son bonus de 10 % donne 110 $ de crédit. Avec le prompt de 1 000 tokens et la réponse de 500 tokens de l'étape deux, chaque requête coûte 0,0004 $, donc 110 $ couvrent 275 000 requêtes. Les prompts réels sont généralement plus longs, donc ajustez ce chiffre à votre moyenne propre.
Correction des erreurs de configuration courantes
| Symptôme | Cause probable | Correction |
|---|---|---|
| 401 sur chaque appel | Clé manquante, mal tapée ou révoquée | Envoyez Authorization: Bearer <key>, sans guillemets supplémentaires |
| 404 ou réponse HTML | Mauvais chemin, généralement un /v1 manquant | Utilisez l'URL de base complète se terminant par /v1 |
| Modèle non trouvé | Un nom de modèle copié d'un autre fournisseur | Utilisez uncensored |
429 avec rate_limited | Dépassement de la limite de requêtes par minute | Ralentissez, ou rechargez pour passer des limites d'essai aux limites complètes |
429 avec concurrency | Trop de requêtes à la fois | Limitez les appels parallèles à 8 (2 sur une clé d'essai) |
429 avec Retry-After: 5 | Surcharge temporaire | Attendez 5 secondes et réessayez |
| 413 ou corps rejeté | Requête dépassant 8 Mo | Réduisez le prompt ou divisez la tâche |
Lorsque vous êtes prêt à passer au-delà de l'essai, la page de tarification liste les options de rechargement : tout montant entier de 20 $ à 500 $, payé par crypto (USDT sur TRC20, USDC sur Base), avec un bonus de 5 % à partir de 50 $, 10 % à partir de 100 $ et 15 % à partir de 200 $. Les requêtes échouées ou refusées ne sont pas facturées, et les prompts ne sont pas utilisés pour l'entraînement.
Plus de guides
Questions et réponses
S'agit-il de l'API officielle MiniMax ?
Non. Il s'agit d'une API indépendante, hébergée et compatible OpenAI, qui propose un seul modèle à poids ouverts, optimisé pour répondre sans refus de contenu pour un usage adulte légal. Ce n'est pas l'API officielle d'un quelconque fournisseur de modèle et ce n'est pas un routeur entre fournisseurs.
Ai-je besoin d'une carte bancaire pour l'essayer ?
Non. Après l'inscription, vous pouvez réclamer 0,50 $ de crédit d'essai gratuit en un clic sur la page de la clé API. Il est valable 7 jours et limité à un par personne.
Quel est le nom du modèle à utiliser dans les requêtes ?
Utilisez uncensored. Le service expose cet unique ID de modèle, et GET /v1/models l'affichera.
Comment puis-je ajouter plus de crédit plus tard ?
Rechargez tout montant entier de 20 $ à 500 $. Les bonus s'appliquent à partir de 50 $ (+5 %), 100 $ (+10 %) et 200 $ (+15 %), et le crédit n'expire jamais.
Puis-je utiliser le SDK OpenAI ?
Oui. Définissez base_url sur https://api.minimaxapikey.com/v1, utilisez votre clé et appelez le modèle uncensored. Rien d'autre dans votre code ne doit changer.
Votre clé n'est qu'à un formulaire de distance
Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.