> ## 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.

# API Kimi (tous les modèles) - Chat Completions : Démarrage rapide

> - Appeler les modèles Kimi via le protocole OpenAI Chat Completions et choisir le modèle avec `model`
- Seuls `model` et `messages` sont requis
- Les trois modèles ont une fenêtre de contexte de 1 048 576 tokens et une limite de sortie par défaut de 131 072 tokens
- Le raisonnement est toujours activé et renvoyé dans `reasoning_content` ; ses tokens comptent dans la sortie
- Pour les appels d’outils, la recherche Web, les sorties structurées, les images en entrée et le cache, consulter la [référence complète](/fr/api-manual/language-series/kimi/chat-completions/chat-completions-reference)

> [!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]
>
> **Le raisonnement est toujours activé sur les modèles Kimi** et renvoyé dans `reasoning_content`. Ses tokens comptent dans la sortie. Évitez une valeur trop basse pour `max_completion_tokens` : le raisonnement pourrait épuiser le budget avant de produire le texte de réponse.


## OpenAPI

````yaml fr/api-manual/language-series/kimi/chat-completions/chat-completions-quickstart.json POST /v1/chat/completions
openapi: 3.1.0
info:
  title: 'API Kimi (tous les modèles) - Chat Completions : Démarrage rapide'
  description: >-
    Exemples de démarrage rapide pour appeler les modèles de texte Kimi via le
    protocole Chat Completions compatible OpenAI. Il suffit de `model` et
    `messages` pour démarrer une conversation ; consulter la page « Référence
    complète » pour les appels d’outils, la recherche Web, les sorties
    structurées et les images en entrée, entre autres.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: Production (Recommandé)
  - url: https://api.evolink.ai
    description: URL alternative
security:
  - bearerAuth: []
tags:
  - name: Chat Completions
    description: API compatible OpenAI Chat Completions
