> ## 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 (todos los modelos) - Responses: Referencia completa

> Configure el esfuerzo con reasoning.effort y la caché con prompt_cache_options. La búsqueda aparece como elementos web_search_call. En streaming, gestione response.completed / response.incomplete / response.failed; alcanzar el límite de salida produce incomplete. Incluya todo el historial output en solicitudes de varios turnos, con razonamiento, herramientas y resultados.

> [!NOTE]
>
> **BaseURL**: La BaseURL predeterminada es `https://direct.evolink.ai`, que ofrece mejor compatibilidad con los modelos de texto y las conexiones de larga duración. `https://api.evolink.ai` es el endpoint principal para los servicios multimodales y sirve como dirección de respaldo para los modelos de texto.


## OpenAPI

````yaml es/api-manual/language-series/kimi/responses/responses-reference.json POST /v1/responses
openapi: 3.1.0
info:
  title: 'API Kimi (todos los modelos) - Responses: Referencia completa'
  version: 1.0.0
  description: >-
    Llama a los modelos de texto Kimi mediante el protocolo OpenAI Responses.
    Usa `model` para seleccionar `kimi-k3.1-pro`, `kimi-k3.1-pro-highspeed` o
    `kimi-k3`. Todos tienen una ventana de contexto de 1.048.576 tokens y
    admiten conversaciones de varios turnos, streaming, llamadas a herramientas,
    búsqueda web, salida estructurada e imágenes de entrada.


    El razonamiento siempre está activado en los tres modelos; ajusta su
    intensidad con `reasoning.effort`. La salida estructurada y el TTL de
    escritura de caché varían según el modelo; consulta el campo `model`.
    Conserva el historial completo de razonamiento y llamadas a herramientas en
    conversaciones de varios turnos.
servers:
  - url: https://direct.evolink.ai
    description: Producción (Recomendado)
  - url: https://api.evolink.ai
    description: URL alternativa
security:
  - bearerAuth: []
