Famille MiniMax

Les modèles de texte de MiniMax, qui comprennent MiniMax M3, M2.7 et M2.7 HighSpeed. Ils s’appellent via l’API compatible OpenAI et prennent aussi en charge l’API native Anthropic, ce qui permet de les utiliser dans Claude Code. Les modèles vidéo de MiniMax sont présentés dans Hailuo (MiniMax).

Tâches courantes

Modèles

La liste complète des modèles et les prix en vigueur figurent sur la page des modèles . Le préfixe des ID de modèle est minimax/, et il est facultatif ; le nom officiel MiniMax-M3 renvoie 404.

Ces modèles sont servis par MiniMax officiel (minimax) et prennent en charge Chat Completions, Responses et l’API native Anthropic.

Exemples d’appel

import os
import re
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}],
)
content = resp.choices[0].message.content
answer = re.sub(r"<think>.*?</think>\s*", "", content, flags=re.S)
print(answer)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/minimax-m3",
    "messages": [{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}]
  }'

Contenu du thinking

Les modèles MiniMax activent le thinking par défaut. Avec l’API compatible OpenAI, message.content commence par le contenu du thinking entouré de <think>…</think>, suivi de la réponse ; en streaming, il est également renvoyé dans delta.content. L’exemple ci-dessus retire ce passage avec une expression régulière.

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="minimax/minimax-m3",
    messages=[{"role": "user", "content": "Un nombre plus trois fois ce nombre, moins 12, donne 36. Quel est ce nombre ? Réponds uniquement par le nombre."}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

• Pour MiniMax M3, thinking.type n’accepte que adaptive et disabled ; passer enabled renvoie 400.
• Les tokens de thinking sont comptés dans max_tokens. Si la limite est trop basse, la réponse peut s’arrêter au milieu du thinking, avec finish_reason égal à length.
• Les tokens de thinking sont facturés au prix unitaire de sortie ; leur nombre figure dans usage.completion_tokens_details.reasoning_tokens.

Utiliser avec Claude Code

Les modèles MiniMax prennent en charge l’API native Anthropic, à l’adresse https://api.ofox.io/anthropic. Via cette API, le contenu du thinking est renvoyé dans des blocs thinking séparés et la réponse dans des blocs text : inutile de retirer vous-même la balise think.

import os
import anthropic
 
client = anthropic.Anthropic(base_url="https://api.ofox.io/anthropic", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.messages.create(
    model="minimax/minimax-m2.7",
    max_tokens=4096,
    messages=[{"role": "user", "content": "Un nombre plus trois fois ce nombre, moins 12, donne 36. Quel est ce nombre ?"}],
)
for block in resp.content:
    print(block.type, ":", getattr(block, "thinking", None) or block.text)

• MiniMax M2.7 et M2.7 HighSpeed renvoient toujours des blocs thinking.
• MiniMax M3 renvoie des blocs thinking avec "thinking": {"type": "adaptive"} ou {"type": "enabled", "budget_tokens": 2000}, et uniquement des blocs text avec {"type": "disabled"}.

Les étapes complètes de configuration de Claude Code sont décrites dans Configuration de Claude Code.

Images en entrée

Seul MiniMax M3 accepte les images en entrée, avec le bloc de contenu standard image_url ; voir Compréhension visuelle. MiniMax M2.7 et M2.7 HighSpeed ne prennent en charge que le texte : utilisez M3 pour analyser des images.

Autres fonctionnalités

• Appel d’outils : utilise le paramètre standard tools et renvoie tool_calls.
• Cache : les préfixes de requête répétés sont mis en cache automatiquement ; le volume concerné figure dans usage.prompt_tokens_details.cached_tokens. Lors de nos tests, avec un préfixe identique d’environ 5600 tokens, la deuxième requête a accédé au cache pour plus de 5000 tokens.
• Sortie structurée : lors de nos tests, avec un json_schema passé dans response_format, la réponse restait du texte ordinaire. Si vous avez besoin de JSON, décrivez les champs dans le prompt et analysez la réponse vous-même.

Erreurs courantes

Les autres erreurs générales sont décrites dans Gestion des erreurs.

Documentation officielle

• Plateforme ouverte MiniMax · Documentation 

FAQ