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

> Définissez l’effort via reasoning.effort et le cache via prompt_cache_options. La recherche apparaît dans des éléments web_search_call. En streaming, traitez response.completed / response.incomplete / response.failed ; la limite de sortie produit incomplete. Incluez tout l’historique output dans les requêtes multi-tours, raisonnement, appels d’outils et résultats compris.

> [!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-responses.json POST /v1/responses
openapi: 3.1.0
info:
  title: Kimi K3.1 Pro / Highspeed - API Responses
  version: 1.0.0
  description: >-
    Appelez Kimi K3.1 Pro / Highspeed via OpenAI Responses 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. `reasoning.effort` accepte `low` / `high` /
    `max`, avec `max` par défaut. Conservez tout l’historique du raisonnement et
    des appels d’outils entre les tours.
servers:
  - url: https://direct.evolink.ai
    description: Production (recommandée)
  - url: https://api.evolink.ai
    description: URL alternative
security:
  - bearerAuth: []
paths:
  /v1/responses:
    post:
      tags:
        - Responses
      summary: API Responses Kimi K3.1 Pro / Highspeed
      description: >-
        Définissez l’effort via reasoning.effort et le cache via
        prompt_cache_options. La recherche apparaît dans des éléments
        web_search_call. En streaming, traitez response.completed /
        response.incomplete / response.failed ; la limite de sortie produit
        incomplete. Incluez tout l’historique output dans les requêtes
        multi-tours, raisonnement, appels d’outils et résultats compris.
      operationId: createResponseKimiK31Pro
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponsesRequest'
            examples:
              simple:
                summary: Requête Pro minimale
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              highspeed:
                summary: Requête Highspeed minimale
                value:
                  model: kimi-k3.1-pro-highspeed
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              streaming:
                summary: Streaming SSE Responses
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  stream: true
              cache_1h:
                summary: Écriture automatique en cache 1h
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  prompt_cache_options:
                    mode: implicit
                    ttl: 1h
              web_search:
                summary: Recherche web côté serveur
                value:
                  model: kimi-k3.1-pro
                  input: Use web search to find the official Kimi homepage URL.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  tools:
                    - type: web_search
              structured_output:
                summary: JSON Schema strict
                value:
                  model: kimi-k3.1-pro
                  input: Return a JSON object with result equal to OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  text:
                    format:
                      type: json_schema
                      name: result
                      strict: true
                      schema:
                        type: object
                        properties:
                          result:
                            type: string
                        required:
                          - result
                        additionalProperties: false
      responses:
        '200':
          description: Réponse créée avec succès
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesResponse'
            text/event-stream:
              schema:
                $ref: '#/components/schemas/ResponsesStreamEvent'
        '400':
          description: Requête incorrecte - paramètres invalides
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Non autorisé - clé API invalide ou absente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Accès à cette ressource interdit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Limite de débit dépassée ou quota insuffisant
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Erreur serveur
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    ResponsesRequest:
      type: object
      required:
        - model
        - input
      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.
        input:
          description: >-
            Entrée de la requête. Une chaîne équivaut à un message user. Un
            tableau contient des éléments typés dans l’ordre, dont l’historique,
            les appels d’outils et leurs résultats.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputItem'
        instructions:
          type: string
          description: >-
            Instructions système au premier niveau, placées avant toutes les
            autres instructions.
        stream:
          type: boolean
          default: false
          description: Si true, renvoie la réponse sous forme de flux SSE.
        max_output_tokens:
          type: integer
          description: >-
            Nombre maximal de tokens générés, raisonnement et réponse finale
            inclus. Par défaut : 131072 ; maximum : 1048576, dans la limite du
            contexte restant.
          minimum: 1
          maximum: 1048576
          default: 131072
        reasoning:
          type: object
          description: Configuration du raisonnement.
          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.
        text:
          type: object
          description: Configuration du texte de sortie.
          properties:
            format:
              type: object
              required:
                - type
                - schema
              description: Contraindre la structure de sortie avec JSON Schema.
              properties:
                type:
                  type: string
                  enum:
                    - json_schema
                name:
                  type: string
                  description: Nom du schéma ; par défaut `output`.
                schema:
                  type: object
                  description: JSON Schema décrivant la structure de sortie.
                strict:
                  type: boolean
                  description: Appliquer strictement le schéma ou non.
        tools:
          type: array
          description: Outils que le modèle peut appeler.
          items:
            $ref: '#/components/schemas/ResponsesTool'
        tool_choice:
          $ref: '#/components/schemas/ResponsesToolChoice'
        include:
          type: array
          items:
            type: string
            enum:
              - web_search_call.results
              - web_search_call.action.sources
          description: >-
            Champs supplémentaires, uniquement pour `web_search`.
            `web_search_call.action.sources` renvoie les sources web trouvées ;
            `web_search_call.results`, les résultats d’images.
        prompt_cache_options:
          type: object
          description: >-
            Options d’écriture du cache de contexte. Sans ce champ, écriture
            automatique dans le cache 5m. Lectures et écritures sont facturées
            séparément.
          properties:
            mode:
              type: string
              enum:
                - implicit
              default: implicit
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              default: 5m
              description: 'TTL du cache : 5m ou 1h ; par défaut : 5m.'
    ResponsesResponse:
      type: object
      description: Une réponse du modèle.
      properties:
        id:
          type: string
          description: Identifiant unique de la réponse.
          example: resp_68f0c1c2d3e4f5a6b7c8d9e0
        object:
          type: string
          enum:
            - response
        created_at:
          type: integer
          description: Horodatage Unix de création de la réponse.
        completed_at:
          type:
            - integer
            - 'null'
          description: >-
            Horodatage Unix de fin de réponse. Présent lorsque `status` vaut
            `completed` ou `incomplete` ; `null` pour `in_progress` ou `failed`.
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
            - failed
          description: >-
            État de la réponse. L’instantané initial du streaming est
            `in_progress`.
        model:
          type: string
          description: Modèle ayant généré cette réponse.
        output:
          type: array
          description: >-
            Tableau des éléments de sortie dans l’ordre : web_search_call (si
            présent), reasoning, message, appels d’outils.
          items:
            $ref: '#/components/schemas/ResponsesOutputItem'
        usage:
          oneOf:
            - $ref: '#/components/schemas/ResponsesUsage'
            - type: 'null'
        incomplete_details:
          type:
            - object
            - 'null'
          description: Motif fourni lorsque `status` vaut `incomplete`.
          properties:
            reason:
              type: string
              enum:
                - max_output_tokens
                - content_filter
        error:
          type:
            - object
            - 'null'
          description: Détails de l’erreur lorsque `status` vaut `failed`.
          properties:
            code:
              type: string
            message:
              type: string
        instructions:
          type:
            - string
            - 'null'
        reasoning:
          type:
            - object
            - 'null'
        text:
          type:
            - object
            - 'null'
        tools:
          type:
            - array
            - 'null'
          items:
            $ref: '#/components/schemas/ResponsesTool'
        tool_choice:
          oneOf:
            - $ref: '#/components/schemas/ResponsesToolChoice'
            - type: 'null'
        max_output_tokens:
          type:
            - integer
            - 'null'
        temperature:
          type:
            - number
            - 'null'
        top_p:
          type:
            - number
            - 'null'
        parallel_tool_calls:
          type: boolean
        service_tier:
          type:
            - string
            - 'null'
        store:
          type: boolean
          description: Toujours `false`.
        background:
          type:
            - boolean
            - 'null'
          description: Toujours `false`.
        previous_response_id:
          type:
            - string
            - 'null'
          description: Toujours `null`.
        conversation:
          type:
            - object
            - 'null'
          description: Toujours `null`.
        prompt_cache_options:
          type: object
          description: >-
            Options d’écriture du cache de contexte réellement appliquées par le
            serveur. Si prompt_cache_options est absent, utilisez les valeurs
            mode et ttl renvoyées ici.
          properties:
            mode:
              type: string
              enum:
                - implicit
              description: Mode d’écriture réellement appliqué.
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              description: TTL du cache réellement appliqué.
    ResponsesStreamEvent:
      type: object
      description: >-
        Un événement SSE lorsque `stream: true`. Chaque trame contient `event:
        <type>` et `data: <json>` ; les autres champs dépendent de `type`.
      required:
        - type
        - sequence_number
      properties:
        type:
          type: string
          enum:
            - response.created
            - response.in_progress
            - response.output_item.added
            - response.output_item.done
            - response.content_part.added
            - response.content_part.done
            - response.output_text.delta
            - response.output_text.done
            - response.reasoning_summary_part.added
            - response.reasoning_summary_part.done
            - response.reasoning_summary_text.delta
            - response.reasoning_summary_text.done
            - response.function_call_arguments.delta
            - response.function_call_arguments.done
            - response.custom_tool_call_input.delta
            - response.custom_tool_call_input.done
            - response.web_search_call.in_progress
            - response.web_search_call.searching
            - response.web_search_call.completed
            - response.completed
            - response.incomplete
            - response.failed
            - error
        sequence_number:
          type: integer
          description: Numéro de séquence d’événement, croissant à partir de 0.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Message expliquant la cause de l’erreur.
            type:
              type: string
              description: Type d'erreur
            code:
              type: string
              description: Code d’erreur
          required:
            - message
      required:
        - error
    ResponsesInputItem:
      description: >-
        Élément du tableau input, identifié par `type`. Sans `type`, traité
        comme `message`.
      oneOf:
        - $ref: '#/components/schemas/ResponsesMessageItem'
        - $ref: '#/components/schemas/ResponsesReasoningItem'
        - $ref: '#/components/schemas/ResponsesFunctionCallItem'
        - $ref: '#/components/schemas/ResponsesFunctionCallOutputItem'
        - $ref: '#/components/schemas/ResponsesCustomToolCallItem'
        - $ref: '#/components/schemas/ResponsesCustomToolCallOutputItem'
        - $ref: '#/components/schemas/ResponsesWebSearchCallItem'
        - $ref: '#/components/schemas/ResponsesAdditionalToolsItem'
    ResponsesTool:
      description: >-
        Définition d’outil identifiée par `type`. Accepte `function`, `custom`
        (uniquement `apply_patch`), `namespace` et `web_search` ; les autres
        types ne sont pas pris en charge.
      oneOf:
        - $ref: '#/components/schemas/ResponsesFunctionTool'
        - $ref: '#/components/schemas/ResponsesCustomTool'
        - $ref: '#/components/schemas/ResponsesNamespaceTool'
        - $ref: '#/components/schemas/ResponsesWebSearchTool'
      discriminator:
        propertyName: type
        mapping:
          function: '#/components/schemas/ResponsesFunctionTool'
          custom: '#/components/schemas/ResponsesCustomTool'
          namespace: '#/components/schemas/ResponsesNamespaceTool'
          web_search: '#/components/schemas/ResponsesWebSearchTool'
    ResponsesToolChoice:
      type: string
      enum:
        - auto
      description: >-
        Contrôle les appels d’outils. Avec `auto`, le modèle décide d’appeler ou
        non un outil.
    ResponsesOutputItem:
      description: Élément du tableau output, identifié par `type`.
      oneOf:
        - $ref: '#/components/schemas/ResponsesOutputReasoningItem'
        - $ref: '#/components/schemas/ResponsesOutputMessageItem'
        - $ref: '#/components/schemas/ResponsesOutputFunctionCallItem'
        - $ref: '#/components/schemas/ResponsesOutputCustomToolCallItem'
        - $ref: '#/components/schemas/ResponsesOutputWebSearchCallItem'
      discriminator:
        propertyName: type
        mapping:
          reasoning: '#/components/schemas/ResponsesOutputReasoningItem'
          message: '#/components/schemas/ResponsesOutputMessageItem'
          function_call: '#/components/schemas/ResponsesOutputFunctionCallItem'
          custom_tool_call: '#/components/schemas/ResponsesOutputCustomToolCallItem'
          web_search_call: '#/components/schemas/ResponsesOutputWebSearchCallItem'
    ResponsesUsage:
      type: object
      description: >-
        input_tokens inclut les lectures et écritures du cache ; soustrayez
        cached_tokens et cache_write_tokens pour obtenir l’entrée ordinaire.
        output_tokens inclut déjà le raisonnement.
      properties:
        input_tokens:
          type: integer
          description: Nombre de tokens d’entrée, cache utilisé inclus.
        input_tokens_details:
          type: object
          properties:
            cached_tokens:
              type: integer
              description: Tokens lus dans le cache de contexte.
            cache_write_tokens:
              type: integer
              description: Tokens écrits dans le cache de contexte.
        output_tokens:
          type: integer
          description: Nombre de tokens de sortie, raisonnement inclus.
        output_tokens_details:
          type: object
          properties:
            reasoning_tokens:
              type: integer
              description: Tokens utilisés pour le raisonnement.
        total_tokens:
          type: integer
          description: Nombre total de tokens.
    ResponsesMessageItem:
      type: object
      title: Message
      description: Un message de conversation. `type` peut être omis.
      required:
        - role
        - content
      properties:
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - user
            - assistant
            - developer
          description: >-
            Rôle du message. `developer` est traité comme des instructions
            système.
        content:
          description: Contenu du message, chaîne ou tableau de parties de contenu.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesReasoningItem:
      type: object
      title: Raisonnement
      description: >-
        Rejouer le raisonnement du tour précédent. `content` est prioritaire sur
        `summary`.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - reasoning
        id:
          type: string
        summary:
          type: array
          items:
            type: object
            required:
              - type
              - text
            properties:
              type:
                type: string
                enum:
                  - summary_text
              text:
                type: string
        content:
          type: array
          items:
            type: object
            required:
              - type
              - text
            properties:
              type:
                type: string
                enum:
                  - reasoning_text
              text:
                type: string
        status:
          type: string
          enum:
            - completed
    ResponsesFunctionCallItem:
      type: object
      title: Function Call
      description: Rejouer un appel de fonction.
      required:
        - type
        - call_id
        - name
        - arguments
      properties:
        type:
          type: string
          enum:
            - function_call
        id:
          type: string
        call_id:
          type: string
          description: ID d’appel associé au `function_call_output` correspondant.
        name:
          type: string
        namespace:
          type: string
          description: >-
            Espace de noms de l’outil, renvoyé pour les appels d’outils avec
            espace de noms.
        arguments:
          type: string
          description: Arguments de la fonction sous forme de chaîne JSON.
        status:
          type: string
          enum:
            - completed
    ResponsesFunctionCallOutputItem:
      type: object
      title: Résultat d’appel de fonction
      description: Résultat d’exécution d’un appel de fonction.
      required:
        - type
        - call_id
        - output
      properties:
        type:
          type: string
          enum:
            - function_call_output
        call_id:
          type: string
          description: Même ID d’appel que le `function_call` correspondant.
        output:
          description: Contenu renvoyé par l’outil.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesCustomToolCallItem:
      type: object
      title: Appel d’outil personnalisé
      description: Rejouer un appel d’outil personnalisé.
      required:
        - type
        - call_id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - custom_tool_call
        id:
          type: string
        call_id:
          type: string
          description: ID d’appel associé au `custom_tool_call_output` correspondant.
        name:
          type: string
        namespace:
          type: string
          description: >-
            Espace de noms de l’outil, renvoyé pour les appels d’outils avec
            espace de noms.
        input:
          type: string
          description: Entrée en texte libre générée par le modèle.
        status:
          type: string
          enum:
            - completed
    ResponsesCustomToolCallOutputItem:
      type: object
      title: Résultat d’appel d’outil personnalisé
      description: Résultat d’exécution d’un appel d’outil personnalisé.
      required:
        - type
        - call_id
        - output
      properties:
        type:
          type: string
          enum:
            - custom_tool_call_output
        call_id:
          type: string
          description: Même ID d’appel que le `custom_tool_call` correspondant.
        output:
          description: Contenu renvoyé par l’outil.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesWebSearchCallItem:
      type: object
      title: Appel de recherche web
      description: Recherche web d’un tour précédent, à inclure avec l’historique complet.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - web_search_call
        id:
          type: string
        status:
          type: string
          enum:
            - completed
        action:
          type: object
          properties:
            type:
              type: string
              enum:
                - search
            query:
              type: string
    ResponsesAdditionalToolsItem:
      type: object
      title: Outils dynamiques
      description: >-
        Ajouter des outils pendant la conversation, disponibles à partir de cet
        élément.
      required:
        - type
        - role
        - tools
      properties:
        type:
          type: string
          enum:
            - additional_tools
        id:
          type: string
        role:
          type: string
          enum:
            - developer
        tools:
          type: array
          items:
            $ref: '#/components/schemas/ResponsesTool'
    ResponsesFunctionTool:
      type: object
      title: Outil de fonction
      description: Outil de fonction dont les paramètres sont décrits par JSON Schema.
      required:
        - type
        - name
      properties:
        type:
          type: string
          enum:
            - function
        name:
          type: string
          description: 'Nom de fonction. Doit respecter : ^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$'
          pattern: ^[a-zA-Z_][a-zA-Z0-9-_]{0,127}$
        description:
          type: string
        parameters:
          type: object
          description: JSON Schema décrivant les paramètres de la fonction.
        strict:
          type: boolean
    ResponsesCustomTool:
      type: object
      title: Outil personnalisé
      description: >-
        Outil personnalisé acceptant du texte libre. Seul `apply_patch` est pris
        en charge, avec une définition de format `grammar` + `lark` obligatoire.
        Les appels apparaissent sous forme d’éléments `custom_tool_call` dans
        output.
      required:
        - type
        - name
        - format
      properties:
        type:
          type: string
          enum:
            - custom
        name:
          type: string
          enum:
            - apply_patch
          description: Nom de l’outil ; seul `apply_patch` est pris en charge.
        description:
          type: string
        format:
          type: object
          description: >-
            Contraintes de format d’entrée. Seuls le type `grammar` et la
            syntaxe `lark` sont pris en charge.
          required:
            - type
            - syntax
            - definition
          properties:
            type:
              type: string
              enum:
                - grammar
            syntax:
              type: string
              enum:
                - lark
            definition:
              type: string
              description: Définition de grammaire Lark.
    ResponsesNamespaceTool:
      type: object
      title: Outil d’espace de noms
      description: >-
        Regrouper des outils de fonction ou personnalisés dans un même espace de
        noms.
      required:
        - type
        - name
        - description
        - tools
      properties:
        type:
          type: string
          enum:
            - namespace
        name:
          type: string
        description:
          type: string
        tools:
          type: array
          items:
            oneOf:
              - $ref: '#/components/schemas/ResponsesFunctionTool'
              - $ref: '#/components/schemas/ResponsesCustomTool'
    ResponsesWebSearchTool:
      type: object
      title: Outil de recherche web
      description: >-
        Outil de recherche web appelé lorsque le modèle a besoin d’informations
        en ligne. Les recherches apparaissent sous forme de web_search_call. Au
        plus un outil par requête.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - web_search
        filters:
          type: object
          description: Filtres du périmètre de recherche.
          properties:
            allowed_domains:
              type: array
              items:
                type: string
              maxItems: 100
              description: Rechercher uniquement sur ces domaines, au plus 100.
        search_content_types:
          type: array
          items:
            type: string
            enum:
              - text
              - image
          default:
            - text
          description: >-
            Types de contenu recherchés ; `text` seul par défaut. Ajouter
            `image` lance aussi une recherche d’images.
        image_settings:
          type: object
          description: >-
            Paramètres de recherche d’images, actifs uniquement si
            `search_content_types` contient `image`.
          properties:
            max_results:
              type: integer
              minimum: 1
              maximum: 10
              default: 3
              description: Nombre maximal d’images renvoyées.
            caption:
              type: boolean
              default: false
              description: Générer ou non des légendes pour les images.
    ResponsesOutputReasoningItem:
      type: object
      title: Raisonnement
      description: Contenu du raisonnement du modèle.
      properties:
        type:
          type: string
          enum:
            - reasoning
        id:
          type: string
          example: rs_68f0c1c2d3e4f5a6b7c8d9e0
        summary:
          type: array
          description: Contenu du raisonnement.
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - summary_text
              text:
                type: string
        encrypted_content:
          type:
            - string
            - 'null'
          description: Toujours `null`.
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputMessageItem:
      type: object
      title: Message
      description: Réponse textuelle du modèle.
      properties:
        type:
          type: string
          enum:
            - message
        id:
          type: string
          example: msg_68f0c1c2d3e4f5a6b7c8d9e0
        role:
          type: string
          enum:
            - assistant
        content:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - output_text
              text:
                type: string
              annotations:
                type: array
                items: {}
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputFunctionCallItem:
      type: object
      title: Function Call
      description: Appel de fonction lancé par le modèle.
      properties:
        type:
          type: string
          enum:
            - function_call
        id:
          type: string
          example: fc_68f0c1c2d3e4f5a6b7c8d9e0
        call_id:
          type: string
          description: >-
            Utilisez cette valeur dans `function_call_output` pour renvoyer le
            résultat.
        name:
          type: string
        namespace:
          type: string
          description: Renvoyé pour les appels d’outils avec espace de noms.
        arguments:
          type: string
          description: Arguments de la fonction sous forme de chaîne JSON.
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputCustomToolCallItem:
      type: object
      title: Appel d’outil personnalisé
      description: Appel d’outil personnalisé lancé par le modèle.
      properties:
        type:
          type: string
          enum:
            - custom_tool_call
        id:
          type: string
          example: ctc_68f0c1c2d3e4f5a6b7c8d9e0
        call_id:
          type: string
          description: >-
            Utilisez cette valeur dans `custom_tool_call_output` pour renvoyer
            le résultat.
        name:
          type: string
        namespace:
          type: string
          description: Renvoyé pour les appels d’outils avec espace de noms.
        input:
          type: string
          description: Entrée en texte libre générée par le modèle.
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputWebSearchCallItem:
      type: object
      title: Appel de recherche web
      description: >-
        Appel de recherche web exécuté côté serveur. Renvoyé si la requête
        contient `web_search` et si le serveur décide de chercher ; placé au
        début du tableau output.
      properties:
        type:
          type: string
          enum:
            - web_search_call
        id:
          type: string
          example: ws_68f0c1c2d3e4f5a6b7c8d9e0
        status:
          type: string
          enum:
            - in_progress
            - completed
        action:
          type: object
          description: Action de cette recherche.
          properties:
            type:
              type: string
              enum:
                - search
            query:
              type: string
              description: Requête de recherche réellement utilisée.
            sources:
              type: array
              description: >-
                Sources web trouvées. Renvoyées seulement si `include` contient
                `web_search_call.action.sources`.
              items:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - url
                  url:
                    type: string
                  title:
                    type: string
        results:
          type: array
          description: >-
            Résultats de recherche d’images. Renvoyés seulement si `include`
            contient `web_search_call.results` et `search_content_types`
            contient `image`.
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - image_result
              image_url:
                type: string
              thumbnail_url:
                type: string
              source_website_url:
                type: string
              caption:
                type: string
                description: >-
                  Légende d’image, renvoyée uniquement si
                  `image_settings.caption` est activé.
    ResponsesInputContentPart:
      description: Élément du tableau content, identifié par `type`.
      oneOf:
        - type: object
          title: Texte d’entrée
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - input_text
            text:
              type: string
        - type: object
          title: Image d’entrée
          required:
            - type
            - image_url
          properties:
            type:
              type: string
              enum:
                - input_image
            image_url:
              type: string
              description: >-
                URL data d’image, par exemple `data:image/png;base64,<base64>`.
                Les URL http(s) publiques ne sont pas prises en charge.
            detail:
              type: string
              enum:
                - auto
                - low
                - high
                - original
        - type: object
          title: Texte de sortie
          description: Pour rejouer l’historique textuel de l’assistant.
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - output_text
            text:
              type: string
  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.