Différences de paramètres et de protocoles de MiniMax

Découvrez les différences de paramètres et l’utilisation de MiniMax avec les protocoles compatibles.

Pour MiniMax, adaptez les paramètres du protocole choisi selon cette page. Structures complètes : Chat Completions, Responses et Messages.

Modèles concernés

Modèle	Portée
MiniMax-M3.1-Flash	Chat, Responses, Messages ; raisonnement toujours actif, intensité réglable
MiniMax-M3	Chat, Responses, Messages ; raisonnement activable, avec des états par défaut propres au protocole

Différences Chat Completions

Champ	Différence
`thinking.type`	Les deux utilisent `adaptive` par défaut ; M3 désactive avec `disabled`, M3.1-Flash renvoie `400` pour `disabled`
`reasoning_effort`	M3.1-Flash accepte `low/medium/high/xhigh/max`, défaut `max` ; `none` renvoie `400`. M3 ignore ce champ
`reasoning_split`	Extension MiniMax : `true` sépare le raisonnement dans `reasoning_content`, `false` le place dans les balises `<think>` de `content`. Ne contrôle pas son activation ; M3.1-Flash refuse `false`
`temperature`, `top_p`	Valeurs ignorées, valeurs effectives `1`, `0.95`. Si fourni, `top_p` doit néanmoins respecter `(0,1]`
`presence_penalty`, `frequency_penalty`, `logit_bias`	Valeurs ignorées
`max_completion_tokens`	Minimum `1`, maximum `524288`, recommandé `131072`. Inclut raisonnement et réponse ; recommandation distincte de la valeur par défaut
`service_tier`	M3 accepte `standard/priority`, défaut `standard` ; M3.1-Flash ne prend pas ce champ en charge
Messages assistant précédents	Renvoyer tout l’historique des outils avec `reasoning_content`, `content`, `tool_calls` ; un appel simple peut ne pas contenir de raisonnement visible

Différences Responses

Champ	Différence
`reasoning.effort`	M3.1-Flash raisonne toujours, accepte `low/medium/high/xhigh/max`, défaut `max` ; `none` renvoie `400`. M3 est désactivé par défaut ; tout niveau autre que `none` l’active sans régler sa profondeur
`temperature`, `top_p`	Valeurs ignorées, valeurs effectives `1`, `0.95`. Si fourni, `top_p` doit néanmoins respecter `(0,1]`
`max_output_tokens`	Les tokens de raisonnement comptent dans le budget ; trop faible, il peut donner `incomplete` sans élément message final
`tool_choice`	Accepte uniquement `auto`
`text.format.type`	Seul `text` est actuellement défini
`store`	Valeur demandée ignorée ; réponse fixée à `false`
`previous_response_id`, `conversation`	Valeur demandée ignorée ; réponse fixée à `null`. Renvoyer côté client tout l’historique, dont reasoning et appels d’outils
`parallel_tool_calls`, `truncation`	Valeurs demandées ignorées ; réponses fixées respectivement à `true`, `disabled`
`service_tier`	M3 accepte `standard/priority`, défaut `standard` ; M3.1-Flash ne prend pas ce champ en charge
Recherche côté serveur	Outil Beta ; utiliser `type: "web_search"` dans `tools`

Différences Messages

Champ	Différence
`thinking.type`	M3.1-Flash toujours actif, accepte seulement `adaptive` ; `disabled` renvoie `400`. M3 désactivé par défaut ; activer avec `adaptive`, désactiver avec `disabled`
`output_config.effort`	M3.1-Flash accepte `low/medium/high/xhigh/max`, défaut `max` ; `none` renvoie `400`. M3 ignore ce champ
`temperature`, `top_p`	Valeurs ignorées, valeurs effectives `1`, `0.95`. Si fourni, `top_p` doit néanmoins respecter `(0,1]`
`top_k`, `stop_sequences`, `mcp_servers`, `context_management`, `container`	Valeurs ignorées
`max_tokens`	Minimum `1`, maximum `524288`, recommandé `131072` ; raisonnement inclus dans cette limite
`tool_choice.type`	Accepte uniquement `auto`
`service_tier`	M3 accepte `standard/priority`, défaut `standard` ; M3.1-Flash ne prend pas ce champ en charge
Blocs assistant précédents	Conserver thinking, text, tool_use et la signature `signature` ; un appel simple peut ne pas inclure thinking
Recherche côté serveur	Outil Beta ; utiliser `type: "web_search_20250305"` et `name: "web_search"`

Différences de cache

Champ	Différence
Cache automatique de préfixe	Applicable à partir de 512 tokens d’entrée, sans marqueur. Correspondance dans l’ordre : outils, système, historique
`cache_control`	Les deux modèles ne prennent pas en charge les marqueurs de cache explicite Anthropic
`prompt_cache_key` de Responses	Peut identifier le routage du cache de prompt

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	`image_url`	Chat : `image_url.url` reçoit une URL publique ou Base64 Data URL
Vidéo	`video_url`	Chat : `video_url.url` reçoit une URL publique, Base64 Data URL ou référence native `mm_file://{file_id}`
Image	`input_image`	Responses : `image_url` est une chaîne URL / Base64, ou un objet contenant `url`, `detail`
Vidéo	`input_video`	Responses : `video_url` est une chaîne URL / Base64, ou un objet contenant `url`, `fps`, `detail`, `max_long_side_pixel`
Image	`image`	Messages : fournir `url` pour `source.type=url`, ou `media_type` et `data` pour `source.type=base64`
Vidéo	`video`	Extension Messages : `source` accepte URL, Base64 ou référence vidéo native et les réglages d’échantillonnage

Champ	Différence
`detail`	Accepte `low/default/high`, défaut `default`. Chat : objet média ; Responses : objet URL ; Messages : dans `source`
`fps`	Échantillonnage vidéo : plage `0.2～5`, défaut `1`. Chat / Responses : `video_url.fps` dans le bloc vidéo ; Messages : `source.fps`
`max_long_side_pixel`	Limite le plus grand côté des images ou trames ; Chat : objet média, Responses : objet URL vidéo, Messages : `source`
Taille des médias	Chat / Messages : images 10 MB, vidéos URL / Base64 50 MB, corps 64 MB maximum. Vidéos téléversées par Files API natif : 512 MB

mm_file:// provient de l’API native de téléversement MiniMax. Cette page ne fournit pas d’API de téléversement AGTCloud.

Exemples d’appel

Remplacez MODEL_ID par l’ID complet et utilisez votre API Key. Ces exemples emploient les niveaux M3.1-Flash ; pour M3, voir le tableau.

curl 'https://api.agtcloud.cn/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Expliquez en trois points comment diagnostiquer un délai d’attente API"}],
    "thinking": {"type": "adaptive"},
    "reasoning_effort": "low",
    "max_completion_tokens": 4096
  }'