> ## 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) - Messages: Inicio rápido

> - Llama a los modelos Kimi mediante el protocolo Anthropic Messages y selecciona el modelo con `model`
- Solo se requieren `model`, `max_tokens` y `messages` (`max_tokens` es obligatorio en el protocolo Anthropic)
- Los tres modelos tienen una ventana de contexto de 1.048.576 tokens
- El razonamiento siempre está activado en los tres modelos; ajusta su intensidad con `output_config.effort`
- Para llamadas a herramientas, búsqueda web, imágenes de entrada, salida estructurada o ajustes de caché, consulta la [referencia completa](/es/api-manual/language-series/kimi/messages/messages-reference)

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

> [!NOTE]
>
> **El razonamiento siempre está activado en los modelos Kimi**. El campo `content` suele incluir bloques `type="thinking"`, que cuentan como tokens de salida. Evita un valor demasiado bajo para `max_tokens`: el razonamiento podría agotar el presupuesto antes de producir el texto de respuesta.


## OpenAPI

````yaml es/api-manual/language-series/kimi/messages/messages-quickstart.json POST /v1/messages
openapi: 3.1.0
info:
  title: 'API Kimi (todos los modelos) - Messages: Inicio rápido'
  description: >-
    Ejemplos de inicio rápido para llamar a los modelos de texto Kimi mediante
    el protocolo Anthropic Messages. Solo se necesitan `model`, `max_tokens` y
    `messages` para iniciar una conversación; consulta la página «Referencia
    completa» para llamadas a herramientas, búsqueda web e imágenes de entrada,
    entre otras funciones.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: Producción (Recomendado)
  - url: https://api.evolink.ai
    description: URL alternativa
security:
  - bearerAuth: []
tags:
  - name: Messages
    description: API compatible con Anthropic Messages
