MiniMax api : Guide de démarrage et SDK

Authentification et URL de base

Utilisez la clé API fournie et pointez votre client vers l'URL de base dédiée. Le point de terminaison pour générer des réponses est https://api.minimaxaiapi.com/v1/chat/completions. Vous transmettez la clé dans le Authorization header en tant que jeton Bearer. Cela fonctionne avec n'importe quel SDK OpenAI standard car nous suivons le même protocole.

• Nom de l'en-tête : Authorization
• Valeur de l'en-tête : Bearer YOUR_API_KEY
• URL de base : https://api.minimaxaiapi.com/v1

Aucune configuration complexe n'est requise. Il suffit de mettre à jour la configuration dans votre projet existant.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Point de terminaison Chat Completions

Envoyez une requête POST au point de terminaison des complétions de chat pour obtenir une réponse textuelle. L'identifiant du modèle est uncensored. Vous devez inclure un tableau de messages avec l'historique de votre conversation. Le système traite l'entrée et retourne du texte généré en fonction de votre invite.

Ce point de terminaison gère toute la génération de texte. Il ne prend pas en charge les embeddings, l'audio ou la vidéo. Vous pouvez diffuser les réponses ou attendre le bloc complet. Le modèle gère un contexte jusqu'à 100,000 tokens au total.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxaiapi.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Streaming et utilisation des jetons

Activez le streaming en définissant stream: true dans votre requête. L'API renvoie des Server-Sent Events (SSE) pour chaque token généré. Cela permet l'affichage en temps réel de la sortie. Les statistiques d'utilisation des tokens sont incluses dans le dernier chunk du flux. Cela vous aide à suivre les coûts avec précision sans analyser chaque token individuel.

Le streaming réduit la latence perçue pour les réponses longues. Il est idéal pour les interfaces de chat et la génération de contenu dynamique. Vous pouvez arrêter le flux plus tôt si l'utilisateur interrompt la génération.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxaiapi.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Appel de fonction et mode JSON

Utilisez le tools paramètre pour activer l'appel de fonction. Définissez vos fonctions dans le corps de la requête et laissez le modèle choisir laquelle appeler. Le tool_choice le paramètre vous permet de forcer une fonction spécifique ou de sélectionner automatiquement. Pour une sortie JSON stricte, définissez response_format à {"type": "json_object"}. Cela garantit que la réponse est du JSON valide.

L'appel de fonctions est utile pour extraire des données structurées ou déclencher des actions. Le mode JSON est parfait pour les intégrations API nécessitant des formats prévisibles. Combinez les deux pour une logique d'application robuste.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Paramètres et contraintes du modèle

Ajustez le comportement de génération à l'aide de paramètres standard tels que temperature, top_p, et stop. La fenêtre de contexte maximale est de 100 000 tokens, incluant le prompt et la complétion. Le nombre maximum de tokens par requête est de 16 000. Si vous ne définissez pas max_tokens, la limite par défaut est de 2 048 tokens.

Utiliser seed pour des résultats reproductibles. Définissez presence_penalty et frequency_penalty pour contrôler la répétition. Ces paramètres vous donnent un contrôle fin sur la créativité et la cohérence du modèle. Testez toujours avec votre cas d'utilisation spécifique pour trouver le bon équilibre.

Limites de débit et erreurs

L'API impose une limite de 300 requêtes par minute et 8 requêtes simultanées par clé. Si vous dépassez ces limites, vous recevrez une erreur 429. Une erreur 401 indique une clé API invalide ou manquante. Une erreur 402 signifie que votre crédit prépayé est épuisé.

Les erreurs ne consomment pas votre crédit. Vous pouvez réessayer les requêtes échouées sans pénalité. La taille du corps de la requête est limitée à 8 Mo. Gérez soigneusement votre concurrence pour éviter le throttling. Surveillez votre utilisation via le dernier fragment des réponses en streaming.