> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax-M3.1-Flash - API compatible OpenAI

> - Appelle le modèle MiniMax-M3.1-Flash via le protocole OpenAI Chat Completions
- **Conversations multi-tours** : prend en charge les conversations à un ou plusieurs tours avec contexte
- **Invite système** : personnalise le rôle et le comportement de l’IA via un message `role=system`
- **Entrée multimodale** : `content` permet de combiner du texte avec des images / vidéos
- **Raisonnement** : toujours activé ; `reasoning_effort` règle sa profondeur. Le contenu du raisonnement est renvoyé dans `reasoning_content` ; `content` contient uniquement la réponse finale
- **Sortie en streaming** : prise en charge du streaming SSE
- **Appels d’outils** : prise en charge du Function Calling

**Réponses en streaming** : lorsque `stream=true`, la réponse est transmise via Server-Sent Events. Chaque message utilise le format `data: {JSON}` ; le flux se termine par `data: [DONE]`. `choices[].delta` transmet d’abord `reasoning_content` de manière incrémentale, puis `content` / `tool_calls`. Lorsque `stream_options.include_usage=true`, un bloc de données supplémentaire contenant `usage` est renvoyé avant la fin du flux.

<Note>
  **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.
</Note>


## OpenAPI

````yaml fr/api-manual/language-series/minimax-m3.1-flash/minimax-m3.1-flash-chat.json POST /v1/chat/completions
openapi: 3.1.0
info:
  title: MiniMax-M3.1-Flash – Référence complète des paramètres (compatible OpenAI)
  description: >-
    Référence complète de l’API de conversation de MiniMax-M3.1-Flash.


    **Capacités du modèle** :

    - Longueur du contexte : **1,000,000 tokens** (1M)

    - Sortie maximale : **524,288 tokens** (512K), valeur recommandée :
    **131,072 tokens** (128K), tokens de raisonnement inclus

    - Raisonnement : toujours activé ; la profondeur se règle avec
    `reasoning_effort`, dont la valeur par défaut est `max`

    - Entrée multimodale : texte, images et vidéos

    - Appels d’outils : prise en charge du Function Calling

    - Cache de contexte : les préfixes identiques sont automatiquement lus
    depuis le cache ; les tokens correspondants figurent dans
    `usage.prompt_tokens_details.cached_tokens`

    - Sortie en streaming : prise en charge du streaming SSE


    Pour une conversation multi-tours, ajoutez à `messages` le message assistant
    complet du tour précédent sans le modifier, y compris `reasoning_content` et
    `tool_calls`.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: Production (recommandée)
  - url: https://api.evolink.ai
    description: URL alternative
security:
  - bearerAuth: []
tags:
  - name: Génération de conversation
    description: Points de terminaison liés à la génération de conversation par IA