paths:
  /v1/messages:
    post:
      tags:
        - Messages
      summary: Chat rápido con Kimi (todos los modelos, compatible con Anthropic)
      description: >-
        - Llama a los modelos Kimi mediante el protocolo Anthropic Messages y
        selecciona el modelo con `model`

        - Solo se requieren `model`, `max_tokens` y `messages` (`max_tokens` es
        obligatorio en el protocolo Anthropic)

        - Los tres modelos tienen una ventana de contexto de 1.048.576 tokens

        - El razonamiento siempre está activado en los tres modelos; ajusta su
        intensidad con `output_config.effort`

        - Para llamadas a herramientas, búsqueda web, imágenes de entrada,
        salida estructurada o ajustes de caché, consulta la [referencia
        completa](/es/api-manual/language-series/kimi/messages/messages-reference)
      operationId: kimiMessagesQuick
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateMessageQuickRequest'
            examples:
              simple:
                summary: Solicitud mínima de Pro
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 2048
                  messages:
                    - role: user
                      content: Explica la caché de contexto en una frase.
              highspeed:
                summary: Highspeed con esfuerzo de razonamiento bajo
                value:
                  model: kimi-k3.1-pro-highspeed
                  max_tokens: 2048
                  output_config:
                    effort: low
                  messages:
                    - role: user
                      content: Explica la caché de contexto en una frase.
              k3:
                summary: Solicitud mínima de Kimi K3
                value:
                  model: kimi-k3
                  max_tokens: 2048
                  messages:
                    - role: user
                      content: Explica la caché de contexto en una frase.
              multi_turn:
                summary: Instrucciones del sistema y conversaciones de varios turnos
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 2048
                  output_config:
                    effort: low
                  system: Eres un editor técnico riguroso. Responde de forma concisa.
                  messages:
                    - role: user
                      content: ¿Qué es la caché de contexto?
                    - role: assistant
                      content: >-
                        La caché de contexto guarda los prefijos repetidos de
                        las solicitudes para que las solicitudes posteriores que
                        acierten en la caché se procesen más rápido y a menor
                        coste.
                    - role: user
                      content: ¿Para qué casos de uso resulta adecuada?
              streaming:
                summary: Streaming SSE de Anthropic
                value:
                  model: kimi-k3.1-pro
                  max_tokens: 2048
                  output_config:
                    effort: low
                  stream: true
                  messages:
                    - role: user
                      content: >-
                        Escribe un poema de cuatro versos sobre una noche de
                        verano.
      responses:
        '200':
          description: >-
            Respuesta Message; las solicitudes en streaming devuelven un flujo
            de eventos Anthropic SSE
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
            text/event-stream:
              schema:
                type: string
                description: >-
                  La secuencia de eventos suele incluir message_start,
                  content_block_*, message_delta y message_stop.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    CreateMessageQuickRequest:
      type: object
      required:
        - model
        - max_tokens
        - messages
      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 |

            |---|---|

            | `kimi-k3.1-pro` | Última generación (recomendado) |

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

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


            Los tres modelos tienen una ventana de contexto de 1.048.576 tokens
            y el razonamiento siempre activado.
        max_tokens:
          type: integer
          minimum: 1
          maximum: 1048576
          description: >-
            Máximo de tokens permitidos para esta generación, incluidos thinking
            y el texto final. Un valor demasiado bajo puede agotar el
            presupuesto durante el razonamiento sin producir texto de respuesta.
            Usa al menos 1024 y aumenta el valor según la complejidad.
        messages:
          type: array
          minItems: 1
          description: >-
            Mensajes de la conversación. En conversaciones de varios turnos,
            incluye el historial en orden; consulta la referencia completa para
            reenviar el historial de razonamiento y llamadas a herramientas.
          items:
            $ref: '#/components/schemas/MessageSimple'
        system:
          type: string
          description: >-
            Prompt de sistema. El protocolo Messages usa un campo system de
            nivel superior en lugar de un rol system.
        output_config:
          type: object
          description: Configuración de salida.
          properties:
            effort:
              type: string
              enum:
                - low
                - high
                - max
              default: max
              description: >-
                Esfuerzo de razonamiento, `max` de forma predeterminada.
                `kimi-k3` solo admite `max`; consulta la referencia completa
                para otros valores compatibles.
        stream:
          type: boolean
          default: false
          description: Indica si se devuelve un flujo de eventos Anthropic SSE.
    MessageResponse:
      type: object
      properties:
        id:
          type: string
          description: ID de la respuesta.
          example: chatcmpl-6adc72c2b5847b4b2ccb39fd
        type:
          type: string
          enum:
            - message
          example: message
        role:
          type: string
          enum:
            - assistant
          example: assistant
        model:
          type: string
          description: Modelo utilizado en esta llamada.
          example: kimi-k3.1-pro
        content:
          type: array
          description: >-
            Bloques de contenido de salida, normalmente thinking seguido de
            text.
          items:
            $ref: '#/components/schemas/OutputContentBlock'
        stop_reason:
          type:
            - string
            - 'null'
          enum:
            - end_turn
            - max_tokens
            - tool_use
            - null
          description: >-
            Motivo de detención: `end_turn` indica un final natural,
            `max_tokens` que se alcanzó el límite de salida y `tool_use` que el
            modelo solicita una llamada a herramienta.
          example: end_turn
        usage:
          $ref: '#/components/schemas/MessageUsage'
    MessageSimple:
      type: object
      required:
        - role
        - content
      properties:
        role:
          type: string
          enum:
            - user
            - assistant
          description: Rol del mensaje. Solo se admiten user y assistant.
        content:
          type: string
          description: Contenido del mensaje (texto sin formato).
          example: Explica la caché de contexto en una frase.
    OutputContentBlock:
      type: object
      properties:
        type:
          type: string
          enum:
            - thinking
            - text
          example: text
        thinking:
          type: string
          description: >-
            Razonamiento cuando `type=thinking`. En conversaciones de varios
            turnos, reenvíalo sin cambios junto con signature.
        signature:
          type: string
          description: >-
            Firma cuando `type=thinking`; reenvíala sin cambios en
            conversaciones de varios turnos.
        text:
          type: string
          description: Texto de la respuesta cuando `type=text`.
          example: >-
            La caché de contexto guarda los prefijos repetidos de las
            solicitudes para que las solicitudes posteriores que acierten en la
            caché se procesen más rápido y a menor coste.
    MessageUsage:
      type: object
      properties:
        input_tokens:
          type: integer
          description: Tokens de entrada normal, sin lecturas ni escrituras de caché.
          example: 24
        cache_read_input_tokens:
          type: integer
          description: Tokens de entrada servidos desde caché.
          example: 0
        cache_creation_input_tokens:
          type: integer
          description: Tokens de entrada escritos en caché.
          example: 0
        output_tokens:
          type: integer
          description: Tokens de salida, incluidos los tokens de thinking.
          example: 96
    ErrorResponse:
      type: object
      properties:
        type:
          type: string
          enum:
            - error
        error:
          type: object
          properties:
            type:
              type: string
            message:
              type: string
        request_id:
          type: string
  responses:
    BadRequest:
      description: Parámetros de solicitud no válidos
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: La API Key no existe o no es válida
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    RateLimited:
      description: Límite de solicitudes superado o cuota insuficiente
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Error interno del servicio
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  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.