Skip to main content
POST
BaseURL : la BaseURL par défaut est https://direct.evolink.ai, qui offre une meilleure prise en charge des modèles textuels et des connexions de longue durée. https://api.evolink.ai est le point de terminaison principal pour les services multimodaux et sert d’adresse de repli pour les modèles textuels.

Autorisations

Authorization
string
header
requis

Toutes les API nécessitent une authentification Bearer Token

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Corps

application/json
model
enum<string>
requis

ID du modèle

Options disponibles:
MiniMax-M3.1-Flash
Exemple:

"MiniMax-M3.1-Flash"

input
requis

Entrée du modèle

  • Chaîne : le texte entier est traité comme un message user
  • Tableau : liste d’éléments d’entrée ; prend en charge message, function_call, function_call_output et reasoning

Multimodal : combinez des blocs input_text, input_image et input_video dans le tableau content d’un élément message.

Conversations multi-tours : l’API est sans état. Pour poursuivre une conversation, le tableau doit contenir l’historique complet.

Exemple:

"Explain recursion in one sentence."

instructions
string

Instructions de niveau système, équivalentes à un message system inséré tout au début ; sert à définir le rôle, le ton et les contraintes de sortie.

Exemple:

"You are a technical documentation assistant. Keep your answers concise."

stream
boolean
défaut:false

Indique si la réponse est renvoyée en streaming

  • false (par défaut) : renvoie l’objet de réponse complet en une seule fois
  • true : transmet des événements SSE sémantiques ; l’événement final est response.completed. [DONE] n’est pas envoyé
Exemple:

false

max_output_tokens
integer

Nombre maximal de tokens de sortie pour cette génération, raisonnement et réponse inclus

  • Valeur recommandée : 131,072 (128K), maximum : 524,288 (512K)
  • Une valeur trop faible peut atteindre la limite pendant le raisonnement. Dans ce cas, la réponse contient status: "incomplete" sans élément de sortie message
Plage requise: 1 <= x <= 524288
Exemple:

131072

reasoning
object

Configuration du raisonnement. MiniMax-M3.1-Flash effectue toujours un raisonnement. Son contenu est renvoyé sous forme d’éléments de sortie reasoning ; les tokens correspondants sont comptabilisés dans la sortie et facturés au tarif de sortie.

temperature
enum<number>
défaut:1

Température d’échantillonnage, fixée à 1

Options disponibles:
1
Exemple:

1

top_p
number
défaut:0.95

Seuil d’échantillonnage par noyau, valeur par défaut : 0.95.

Plage requise: 0 <= x <= 1
Exemple:

0.95

tools
Définition d'outil · object[]

Liste des outils que le modèle peut appeler. Seul le type function est actuellement pris en charge. Les fonctions sont exécutées par le client, qui transmet leurs résultats sous forme d’éléments d’entrée function_call_output.

tool_choice
enum<string>
défaut:auto

Stratégie de sélection des outils. Seule la valeur auto est prise en charge ; le modèle décide s’il doit appeler un outil

Options disponibles:
auto
Exemple:

"auto"

text
object

Configuration du format de sortie textuelle. Seule la valeur text est prise en charge pour format.type

metadata
object

Métadonnées de la requête, dont les clés et les valeurs sont des chaînes

Réponse

Génération réussie

Objet de réponse de l’API Responses. Outre les champs ci-dessous, la réponse reprend la configuration de la requête (tools, tool_choice, temperature, top_p, text, reasoning, max_output_tokens, etc.).

id
string

Identifiant unique de cette réponse

Exemple:

"072514d63605b7a0c83f1672230c398c"

object
string

Type d'objet, toujours response

Exemple:

"response"

created_at
integer

Date de création sous forme d'horodatage Unix (secondes)

Exemple:

1792401878

status
enum<string>

Statut de la réponse

  • completed : traitement terminé normalement
  • incomplete : sortie tronquée ; voir la cause dans incomplete_details
  • failed : échec de la génération ; voir la cause dans error
Options disponibles:
completed,
incomplete,
failed
Exemple:

"completed"

model
string

ID du modèle ayant réellement produit cette réponse

Exemple:

"MiniMax-M3.1-Flash"

output
object[]

Liste des éléments de sortie dans l’ordre de leur génération :

  • reasoning : processus de raisonnement, avec un ID au format <id>_rs ; contient content (liste de blocs reasoning_text), summary (tableau vide) et encrypted_content
  • message : réponse finale, avec un ID au format <id>_msg ; contient content (liste de blocs output_text)
  • function_call : appel de fonction généré par le modèle, avec un ID au format <id>_fc_<index> ; contient call_id, name et arguments. Le client doit exécuter la fonction et transmettre le résultat dans un élément function_call_output
output_text
string | null

Champ pratique contenant la concaténation de tous les textes output_text ; vaut null en l’absence de sortie textuelle

error
object | null

Motif de l'échec ; null en cas de succès

incomplete_details
object | null

Cause de la troncature ; vaut null si la sortie n’est pas tronquée. reason vaut max_output_tokens (limite de sortie atteinte) ou content_filter (sécurité du contenu)

usage
object

Statistiques d’utilisation des tokens, avec le détail du cache et du raisonnement