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

# Kimi K3.1 Pro / Highspeed - API compatible Anthropic

> Point de terminaison public : POST /v1/messages. Définissez l’effort dans output_config.effort et le TTL d’écriture 5m/1h dans cache_control au premier niveau. Conservez intégralement thinking, signature, tool_use et les blocs de résultats de recherche du serveur.

> [!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.


## OpenAPI

````yaml fr/api-manual/language-series/kimi-k3.1-pro/kimi-k3.1-pro-messages.json POST /v1/messages
openapi: 3.1.0
info:
  title: Kimi K3.1 Pro / Highspeed - API compatible Anthropic
  description: >-
    Appelez Kimi K3.1 Pro / Highspeed via Anthropic Messages avec
    `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed`. Les deux modèles offrent un
    contexte de 1 048 576 tokens et prennent en charge les conversations
    multi-tours, le streaming, les outils, la recherche web, la sortie
    structurée et le cache de contexte.


    Le raisonnement reste actif. `output_config.effort` accepte `low` / `high` /
    `max`, avec `max` par défaut. Conservez tout l’historique du raisonnement et
    des appels d’outils entre les tours.
  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: Messages
    description: API compatible Anthropic Messages
paths:
  /v1/messages:
    post:
      tags:
        - Messages
      summary: API Messages Kimi K3.1 Pro / Highspeed
      description: >-
        Point de terminaison public : POST /v1/messages. Définissez l’effort
        dans output_config.effort et le TTL d’écriture 5m/1h dans cache_control
        au premier niveau. Conservez intégralement thinking, signature, tool_use
        et les blocs de résultats de recherche du serveur.
      operationId: createMessageKimiK31Pro
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMessageRequest'
            examples:
              simple:
                summary: Requête Pro minimale
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 1024
                  output_config:
                    effort: low
                  messages:
                    - role: user
                      content: Reply with OK.
              highspeed:
                summary: Requête Highspeed minimale
                value:
                  model: kimi-k3.1-pro-highspeed
                  max_tokens: 1024
                  output_config:
                    effort: low
                  messages:
                    - role: user
                      content: Reply with OK.
              streaming:
                summary: Streaming SSE Anthropic
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 1024
                  output_config:
                    effort: low
                  messages:
                    - role: user
                      content: Reply with OK.
                  stream: true
              cache_1h:
                summary: Cache 1h au premier niveau
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 1024
                  output_config:
                    effort: low
                  messages:
                    - role: user
                      content: Reply with OK.
                  cache_control:
                    type: ephemeral
                    ttl: 1h
              web_search:
                summary: Recherche web côté serveur
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 1024
                  output_config:
                    effort: low
                  messages:
                    - role: user
                      content: Use web search to find the official Kimi homepage URL.
                  tools:
                    - type: web_search_20250305
                      name: web_search
                      max_uses: 1
              structured_output:
                summary: Sortie structurée stricte
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 1024
                  output_config:
                    effort: low
                    format:
                      type: json_schema
                      schema:
                        type: object
                        properties:
                          result:
                            type: string
                        required:
                          - result
                        additionalProperties: false
                  messages:
                    - role: user
                      content: Return a JSON object with result equal to OK.
      responses:
        '200':
          description: >-
            Réponse Message ; les requêtes en streaming renvoient un flux
            d'événements Anthropic SSE
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
            text/event-stream:
              schema:
                type: string
                description: >-
                  La séquence d'événements comprend généralement message_start,
                  content_block_*, message_delta et message_stop.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    CreateMessageRequest:
      type: object
      required:
        - model
        - max_tokens
        - messages
      properties:
        model:
          type: string
          enum:
            - kimi-k3.1-pro
            - kimi-k3.1-pro-highspeed
          default: kimi-k3.1-pro
          description: >-
            Utilisez `kimi-k3.1-pro` ou `kimi-k3.1-pro-highspeed` ; Highspeed
            génère plus vite.
        max_tokens:
          type: integer
          minimum: 1
          description: >-
            Nombre maximal de tokens autorisés pour cette génération, y compris
            thinking et le texte final.
          maximum: 1048576
        messages:
          type: array
          minItems: 1
          description: >-
            Liste de messages Anthropic Messages. Pour une conversation
            multi-tour, renvoyez les blocs de contenu assistant complets sans
            modification.
          items:
            $ref: '#/components/schemas/Message'
        system:
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/MessagesTextBlockParam'
          description: Prompt système sous forme de chaîne ou de tableau de blocs text.
        stream:
          type: boolean
          default: false
          description: Indique si un flux d'événements Anthropic SSE est renvoyé.
        tools:
          type: array
          description: >-
            Fonctions personnalisées ou recherche web côté serveur. La recherche
            intégrée utilise type=web_search_20250305 et name=web_search ;
            facturation par appel effectué.
          items:
            oneOf:
              - $ref: '#/components/schemas/Tool'
              - $ref: '#/components/schemas/WebSearchTool'
        tool_choice:
          $ref: '#/components/schemas/ToolChoice'
        stop_sequences:
          type: array
          items:
            type: string
          maxItems: 5
          description: >-
            Séquences d’arrêt : une correspondance exacte arrête la génération
            et est exclue de la sortie. Au plus 5 séquences, de 32 octets
            maximum chacune.
        cache_control:
          type: object
          description: >-
            Seul cache_control au premier niveau contrôle le TTL d’écriture ;
            les marqueurs dans les blocs de message ne le remplacent pas. Par
            défaut : 5m.
          properties:
            type:
              type: string
              enum:
                - ephemeral
              description: Type de cache, toujours ephemeral.
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              default: 5m
              description: 'TTL du cache : 5m ou 1h ; par défaut : 5m.'
          required:
            - type
        output_config:
          type: object
          description: >-
            Configuration de sortie : effort de raisonnement et sortie
            structurée.
          properties:
            effort:
              type: string
              enum:
                - low
                - high
                - max
                - medium
                - xhigh
                - minimal
                - none
              default: max
              description: >-
                Effort de raisonnement : low / high / max recommandés ; par
                défaut : max. Le raisonnement reste actif. Alias clients :
                medium devient high, xhigh devient max, minimal / none devient
                low. none ne désactive pas le raisonnement. Un effort supérieur
                augmente généralement les tokens de raisonnement et la latence.
                Ces tokens comptent dans la sortie.
            format:
              type: object
              description: >-
                Sortie structurée. Si défini, le modèle renvoie du JSON
                respectant strictement le JSON Schema fourni.
              properties:
                type:
                  type: string
                  enum:
                    - json_schema
                schema:
                  type: object
                  description: JSON Schema que la sortie doit respecter.
                  additionalProperties: true
              required:
                - type
                - schema
    MessageResponse:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - assistant
        model:
          type: string
          example: kimi-k3.1-pro
        content:
          type: array
          items:
            $ref: '#/components/schemas/ContentBlock'
        stop_reason:
          type:
            - string
            - 'null'
          enum:
            - end_turn
            - max_tokens
            - tool_use
            - refusal
            - null
        stop_sequence:
          type:
            - string
            - 'null'
        usage:
          $ref: '#/components/schemas/MessageUsage'
    Message:
      type: object
      required:
        - role
        - content
      properties:
        role:
          type: string
          description: Rôle du message. Seuls user et assistant sont pris en charge.
          enum:
            - user
            - assistant
        content:
          description: >-
            Contenu du message sous forme de texte brut ou de tableau de blocs
            de contenu Anthropic.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ContentBlock'
    MessagesTextBlockParam:
      type: object
      properties:
        type:
          type: string
          enum:
            - text
        text:
          type: string
      required:
        - type
        - text
    Tool:
      type: object
      required:
        - name
        - input_schema
      properties:
        name:
          type: string
          description: Nom de l'outil.
        description:
          type: string
          description: Description aidant le modèle à décider quand utiliser l'outil.
        input_schema:
          type: object
          additionalProperties: true
          description: Définition des paramètres de l'outil au format JSON Schema.
    WebSearchTool:
      type: object
      required:
        - type
        - name
      properties:
        type:
          type: string
          enum:
            - web_search_20250305
        name:
          type: string
          enum:
            - web_search
        max_uses:
          type: integer
          minimum: 1
          description: Nombre maximal de recherches autorisées pour cette réponse.
    ToolChoice:
      type: object
      required:
        - type
      properties:
        type:
          type: string
          description: >-
            Choix d’outil : auto laisse décider le modèle, any impose un appel
            et none désactive les appels d’outils.
          enum:
            - auto
            - any
            - none
          default: auto
    ContentBlock:
      description: >-
        Bloc de contenu Anthropic pour le texte, l'image, le raisonnement,
        l'appel d'outil ou le résultat d'outil.
      oneOf:
        - $ref: '#/components/schemas/TextBlock'
        - $ref: '#/components/schemas/ImageBlock'
        - $ref: '#/components/schemas/ThinkingBlock'
        - $ref: '#/components/schemas/ToolUseBlock'
        - $ref: '#/components/schemas/ToolResultBlock'
        - $ref: '#/components/schemas/ServerToolUseBlock'
        - $ref: '#/components/schemas/WebSearchResultBlock'
    MessageUsage:
      type: object
      properties:
        input_tokens:
          type: integer
          description: >-
            Tokens d’entrée ordinaires, hors lectures et écritures du cache. Les
            trois catégories sont disjointes ; ne soustrayez pas à nouveau les
            tokens du cache.
        cache_creation_input_tokens:
          type: integer
          description: Tokens d'entrée écrits dans le cache.
        cache_read_input_tokens:
          type: integer
          description: Tokens d'entrée servis depuis le cache.
        output_tokens:
          type: integer
          description: Tokens de sortie, y compris les tokens thinking.
        output_tokens_details:
          type: object
          properties:
            thinking_tokens:
              type: integer
        cache_creation:
          type: object
          properties:
            ephemeral_5m_input_tokens:
              type: integer
              minimum: 0
            ephemeral_1h_input_tokens:
              type: integer
              minimum: 0
          description: >-
            Les deux sous-catégories d’écriture de cache_creation_input_tokens,
            facturées selon leur TTL réel.
        server_tool_use:
          type: object
          properties:
            web_search_requests:
              type: integer
              minimum: 0
          description: Utilisation de la recherche pour cette réponse.
    ErrorResponse:
      type: object
      properties:
        type:
          type: string
          enum:
            - error
        error:
          type: object
          properties:
            type:
              type: string
            message:
              type: string
        request_id:
          type: string
    TextBlock:
      type: object
      required:
        - type
        - text
      properties:
        type:
          type: string
          description: 'Type de bloc de contenu. Valeur fixe : text.'
          enum:
            - text
        text:
          type: string
          description: Contenu textuel.
    ImageBlock:
      type: object
      required:
        - type
        - source
      description: Bloc de contenu image (entrée multimodale).
      properties:
        type:
          type: string
          enum:
            - image
          description: 'Type de bloc de contenu. Valeur fixe : image.'
        source:
          type: object
          required:
            - type
          description: Source de l'image.
          properties:
            type:
              type: string
              enum:
                - base64
                - url
              description: >-
                Source d’image : base64 pour les données intégrées, url pour une
                référence de fichier.
            media_type:
              type: string
              enum:
                - image/jpeg
                - image/png
                - image/gif
                - image/webp
              description: Type MIME de l'image lorsque `type=base64`.
            data:
              type: string
              description: >-
                Données Base64 de l'image lorsque `type=base64` (sans le préfixe
                `data:`).
            url:
              type: string
              description: Référence de fichier image, uniquement lorsque type=url.
    ThinkingBlock:
      type: object
      required:
        - type
        - thinking
      properties:
        type:
          type: string
          description: 'Type de bloc de contenu. Valeur fixe : thinking.'
          enum:
            - thinking
        thinking:
          type: string
          description: >-
            Contenu de raisonnement du modèle. Renvoyez-le sans modification
            avec la signature dans les conversations multi-tours.
        signature:
          type: string
          description: >-
            Pour une conversation multi-tour, renvoyez cette valeur sans
            modification avec le bloc thinking.
    ToolUseBlock:
      type: object
      required:
        - type
        - id
        - name
        - input
      properties:
        type:
          type: string
          description: 'Type de bloc de contenu. Valeur fixe : tool_use.'
          enum:
            - tool_use
        id:
          type: string
          description: ID tool_use référencé lors du renvoi du résultat.
        name:
          type: string
          description: Nom de l'outil demandé par le modèle.
        input:
          type: object
          additionalProperties: true
          description: Objet d'entrée d'outil généré par le modèle.
    ToolResultBlock:
      type: object
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          description: 'Type de bloc de contenu. Valeur fixe : tool_result.'
          enum:
            - tool_result
        tool_use_id:
          type: string
          description: ID du bloc tool_use correspondant.
        content:
          description: >-
            Résultat d’outil sous forme de chaîne ou de tableau de blocs texte
            et image.
          oneOf:
            - type: string
            - type: array
              items:
                oneOf:
                  - $ref: '#/components/schemas/TextBlock'
                  - $ref: '#/components/schemas/ImageBlock'
        is_error:
          type: boolean
          default: false
          description: Indique si l'exécution de l'outil a échoué.
    ServerToolUseBlock:
      type: object
      required:
        - type
        - id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - server_tool_use
        id:
          type: string
        name:
          type: string
        input:
          type: object
          additionalProperties: true
    WebSearchResultBlock:
      type: object
      required:
        - type
        - tool_use_id
        - content
      properties:
        type:
          type: string
          enum:
            - web_search_tool_result
        tool_use_id:
          type: string
        content:
          oneOf:
            - type: array
              items:
                type: object
                additionalProperties: true
            - type: object
              additionalProperties: true
              description: Objet d’erreur de recherche, type=web_search_tool_result_error.
  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 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.