paths:
  /v1/chat/completions:
    post:
      tags:
        - Chat Completions
      summary: Chat Kimi rapide (tous les modèles)
      description: >-
        - Appeler les modèles Kimi via le protocole OpenAI Chat Completions et
        choisir le modèle avec `model`

        - Seuls `model` et `messages` sont requis

        - Les trois modèles ont une fenêtre de contexte de 1 048 576 tokens et
        une limite de sortie par défaut de 131 072 tokens

        - Le raisonnement est toujours activé et renvoyé dans
        `reasoning_content` ; ses tokens comptent dans la sortie

        - Pour les appels d’outils, la recherche Web, les sorties structurées,
        les images en entrée et le cache, consulter la [référence
        complète](/fr/api-manual/language-series/kimi/chat-completions/chat-completions-reference)
      operationId: kimiChatCompletionsQuick
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChatCompletionQuickRequest'
            examples:
              simple:
                summary: Requête Pro minimale
                value:
                  model: kimi-k3.1-pro
                  messages:
                    - role: user
                      content: Explique le cache de contexte en une phrase.
              highspeed:
                summary: Highspeed avec un faible effort de raisonnement
                value:
                  model: kimi-k3.1-pro-highspeed
                  messages:
                    - role: user
                      content: Explique le cache de contexte en une phrase.
                  reasoning_effort: low
              k3:
                summary: Requête minimale Kimi K3
                value:
                  model: kimi-k3
                  messages:
                    - role: user
                      content: Explique le cache de contexte en une phrase.
              multi_turn:
                summary: Instructions système et conversations à plusieurs tours
                value:
                  model: kimi-k3.1-pro
                  messages:
                    - role: system
                      content: >-
                        Vous êtes un rédacteur technique rigoureux. Répondez
                        avec concision.
                    - role: user
                      content: Qu’est-ce que le cache de contexte ?
                    - role: assistant
                      content: >-
                        Le cache de contexte conserve les préfixes répétés des
                        requêtes pour traiter les requêtes suivantes plus
                        rapidement et à moindre coût lorsqu’elles trouvent ce
                        cache.
                    - role: user
                      content: À quels usages convient-il ?
                  reasoning_effort: low
              streaming:
                summary: Sortie SSE en streaming
                value:
                  model: kimi-k3.1-pro
                  messages:
                    - role: user
                      content: Écris un poème de quatre vers sur une nuit d’été.
                  reasoning_effort: low
                  max_completion_tokens: 2048
                  stream: true
      responses:
        '200':
          description: >-
            Conversation générée avec succès ; les requêtes en streaming
            renvoient un flux d’événements SSE
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChatCompletionResponse'
            text/event-stream:
              schema:
                type: string
                description: >-
                  Données SSE au format OpenAI Chat Completions, terminées par
                  `data: [DONE]`.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    ChatCompletionQuickRequest:
      type: object
      required:
        - model
        - messages
      properties:
        model:
          type: string
          enum:
            - kimi-k3.1-pro
            - kimi-k3.1-pro-highspeed
            - kimi-k3
          default: kimi-k3.1-pro
          description: >-
            Modèle à appeler :


            | Identifiant du modèle | Positionnement |

            |---|---|

            | `kimi-k3.1-pro` | Dernière génération (recommandée) |

            | `kimi-k3.1-pro-highspeed` | Mêmes paramètres que Pro, génération
            plus rapide |

            | `kimi-k3` | Génération précédente |


            Les trois modèles ont une fenêtre de contexte de 1 048 576 tokens et
            un raisonnement toujours activé.
        messages:
          type: array
          minItems: 1
          description: >-
            Messages de la conversation. Fournir l’historique dans l’ordre pour
            les conversations à plusieurs tours ; consulter la référence
            complète pour renvoyer l’historique de raisonnement et d’appels
            d’outils.
          items:
            $ref: '#/components/schemas/MessageSimple'
        reasoning_effort:
          type: string
          enum:
            - low
            - high
            - max
          default: max
          description: >-
            Effort de raisonnement, `max` par défaut. `kimi-k3` prend uniquement
            en charge `max` ; les autres valeurs compatibles sont décrites dans
            la référence complète.
        max_completion_tokens:
          type: integer
          minimum: 1
          maximum: 1048576
          default: 131072
          description: >-
            Nombre maximal de tokens générés, raisonnement et réponse finale
            compris ; 131072 par défaut, 1048576 au maximum.
        stream:
          type: boolean
          default: false
          description: Indique si la réponse est renvoyée sous forme de flux SSE.
    ChatCompletionResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifiant de la réponse.
          example: chatcmpl-6adc72a2823cc13b156bf863
        object:
          type: string
          enum:
            - chat.completion
          example: chat.completion
        created:
          type: integer
          description: Date de création, horodatage Unix en secondes.
          example: 1792832163
        model:
          type: string
          description: Modèle utilisé pour cet appel.
          example: kimi-k3.1-pro
        choices:
          type: array
          items:
            $ref: '#/components/schemas/Choice'
        usage:
          $ref: '#/components/schemas/Usage'
    MessageSimple:
      type: object
      required:
        - role
        - content
      properties:
        role:
          type: string
          enum:
            - system
            - user
            - assistant
          description: >-
            Rôle du message : `system` pour les instructions système, `user`
            pour l’entrée utilisateur et `assistant` pour les réponses
            précédentes.
        content:
          type: string
          description: Contenu du message (texte brut).
          example: Explique le cache de contexte en une phrase.
    Choice:
      type: object
      properties:
        index:
          type: integer
          example: 0
        message:
          $ref: '#/components/schemas/AssistantMessage'
        finish_reason:
          type: string
          enum:
            - stop
            - length
            - tool_calls
          description: >-
            Motif de fin : `stop` indique une fin naturelle, `length` une limite
            de sortie atteinte et `tool_calls` une demande d’appel d’outil.
          example: stop
    Usage:
      type: object
      properties:
        prompt_tokens:
          type: integer
          description: Total des tokens d’entrée, y compris ceux issus du cache.
          example: 24
        completion_tokens:
          type: integer
          description: Tokens de sortie, raisonnement compris.
          example: 96
        total_tokens:
          type: integer
          description: Nombre total de tokens d'entrée et de sortie.
          example: 120
        prompt_tokens_details:
          type: object
          properties:
            cached_tokens:
              type: integer
              description: Tokens d'entrée servis depuis le cache.
              example: 0
        completion_tokens_details:
          type: object
          properties:
            reasoning_tokens:
              type: integer
              description: Tokens de raisonnement, déjà inclus dans completion_tokens.
              example: 62
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type:
                - string
                - 'null'
    AssistantMessage:
      type: object
      properties:
        role:
          type: string
          enum:
            - assistant
          example: assistant
        content:
          type:
            - string
            - 'null'
          description: Réponse finale.
          example: >-
            Le cache de contexte conserve les préfixes répétés des requêtes pour
            traiter les requêtes suivantes plus rapidement et à moindre coût
            lorsqu’elles trouvent ce cache.
        reasoning_content:
          type: string
          description: >-
            Contenu du raisonnement. Le renvoyer avec le message assistant
            complet dans les conversations à plusieurs tours.
          example: >-
            L’utilisateur souhaite une explication en une phrase du cache de
            contexte, précisant ce qu’il conserve et ses avantages.
  responses:
    BadRequest:
      description: Paramètres de requête invalides
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: La clé API est absente ou invalide
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    RateLimited:
      description: Limite de débit dépassée ou quota insuffisant
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Erreur interne du service
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Toutes les API nécessitent une authentification par 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.