paths:
  /v1/responses:
    post:
      tags:
        - Responses
      summary: API Kimi Responses (todos los modelos)
      description: >-
        Configure el esfuerzo con reasoning.effort y la caché con
        prompt_cache_options. La búsqueda aparece como elementos
        web_search_call. En streaming, gestione response.completed /
        response.incomplete / response.failed; alcanzar el límite de salida
        produce incomplete. Incluya todo el historial output en solicitudes de
        varios turnos, con razonamiento, herramientas y resultados.
      operationId: createResponseKimi
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponsesRequest'
            examples:
              simple:
                summary: Solicitud mínima de Pro
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              highspeed:
                summary: Solicitud mínima de Highspeed
                value:
                  model: kimi-k3.1-pro-highspeed
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              k3:
                summary: Solicitud mínima de Kimi K3
                value:
                  model: kimi-k3
                  input: Reply with OK.
                  max_output_tokens: 1024
              streaming:
                summary: Streaming SSE de Responses
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  stream: true
              multimodal:
                summary: Imagen de entrada
                value:
                  model: kimi-k3.1-pro
                  input:
                    - role: user
                      content:
                        - type: input_image
                          image_url: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA...
                        - type: input_text
                          text: Describe esta imagen.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
              function_calling:
                summary: Function Call
                value:
                  model: kimi-k3.1-pro
                  input: Consulta el tiempo de hoy en Pekín.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  tools:
                    - type: function
                      name: get_weather
                      description: Consultar el tiempo de una ciudad determinada
                      parameters:
                        type: object
                        properties:
                          city:
                            type: string
                            description: Nombre de la ciudad
                        required:
                          - city
              web_search:
                summary: Búsqueda web del lado del servidor
                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 estricto (solo serie K3.1)
                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
              cache_1h:
                summary: Escritura automática en caché de 1h (solo serie K3.1)
                value:
                  model: kimi-k3.1-pro
                  input: Reply with OK.
                  reasoning:
                    effort: low
                  max_output_tokens: 1024
                  prompt_cache_options:
                    mode: implicit
                    ttl: 1h
      responses:
        '200':
          description: Respuesta creada correctamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesResponse'
            text/event-stream:
              schema:
                $ref: '#/components/schemas/ResponsesStreamEvent'
        '400':
          description: 'Solicitud incorrecta: parámetros no válidos'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: 'No autorizado: clave API no válida o ausente'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Acceso a este recurso denegado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Límite de solicitudes superado o cuota insuficiente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Error del servidor
          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
            - kimi-k3
          default: kimi-k3.1-pro
          description: >-
            Modelo que se va a llamar:


            | ID del modelo | Características | Esfuerzo de razonamiento |

            |---|---|---|

            | `kimi-k3.1-pro` | Última generación (recomendado) | `low` / `high`
            / `max`, `max` de forma predeterminada |

            | `kimi-k3.1-pro-highspeed` | Mismos parámetros que Pro, generación
            más rápida | Igual que `kimi-k3.1-pro` |

            | `kimi-k3` | Generación anterior | Solo `max` |


            Los tres modelos tienen una ventana de contexto de 1.048.576 tokens
            y el razonamiento siempre activado.


            La salida estructurada (`text.format`) y el TTL de escritura de
            caché (`prompt_cache_options`) solo son compatibles con la serie
            K3.1, no con `kimi-k3`.
        input:
          description: >-
            Entrada de la solicitud. Una cadena equivale a un mensaje user. Un
            array contiene elementos tipados en orden, incluidos el historial,
            las llamadas a herramientas y sus resultados.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputItem'
        instructions:
          type: string
          description: >-
            Instrucciones de sistema de nivel superior, aplicadas antes que las
            demás.
        stream:
          type: boolean
          default: false
          description: Si es true, devuelve la respuesta como un flujo SSE.
        max_output_tokens:
          type: integer
          description: >-
            Máximo de tokens generados, incluidos el razonamiento y la respuesta
            final. Valor predeterminado: 131072; máximo: 1048576, limitado
            también por el contexto restante.
          minimum: 1
          maximum: 1048576
          default: 131072
        reasoning:
          type: object
          description: Configuración de razonamiento.
          properties:
            effort:
              type: string
              enum:
                - low
                - high
                - max
                - medium
                - xhigh
                - minimal
                - none
              default: max
              description: >-
                Esfuerzo de razonamiento. El razonamiento siempre está activado.


                - `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed`: se recomiendan
                `low` / `high` / `max`; el valor predeterminado es `max`. Por
                compatibilidad con clientes genéricos, `medium` equivale a
                `high`, `xhigh` a `max` y `minimal` / `none` a `low`; `none` no
                desactiva el razonamiento.

                - `kimi-k3`: solo se admite `max` (predeterminado).


                Un esfuerzo mayor suele aumentar los tokens de razonamiento y la
                latencia. Los tokens de razonamiento se incluyen en la salida.
        text:
          type: object
          description: Configuración del texto de salida.
          properties:
            format:
              type: object
              required:
                - type
                - schema
              description: >-
                Limita la estructura de salida con JSON Schema. Solo es
                compatible con `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed`, no
                con `kimi-k3`. Para obtener salida estructurada con `kimi-k3`,
                usa `response_format` de la API Chat Completions.
              properties:
                type:
                  type: string
                  enum:
                    - json_schema
                name:
                  type: string
                  description: Nombre del esquema; por defecto `output`.
                schema:
                  type: object
                  description: JSON Schema que describe la estructura de salida.
                strict:
                  type: boolean
                  description: Si se debe exigir el esquema estrictamente.
        tools:
          type: array
          description: Herramientas que el modelo puede llamar.
          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: >-
            Campos adicionales, solo para `web_search`.
            `web_search_call.action.sources` devuelve fuentes web encontradas y
            `web_search_call.results`, resultados de imágenes.
        prompt_cache_options:
          type: object
          description: >-
            Opciones de escritura de la caché de contexto, compatibles solo con
            `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed`; `kimi-k3` no admite
            este parámetro. Si se omite, se escribe automáticamente una caché de
            5m de forma predeterminada. Las escrituras y las lecturas se
            facturan por separado.
          properties:
            mode:
              type: string
              enum:
                - implicit
              default: implicit
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              default: 5m
              description: 'TTL de caché: 5m o 1h; predeterminado: 5m.'
        temperature:
          type: number
          default: 1
          description: >-
            Temperatura de muestreo, fijada por el modelo en `1`; no es
            necesario enviar este campo. `kimi-k3.1-pro` /
            `kimi-k3.1-pro-highspeed` lo ignoran automáticamente; `kimi-k3`
            devuelve un error para valores no admitidos.
        top_p:
          type: number
          default: 0.95
          description: >-
            Umbral de muestreo nucleus, fijado por el modelo en `0.95`; no es
            necesario enviar este campo. `kimi-k3.1-pro` /
            `kimi-k3.1-pro-highspeed` lo ignoran automáticamente; `kimi-k3`
            devuelve un error para valores no admitidos.
    ResponsesResponse:
      type: object
      description: Una respuesta del modelo.
      properties:
        id:
          type: string
          description: Identificador único de la respuesta.
          example: resp_68f0c1c2d3e4f5a6b7c8d9e0
        object:
          type: string
          enum:
            - response
        created_at:
          type: integer
          description: Marca de tiempo Unix de creación de la respuesta.
        completed_at:
          type:
            - integer
            - 'null'
          description: >-
            Marca de tiempo Unix de finalización. Presente cuando `status` es
            `completed` o `incomplete`; `null` para `in_progress` o `failed`.
        status:
          type: string
          enum:
            - in_progress
            - completed
            - incomplete
            - failed
          description: >-
            Estado de la respuesta. La instantánea inicial del streaming tiene
            estado `in_progress`.
        model:
          type: string
          description: Modelo que generó esta respuesta.
        output:
          type: array
          description: >-
            Array de salida en este orden: web_search_call (si existe),
            reasoning, message y llamadas a herramientas.
          items:
            $ref: '#/components/schemas/ResponsesOutputItem'
        usage:
          oneOf:
            - $ref: '#/components/schemas/ResponsesUsage'
            - type: 'null'
        incomplete_details:
          type:
            - object
            - 'null'
          description: Motivo cuando `status` es `incomplete`.
          properties:
            reason:
              type: string
              enum:
                - max_output_tokens
                - content_filter
        error:
          type:
            - object
            - 'null'
          description: Detalles del error cuando `status` es `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: Siempre `false`.
        background:
          type:
            - boolean
            - 'null'
          description: Siempre `false`.
        previous_response_id:
          type:
            - string
            - 'null'
          description: Siempre `null`.
        conversation:
          type:
            - object
            - 'null'
          description: Siempre `null`.
        prompt_cache_options:
          type: object
          description: >-
            Opciones de escritura de caché de contexto aplicadas por el
            servidor. Si se omitió prompt_cache_options, use los valores mode y
            ttl devueltos aquí.
          properties:
            mode:
              type: string
              enum:
                - implicit
              description: Modo de escritura aplicado.
            ttl:
              type: string
              enum:
                - 5m
                - 1h
              description: TTL de caché aplicado.
    ResponsesStreamEvent:
      type: object
      description: >-
        Un evento SSE cuando `stream: true`. Cada trama contiene `event: <type>`
        y `data: <json>`; los demás campos dependen 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: Número de secuencia del evento, creciente desde 0.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Mensaje que explica la causa del error.
            type:
              type: string
              description: Tipo de error
            code:
              type: string
              description: Código de error
          required:
            - message
      required:
        - error
    ResponsesInputItem:
      description: >-
        Elemento del array input, distinguido por `type`. Si se omite `type`, se
        trata como `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: >-
        Definición de herramienta por `type`. Admite `function`, `custom` (solo
        `apply_patch`), `namespace` y `web_search`; no admite otros tipos.
      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: >-
        Controla las herramientas. Con `auto`, el modelo decide si llama a una
        herramienta.
    ResponsesOutputItem:
      description: Elemento del array output, distinguido por `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 incluye lecturas y escrituras de caché. Para obtener la
        entrada normal de la serie K3.1, resta cached_tokens y
        cache_write_tokens; para `kimi-k3`, resta solo cached_tokens.
        output_tokens ya incluye el razonamiento.
      properties:
        input_tokens:
          type: integer
          description: Tokens de entrada, incluidos los aciertos de caché.
        input_tokens_details:
          type: object
          properties:
            cached_tokens:
              type: integer
              description: Tokens leídos de la caché de contexto.
            cache_write_tokens:
              type: integer
              description: Tokens escritos en la caché de contexto.
        output_tokens:
          type: integer
          description: Tokens de salida, incluidos los de razonamiento.
        output_tokens_details:
          type: object
          properties:
            reasoning_tokens:
              type: integer
              description: Tokens utilizados para el razonamiento.
        total_tokens:
          type: integer
          description: Número total de tokens.
    ResponsesMessageItem:
      type: object
      title: Mensaje
      description: Un mensaje de conversación. Se puede omitir `type`.
      required:
        - role
        - content
      properties:
        type:
          type: string
          enum:
            - message
        role:
          type: string
          enum:
            - user
            - assistant
            - developer
          description: Rol del mensaje. `developer` se trata como instrucciones de sistema.
        content:
          description: Contenido del mensaje como cadena o array de partes de contenido.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesReasoningItem:
      type: object
      title: Razonamiento
      description: >-
        Reproduce el razonamiento del turno anterior. `content` tiene prioridad
        sobre `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: Reproduce una llamada a función.
      required:
        - type
        - call_id
        - name
        - arguments
      properties:
        type:
          type: string
          enum:
            - function_call
        id:
          type: string
        call_id:
          type: string
          description: ID de llamada asociado al `function_call_output` correspondiente.
        name:
          type: string
        namespace:
          type: string
          description: >-
            Espacio de nombres de la herramienta, devuelto en llamadas a
            herramientas de ese tipo.
        arguments:
          type: string
          description: Argumentos de la función como cadena JSON.
        status:
          type: string
          enum:
            - completed
    ResponsesFunctionCallOutputItem:
      type: object
      title: Resultado de llamada a función
      description: Resultado de ejecución de una llamada a función.
      required:
        - type
        - call_id
        - output
      properties:
        type:
          type: string
          enum:
            - function_call_output
        call_id:
          type: string
          description: Mismo ID de llamada que el `function_call` correspondiente.
        output:
          description: Contenido devuelto por la herramienta.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesCustomToolCallItem:
      type: object
      title: Llamada a herramienta personalizada
      description: Reproduce una llamada a herramienta personalizada.
      required:
        - type
        - call_id
        - name
        - input
      properties:
        type:
          type: string
          enum:
            - custom_tool_call
        id:
          type: string
        call_id:
          type: string
          description: ID asociado al `custom_tool_call_output` correspondiente.
        name:
          type: string
        namespace:
          type: string
          description: >-
            Espacio de nombres de la herramienta, devuelto en llamadas a
            herramientas de ese tipo.
        input:
          type: string
          description: Entrada de texto libre generada por el modelo.
        status:
          type: string
          enum:
            - completed
    ResponsesCustomToolCallOutputItem:
      type: object
      title: Resultado de llamada a herramienta personalizada
      description: Resultado de ejecución de una herramienta personalizada.
      required:
        - type
        - call_id
        - output
      properties:
        type:
          type: string
          enum:
            - custom_tool_call_output
        call_id:
          type: string
          description: Mismo ID que el `custom_tool_call` correspondiente.
        output:
          description: Contenido devuelto por la herramienta.
          oneOf:
            - type: string
            - type: array
              items:
                $ref: '#/components/schemas/ResponsesInputContentPart'
        status:
          type: string
          enum:
            - completed
    ResponsesWebSearchCallItem:
      type: object
      title: Llamada de búsqueda web
      description: >-
        Registro de una búsqueda web anterior; inclúyalo con el historial
        completo.
      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: Herramientas dinámicas
      description: >-
        Añade herramientas durante la conversación, disponibles desde la
        posición de este elemento.
      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: Herramienta de función
      description: Herramienta de función con parámetros descritos mediante JSON Schema.
      required:
        - type
        - name
      properties:
        type:
          type: string
          enum:
            - function
        name:
          type: string
          description: >-
            Nombre de función. Debe coincidir con:
            ^[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 que describe los parámetros de la función.
        strict:
          type: boolean
    ResponsesCustomTool:
      type: object
      title: Herramienta personalizada
      description: >-
        Herramienta personalizada con entrada de texto libre. Solo se admite
        `apply_patch`, con definición de formato `grammar` + `lark` obligatoria.
        Las llamadas aparecen como elementos `custom_tool_call` en output.
      required:
        - type
        - name
        - format
      properties:
        type:
          type: string
          enum:
            - custom
        name:
          type: string
          enum:
            - apply_patch
          description: Nombre de herramienta; solo se admite `apply_patch`.
        description:
          type: string
        format:
          type: object
          description: >-
            Restricciones de entrada. Solo se admite el tipo `grammar` con
            sintaxis `lark`.
          required:
            - type
            - syntax
            - definition
          properties:
            type:
              type: string
              enum:
                - grammar
            syntax:
              type: string
              enum:
                - lark
            definition:
              type: string
              description: Definición de gramática Lark.
    ResponsesNamespaceTool:
      type: object
      title: Herramienta de espacio de nombres
      description: >-
        Agrupa herramientas de función o personalizadas en un mismo espacio de
        nombres.
      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: Herramienta de búsqueda web
      description: >-
        Herramienta de búsqueda web que el modelo llama cuando necesita
        información en línea. Las búsquedas aparecen como web_search_call.
        Declare como máximo una por solicitud.
      required:
        - type
      properties:
        type:
          type: string
          enum:
            - web_search
        filters:
          type: object
          description: Filtros de ámbito de búsqueda.
          properties:
            allowed_domains:
              type: array
              items:
                type: string
              maxItems: 100
              description: Buscar solo en estos dominios, hasta 100.
        search_content_types:
          type: array
          items:
            type: string
            enum:
              - text
              - image
          default:
            - text
          description: >-
            Tipos de contenido de búsqueda; solo `text` por defecto. Incluir
            `image` ejecuta también búsqueda de imágenes.
        image_settings:
          type: object
          description: >-
            Opciones de búsqueda de imágenes, solo si `search_content_types`
            incluye `image`.
          properties:
            max_results:
              type: integer
              minimum: 1
              maximum: 10
              default: 3
              description: Número máximo de imágenes devueltas.
            caption:
              type: boolean
              default: false
              description: Si se deben generar descripciones para las imágenes.
    ResponsesOutputReasoningItem:
      type: object
      title: Razonamiento
      description: Contenido del razonamiento del modelo.
      properties:
        type:
          type: string
          enum:
            - reasoning
        id:
          type: string
          example: rs_68f0c1c2d3e4f5a6b7c8d9e0
        summary:
          type: array
          description: Contenido del razonamiento.
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - summary_text
              text:
                type: string
        encrypted_content:
          type:
            - string
            - 'null'
          description: Siempre `null`.
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputMessageItem:
      type: object
      title: Mensaje
      description: Respuesta de texto del modelo.
      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: Llamada a función iniciada por el modelo.
      properties:
        type:
          type: string
          enum:
            - function_call
        id:
          type: string
          example: fc_68f0c1c2d3e4f5a6b7c8d9e0
        call_id:
          type: string
          description: Use este valor en `function_call_output` al devolver el resultado.
        name:
          type: string
        namespace:
          type: string
          description: Devuelto al llamar a herramientas de un espacio de nombres.
        arguments:
          type: string
          description: Argumentos de la función como cadena JSON.
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputCustomToolCallItem:
      type: object
      title: Llamada a herramienta personalizada
      description: Llamada a herramienta personalizada iniciada por el modelo.
      properties:
        type:
          type: string
          enum:
            - custom_tool_call
        id:
          type: string
          example: ctc_68f0c1c2d3e4f5a6b7c8d9e0
        call_id:
          type: string
          description: >-
            Use este valor en `custom_tool_call_output` al devolver el
            resultado.
        name:
          type: string
        namespace:
          type: string
          description: Devuelto al llamar a herramientas de un espacio de nombres.
        input:
          type: string
          description: Entrada de texto libre generada por el modelo.
        status:
          type: string
          enum:
            - in_progress
            - completed
    ResponsesOutputWebSearchCallItem:
      type: object
      title: Llamada de búsqueda web
      description: >-
        Búsqueda web ejecutada por el servidor. Solo se devuelve si la solicitud
        incluye `web_search` y el servidor decide buscar; aparece al inicio de
        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: Acción realizada en esta búsqueda.
          properties:
            type:
              type: string
              enum:
                - search
            query:
              type: string
              description: Consulta de búsqueda utilizada.
            sources:
              type: array
              description: >-
                Fuentes web encontradas. Solo se devuelven si `include` contiene
                `web_search_call.action.sources`.
              items:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - url
                  url:
                    type: string
                  title:
                    type: string
        results:
          type: array
          description: >-
            Resultados de imágenes. Solo se devuelven si `include` contiene
            `web_search_call.results` y `search_content_types` incluye `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: >-
                  Descripción de imagen, solo si `image_settings.caption` está
                  activado.
    ResponsesInputContentPart:
      description: Elemento del array content, distinguido por `type`.
      oneOf:
        - type: object
          title: Texto de entrada
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - input_text
            text:
              type: string
        - type: object
          title: Imagen de entrada
          required:
            - type
            - image_url
          properties:
            type:
              type: string
              enum:
                - input_image
            image_url:
              type: string
              description: >-
                URL data de imagen, como `data:image/png;base64,<base64>`. No se
                admiten URL http(s) públicas.
            detail:
              type: string
              enum:
                - auto
                - low
                - high
                - original
        - type: object
          title: Texto de salida
          description: Se usa para reproducir el historial de texto del assistant.
          required:
            - type
            - text
          properties:
            type:
              type: string
              enum:
                - output_text
            text:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ##Todas las API requieren autenticación con Bearer Token##


        **Obtener la API Key:**


        Visita la [página de gestión de API
        Keys](https://evolink.ai/dashboard/keys) para obtener tu API Key


        **Añadir al encabezado de la solicitud:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````

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