paths:
  /v1/chat/completions:
    post:
      tags:
        - Génération de conversation
      summary: API de conversation de MiniMax-M3.1-Flash (compatible OpenAI)
      description: >-
        - Appelle le modèle MiniMax-M3.1-Flash via le protocole OpenAI Chat
        Completions

        - **Conversations multi-tours** : prend en charge les conversations à un
        ou plusieurs tours avec contexte

        - **Invite système** : personnalise le rôle et le comportement de l’IA
        via un message `role=system`

        - **Entrée multimodale** : `content` permet de combiner du texte avec
        des images / vidéos

        - **Raisonnement** : toujours activé ; `reasoning_effort` règle sa
        profondeur. Le contenu du raisonnement est renvoyé dans
        `reasoning_content` ; `content` contient uniquement la réponse finale

        - **Sortie en streaming** : prise en charge du streaming SSE

        - **Appels d’outils** : prise en charge du Function Calling


        **Réponses en streaming** : lorsque `stream=true`, la réponse est
        transmise via Server-Sent Events. Chaque message utilise le format
        `data: {JSON}` ; le flux se termine par `data: [DONE]`.
        `choices[].delta` transmet d’abord `reasoning_content` de manière
        incrémentale, puis `content` / `tool_calls`. Lorsque
        `stream_options.include_usage=true`, un bloc de données supplémentaire
        contenant `usage` est renvoyé avant la fin du flux.
      operationId: createChatCompletionMiniMaxM31Flash
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatCompletionRequest'
            examples:
              simple_text:
                summary: Conversation textuelle sur un seul tour
                value:
                  model: MiniMax-M3.1-Flash
                  messages:
                    - role: user
                      content: Please introduce yourself.
                  max_completion_tokens: 131072
              multi_turn:
                summary: Conversation multi-tours (compréhension du contexte)
                value:
                  model: MiniMax-M3.1-Flash
                  messages:
                    - role: user
                      content: What is Python?
                    - role: assistant
                      content: Python is a high-level programming language.
                    - role: user
                      content: What are its main advantages?
                  max_completion_tokens: 131072
              system_prompt:
                summary: Utilisation des invites système
                value:
                  model: MiniMax-M3.1-Flash
                  messages:
                    - role: system
                      content: >-
                        You are a Python programming assistant. Keep your
                        answers concise.
                    - role: user
                      content: How do I read a file?
                  max_completion_tokens: 131072
              reasoning_effort:
                summary: Régler la profondeur du raisonnement
                value:
                  model: MiniMax-M3.1-Flash
                  reasoning_effort: high
                  messages:
                    - role: user
                      content: >-
                        A bat and a ball cost 1.10 in total. The bat costs 1.00
                        more than the ball. How much does the ball cost?
                  max_completion_tokens: 131072
              image_understanding:
                summary: Compréhension d'images (entrée multimodale)
                value:
                  model: MiniMax-M3.1-Flash
                  messages:
                    - role: user
                      content:
                        - type: text
                          text: What is shown in this image?
                        - type: image_url
                          image_url:
                            url: https://example.com/image.jpeg
                            detail: default
                  max_completion_tokens: 131072
              video_understanding:
                summary: Compréhension vidéo (entrée multimodale)
                value:
                  model: MiniMax-M3.1-Flash
                  messages:
                    - role: user
                      content:
                        - type: text
                          text: Summarize this video.
                        - type: video_url
                          video_url:
                            url: https://example.com/video.mp4
                            fps: 1
                            detail: default
                  max_completion_tokens: 131072
              tool_calling:
                summary: Function Calling (appel d'outil)
                value:
                  model: MiniMax-M3.1-Flash
                  messages:
                    - role: user
                      content: Check the stock for product demo-item-001.
                  tools:
                    - type: function
                      function:
                        name: get_product_stock
                        description: Get the current stock level for a product.
                        parameters:
                          type: object
                          properties:
                            product_id:
                              type: string
                              description: Product identifier.
                          required:
                            - product_id
                  max_completion_tokens: 131072
              streaming:
                summary: Sortie en streaming
                value:
                  model: MiniMax-M3.1-Flash
                  stream: true
                  stream_options:
                    include_usage: true
                  messages:
                    - role: user
                      content: Write a short poem about spring.
                  max_completion_tokens: 131072
      responses:
        '200':
          description: Génération de la conversation réussie
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatCompletionResponse'
              examples:
                with_thinking:
                  summary: Avec contenu de raisonnement
                  value:
                    id: 072514edea627212c7e226a55bcf4e2e
                    choices:
                      - finish_reason: stop
                        index: 0
                        message:
                          content: '0.05'
                          role: assistant
                          name: MiniMax AI
                          audio_content: ''
                          reasoning_content: >-
                            Let the ball cost x. Then 2x + 1 = 1.10, so x =
                            0.05.
                    created: 1792401901
                    model: MiniMax-M3.1-Flash
                    object: chat.completion
                    usage:
                      total_tokens: 281
                      total_characters: 0
                      prompt_tokens: 229
                      completion_tokens: 52
                      completion_tokens_details:
                        reasoning_tokens: 49
                      prompt_tokens_details:
                        cached_tokens: 187
                    input_sensitive: false
                    output_sensitive: false
                    input_sensitive_type: 0
                    output_sensitive_type: 0
                    output_sensitive_int: 0
                    base_resp:
                      status_code: 0
                      status_msg: ''
                direct_answer:
                  summary: Réponse directe (sans contenu de raisonnement)
                  value:
                    id: 072514cc3cee91b3222f36a2a386128f
                    choices:
                      - finish_reason: stop
                        index: 0
                        message:
                          content: >-
                            Recursion is a technique in which a function calls
                            itself to solve smaller instances of a problem.
                          role: assistant
                          name: MiniMax AI
                          audio_content: ''
                    created: 1792401868
                    model: MiniMax-M3.1-Flash
                    object: chat.completion
                    usage:
                      total_tokens: 219
                      total_characters: 0
                      prompt_tokens: 208
                      completion_tokens: 11
                      prompt_tokens_details:
                        cached_tokens: 58
                    input_sensitive: false
                    output_sensitive: false
                    input_sensitive_type: 0
                    output_sensitive_type: 0
                    output_sensitive_int: 0
                    base_resp:
                      status_code: 0
                      status_msg: ''
                tool_calls:
                  summary: Appel d'outil déclenché (finish_reason=tool_calls)
                  value:
                    id: 072514ce0ad459c5ac53494746f66488
                    choices:
                      - finish_reason: tool_calls
                        index: 0
                        message:
                          content: I'll check the stock for product demo-item-001.
                          role: assistant
                          name: MiniMax AI
                          tool_calls:
                            - id: call_function_fr79bzcw7n6k_1
                              type: function
                              function:
                                name: get_product_stock
                                arguments: '{"product_id": "demo-item-001"}'
                              index: 0
                          audio_content: ''
                    created: 1792401870
                    model: MiniMax-M3.1-Flash
                    object: chat.completion
                    usage:
                      total_tokens: 483
                      total_characters: 0
                      prompt_tokens: 446
                      completion_tokens: 37
                      prompt_tokens_details:
                        cached_tokens: 227
                    input_sensitive: false
                    output_sensitive: false
                    input_sensitive_type: 0
                    output_sensitive_type: 0
                    output_sensitive_int: 0
                    base_resp:
                      status_code: 0
                      status_msg: ''
                length:
                  summary: Limite de sortie atteinte (finish_reason=length)
                  value:
                    id: 072513cf5d12aa74e53c700e4e1edf9e
                    choices:
                      - finish_reason: length
                        index: 0
                        message:
                          content: ''
                          role: assistant
                          name: MiniMax AI
                          audio_content: ''
                          reasoning_content: I need to explain the process step by step.
                    created: 1792401615
                    model: MiniMax-M3.1-Flash
                    object: chat.completion
                    usage:
                      total_tokens: 219
                      total_characters: 0
                      prompt_tokens: 211
                      completion_tokens: 8
                      completion_tokens_details:
                        reasoning_tokens: 8
                      prompt_tokens_details:
                        cached_tokens: 184
                    input_sensitive: false
                    output_sensitive: false
                    input_sensitive_type: 0
                    output_sensitive_type: 0
                    output_sensitive_int: 0
                    base_resp:
                      status_code: 0
                      status_msg: ''
        '400':
          description: Paramètres de requête invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: Invalid request parameters
                  type: invalid_request_error
                  param: ''
                  code: null
        '401':
          description: Non authentifié, jeton invalide ou expiré
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 401
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Quota insuffisant, recharge requise
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 402
                  message: Insufficient quota
                  type: insufficient_quota_error
        '403':
          description: Accès refusé pour ce modèle
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 403
                  message: Access denied for this model
                  type: permission_error
                  param: model
        '404':
          description: Ressource introuvable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 404
                  message: Specified model not found
                  type: not_found_error
                  param: model
        '413':
          description: Corps de requête trop volumineux
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 413
                  message: Request body too large
                  type: request_too_large_error
                  param: messages
        '429':
          description: Limite de fréquence dépassée
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 429
                  message: Rate limit exceeded
                  type: rate_limit_error
        '500':
          description: Erreur interne du serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 500
                  message: Internal server error
                  type: internal_server_error
        '502':
          description: Passerelle incorrecte
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 502
                  message: Bad gateway
                  type: bad_gateway_error
        '503':
          description: Service temporairement indisponible
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 503
                  message: Service temporarily unavailable
                  type: service_unavailable_error
components:
  schemas:
    ChatCompletionRequest:
      type: object
      required:
        - model
        - messages
      properties:
        model:
          type: string
          description: Nom du modèle de conversation
          enum:
            - MiniMax-M3.1-Flash
          example: MiniMax-M3.1-Flash
        messages:
          type: array
          description: >-
            Liste des messages de la conversation, prend en charge le dialogue
            multi-tours


            Les messages de rôles différents ont des structures de champs
            différentes ; sélectionnez le rôle correspondant pour le consulter
          items:
            oneOf:
              - $ref: '#/components/schemas/SystemMessage'
              - $ref: '#/components/schemas/UserMessage'
              - $ref: '#/components/schemas/AssistantRequestMessage'
              - $ref: '#/components/schemas/ToolMessage'
            discriminator:
              propertyName: role
              mapping:
                system: '#/components/schemas/SystemMessage'
                user: '#/components/schemas/UserMessage'
                assistant: '#/components/schemas/AssistantRequestMessage'
                tool: '#/components/schemas/ToolMessage'
          minItems: 1
        reasoning_effort:
          type: string
          description: >-
            Profondeur du raisonnement, valeur par défaut : `max`. Les niveaux
            plus élevés augmentent généralement la consommation de tokens de
            raisonnement et le temps de réponse.
          enum:
            - low
            - medium
            - high
            - xhigh
            - max
          default: max
          example: high
        thinking:
          type: object
          description: >-
            Mode de raisonnement. MiniMax-M3.1-Flash effectue toujours un
            raisonnement. Seule la valeur `adaptive` est prise en charge ; ce
            champ peut être omis
          properties:
            type:
              type: string
              enum:
                - adaptive
              default: adaptive
        reasoning_split:
          type: boolean
          description: >-
            Indique si le contenu du raisonnement est renvoyé séparément. Seule
            la valeur `true` est prise en charge ; le contenu est renvoyé dans
            `reasoning_content`. Ce champ peut être omis
          enum:
            - true
          default: true
        temperature:
          type: number
          description: >-
            Température d’échantillonnage, qui contrôle le caractère aléatoire
            de la sortie


            **Remarques** :

            - Plage : `[0, 2]`, valeur par défaut : 1

            - Les valeurs plus faibles produisent des résultats plus
            déterministes ; les valeurs plus élevées, des résultats plus variés


            **Recommandation** : ne modifiez pas simultanément temperature et
            top_p
          minimum: 0
          maximum: 2
          default: 1
          example: 1
        top_p:
          type: number
          description: >-
            Paramètre d’échantillonnage par noyau (Nucleus Sampling)


            **Remarques** :

            - Détermine la probabilité cumulée des tokens parmi lesquels
            effectuer l’échantillonnage

            - Par exemple, 0.95 sélectionne les tokens dont la probabilité
            cumulée atteint 95%

            - Plage : `[0, 1]`, valeur par défaut : 0.95


            **Recommandation** : ne modifiez pas simultanément temperature et
            top_p
          minimum: 0
          maximum: 1
          default: 0.95
          example: 0.95
        max_completion_tokens:
          type: integer
          description: >-
            Longueur maximale du contenu généré en tokens, **raisonnement et
            réponse inclus**


            **Remarques** :

            - 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
            `finish_reason=length` avec un `content` vide
          minimum: 1
          maximum: 524288
          example: 131072
        stream:
          type: boolean
          description: >-
            Indique s'il faut renvoyer la réponse en mode streaming


            - `true` : réponse en streaming, renvoie le contenu en temps réel
            par blocs via SSE (Server-Sent Events)

            - `false` : attend la réponse complète avant de la renvoyer (par
            défaut)
          default: false
          example: false
        stream_options:
          type: object
          description: |-
            Options de réponse en streaming

            N'a d'effet que lorsque `stream=true`
          properties:
            include_usage:
              type: boolean
              description: >-
                Indique si un bloc de données supplémentaire contenant
                uniquement les statistiques `usage` est renvoyé avant la fin du
                flux
        tools:
          type: array
          description: >-
            Liste de définitions d'outils pour le Function Calling


            Chaque outil requiert un nom, une description et un schéma de
            paramètres
          items:
            $ref: '#/components/schemas/Tool'
        tool_choice:
          type: string
          description: >-
            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
          enum:
            - auto
          default: auto
        max_tokens:
          type: integer
          description: >-
            Ancien paramètre de limite de longueur de génération


            **Remarque** : obsolète, veuillez utiliser `max_completion_tokens` à
            la place
          deprecated: true
          minimum: 1
        'n':
          type: integer
          description: >-
            Nombre de réponses générées ; seule la valeur `1` est prise en
            charge
          enum:
            - 1
          default: 1
    ChatCompletionResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifiant unique de la complétion de conversation
          example: 0668a381bdc3c0ded310e27c9a46d16e7
        model:
          type: string
          description: Nom du modèle réellement utilisé
          example: MiniMax-M3.1-Flash
        object:
          type: string
          enum:
            - chat.completion
          description: Type de réponse
          example: chat.completion
        created:
          type: integer
          description: Horodatage de création (secondes Unix)
          example: 1777026807
        choices:
          type: array
          description: Liste des choix de complétion de conversation
          items:
            $ref: '#/components/schemas/Choice'
        usage:
          $ref: '#/components/schemas/Usage'
        input_sensitive:
          type: boolean
          description: >-
            Indique si le contenu d'entrée a déclenché un filtre de mots
            sensibles. Si l'entrée enfreint gravement les règles, l'API renvoie
            une erreur de violation de contenu avec un contenu de réponse vide
        input_sensitive_type:
          type: integer
          description: >-
            Type de mot sensible déclenché par l'entrée (renvoyé lorsque
            `input_sensitive` est true) : 1 violation grave ; 2 pornographie ; 3
            publicité ; 4 contenu interdit ; 5 langage injurieux ; 6
            violence/terrorisme ; 7 autre
        output_sensitive:
          type: boolean
          description: >-
            Indique si le contenu de sortie a déclenché un filtre de mots
            sensibles
        output_sensitive_type:
          type: integer
          description: Type de mot sensible déclenché par la sortie
        base_resp:
          type: object
          description: Code de statut et détails de l'erreur
          properties:
            status_code:
              type: integer
              description: >-
                Code de statut. `0` indique un succès ; les autres codes
                incluent `1002` pour la limitation de fréquence, `1008` pour un
                solde insuffisant, `1039` pour un dépassement de la limite de
                tokens, `2013` pour une erreur de paramètre, etc.
            status_msg:
              type: string
              description: Détails de l'erreur
        output_sensitive_int:
          type: integer
          description: >-
            Identifiant numérique de la catégorie de mots sensibles détectée
            dans la sortie
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type:
                - integer
                - string
                - 'null'
              description: Code d'erreur de statut HTTP
            message:
              type: string
              description: Description de l'erreur
            type:
              type: string
              description: Type d'erreur
            param:
              type: string
              description: Nom du paramètre concerné
    SystemMessage:
      title: System Message
      type: object
      required:
        - role
        - content
      properties:
        role:
          type: string
          enum:
            - system
          description: Identifiant de rôle, fixé à `system`
        content:
          type: string
          description: >-
            Contenu de l'invite système, utilisé pour définir le rôle et le
            comportement de l'IA
        name:
          type: string
          description: >-
            Nom du participant, utilisé pour distinguer les différentes sources
            d'invites système
    UserMessage:
      title: User Message
      type: object
      required:
        - role
        - content
      properties:
        role:
          type: string
          enum:
            - user
          description: Identifiant de rôle, fixé à `user`
        content:
          description: >-
            Contenu du message utilisateur


            **Remarques** :

            - Pour du texte brut, transmettez directement une chaîne

            - Pour une entrée multimodale, transmettez un tableau de blocs de
            contenu ; les types pris en charge sont `text`, `image_url` (image)
            et `video_url` (vidéo)

            - Taille maximale du corps de la requête : 64 MB
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ContentPart'
        name:
          type: string
          description: >-
            Nom du participant, utilisé pour distinguer les différents
            utilisateurs
    AssistantRequestMessage:
      title: Assistant Message
      type: object
      required:
        - role
      properties:
        role:
          type: string
          enum:
            - assistant
          description: Identifiant de rôle, fixé à `assistant`
        content:
          type:
            - string
            - 'null'
          description: >-
            Contenu du message de l'assistant


            **Remarques** :

            - Utilisé pour transmettre les réponses historiques de l'assistant
            dans les conversations multi-tours

            - Peut être `null` lorsque `tool_calls` est présent
        reasoning_content:
          type: string
          description: >-
            Contenu de raisonnement renvoyé au tour précédent ; à retransmettre
            sans modification dans les conversations multi-tours
        name:
          type: string
          description: Nom du participant
        tool_calls:
          type: array
          description: >-
            Liste des appels d'outils


            Utilisée pour transmettre les informations historiques d'appels
            d'outils dans les conversations multi-tours
          items:
            type: object
            properties:
              id:
                type: string
                description: Identifiant unique de l'appel d'outil
              type:
                type: string
                enum:
                  - function
              function:
                type: object
                properties:
                  name:
                    type: string
                    description: Nom de la fonction appelée
                  arguments:
                    type: string
                    description: Arguments de la fonction (chaîne JSON)
    ToolMessage:
      title: Tool Message
      type: object
      required:
        - role
        - content
        - tool_call_id
      properties:
        role:
          type: string
          enum:
            - tool
          description: Identifiant de rôle, fixé à `tool`
        content:
          type: string
          description: Contenu du résultat de l'appel d'outil
        tool_call_id:
          type: string
          description: >-
            ID de l'appel d'outil


            Correspond au champ `id` renvoyé dans `tool_calls` du message de
            l'assistant
    Tool:
      type: object
      required:
        - type
        - function
      properties:
        type:
          type: string
          enum:
            - function
          description: Type d'outil, actuellement seul `function` est pris en charge
        function:
          type: object
          required:
            - name
            - parameters
          properties:
            name:
              type: string
              description: >-
                Nom de la fonction à appeler


                **Remarques** :

                - Doit être composé de caractères a-z, A-Z, 0-9, ou inclure des
                traits de soulignement et des tirets

                - La longueur maximale est de 64 caractères
            description:
              type: string
              description: >-
                Description de la fonction, aide le modèle à comprendre quand et
                comment appeler cette fonction
            parameters:
              type: object
              description: >-
                Paramètres d'entrée de la fonction, décrits sous forme d'objet
                JSON Schema
    Choice:
      type: object
      properties:
        index:
          type: integer
          description: Index du choix
          example: 0
        message:
          $ref: '#/components/schemas/AssistantMessage'
        finish_reason:
          type: string
          description: |-
            Raison de fin

            - `stop` : achèvement naturel ou séquence d'arrêt déclenchée
            - `length` : limite maximale de tokens atteinte
            - `content_filter` : contenu filtré par la politique de sécurité
            - `tool_calls` : le modèle a invoqué un outil
          enum:
            - stop
            - length
            - content_filter
            - tool_calls
          example: stop
    Usage:
      type: object
      description: Statistiques d'utilisation des tokens
      properties:
        total_tokens:
          type: integer
          description: Nombre total de tokens consommés
          example: 1604
        total_characters:
          type: integer
          description: Nombre total de caractères consommés
          example: 0
        prompt_tokens:
          type: integer
          description: >-
            Nombre total de tokens d’entrée, y compris les tokens lus depuis le
            cache
          example: 1365
        completion_tokens:
          type: integer
          description: Nombre de tokens de sortie (part de réflexion incluse)
          example: 239
        completion_tokens_details:
          type: object
          description: Détail des tokens de sortie
          properties:
            reasoning_tokens:
              type: integer
              description: Nombre de tokens de raisonnement
              example: 49
        prompt_tokens_details:
          type: object
          description: Détail des tokens d'entrée
          properties:
            cached_tokens:
              type: integer
              description: >-
                Nombre de tokens d’entrée lus depuis le cache


                Les tokens lus depuis le cache sont facturés au tarif de lecture
                du cache. Tokens non mis en cache = `prompt_tokens -
                cached_tokens` ; ils sont facturés au tarif d’entrée standard
              example: 114
    ContentPart:
      type: object
      description: >-
        Partie de contenu multimodal. Déclarez le type via `type` et ne
        renseignez que les champs correspondant à ce type
      properties:
        type:
          type: string
          enum:
            - text
            - image_url
            - video_url
          description: |-
            Type de contenu

            - `text` : bloc de texte
            - `image_url` : entrée d'image
            - `video_url` : entrée vidéo
        text:
          type: string
          description: Contenu textuel lorsque `type=text`
        image_url:
          type: object
          description: >-
            Entrée d'image (lorsque `type=image_url`). Maximum 10 Mo par image,
            prend en charge JPEG / PNG / GIF / WEBP
          required:
            - url
          properties:
            url:
              type: string
              description: URL de l'image, ou data URL base64 commençant par `data:`
            detail:
              type: string
              description: >-
                Contrôle la résolution d'analyse de l'image


                - `low` : faible précision, consomme moins de tokens

                - `default` : précision par défaut

                - `high` : haute précision, reconnaît plus de détails mais
                consomme plus de tokens
              enum:
                - low
                - default
                - high
              default: default
            max_long_side_pixel:
              type: integer
              description: Limite de pixels maximale pour le côté le plus long de l'image
              minimum: 1
        video_url:
          type: object
          description: >-
            Entrée vidéo (lorsque `type=video_url`). Maximum 50 Mo pour une
            vidéo en URL / Base64, prend en charge MP4 / AVI / MOV / MKV
          required:
            - url
          properties:
            url:
              type: string
              description: >-
                URL de la vidéo, une data URL base64 commençant par `data:`, ou
                une référence de fichier au format `mm_file://{file_id}`
            detail:
              type: string
              description: Contrôle la résolution d'extraction des images de la vidéo
              enum:
                - low
                - default
                - high
              default: default
            fps:
              type: number
              description: >-
                Fréquence d’échantillonnage des images vidéo, valeur par défaut
                : 1, plage : [0.2, 5]. Une fréquence plus élevée aide à détecter
                les changements visuels et augmente généralement la consommation
                de tokens.
              minimum: 0.2
              maximum: 5
              default: 1
            max_long_side_pixel:
              type: integer
              description: >-
                Limite de pixels maximale pour le côté le plus long des images
                de la vidéo
              minimum: 1
    AssistantMessage:
      type: object
      properties:
        role:
          type: string
          description: Rôle de l'expéditeur du message
          enum:
            - assistant
          example: assistant
        content:
          type:
            - string
            - 'null'
          description: >-
            Contenu de la réponse finale, sans le processus de raisonnement
            (peut valoir `null` en cas d’appel d’outil)
          example: '0.05'
        reasoning_content:
          type: string
          description: >-
            Contenu du raisonnement. Il peut être absent pour les questions
            simples ; dans ce cas, ce champ n’est pas renvoyé
          example: Let the ball cost x. Then 2x + 1 = 1.10, so x = 0.05.
        name:
          type: string
          description: Nom de l'expéditeur
        audio_content:
          type: string
          description: >-
            Contenu audio (chaîne vide pour les scénarios de conversation en
            texte uniquement)
        tool_calls:
          type: array
          description: >-
            Liste des appels d'outils (renvoyée lorsque le modèle décide
            d'invoquer un outil)
          items:
            type: object
            properties:
              id:
                type: string
                description: Identifiant unique de l'appel d'outil
              type:
                type: string
                enum:
                  - function
              function:
                type: object
                properties:
                  name:
                    type: string
                    description: Nom de la fonction appelée
                  arguments:
                    type: string
                    description: Arguments de la fonction (chaîne JSON)
              index:
                type: integer
                description: Index de l'appel d'outil
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Toutes les API nécessitent une authentification Bearer Token


        **Obtenir une clé API** :


        Visitez la [Page de gestion des clés
        API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API


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

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.