curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ],
  "reasoning_effort": "low",
  "max_completion_tokens": 1024
}
'

{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "kimi-k3.1-pro",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "system",
        "content": "<string>",
        "reasoning_content": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "tool_call_id": "<string>"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 1
    },
    "completion_tokens_details": {
      "reasoning_tokens": 123
    }
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Chat Completions API

API Kimi (todos los modelos) - Chat Completions: Referencia completa

Llama a los modelos Kimi en formato OpenAI Chat Completions, con respuestas JSON normales o en streaming SSE. En conversaciones de varios turnos, conserva completos reasoning_content y tool_calls de los mensajes assistant.

Cuando la búsqueda web devuelva tool_calls, reenvía function.arguments de cada llamada como contenido de un mensaje tool con el mismo tool_call_id y continúa la solicitud para generar la respuesta final.

POST

chat

completions

curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "messages": [
    {
      "role": "user",
      "content": "Reply with OK."
    }
  ],
  "reasoning_effort": "low",
  "max_completion_tokens": 1024
}
'

{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "kimi-k3.1-pro",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "system",
        "content": "<string>",
        "reasoning_content": "<string>",
        "tool_calls": [
          {
            "id": "<string>",
            "type": "function",
            "function": {
              "name": "<string>",
              "arguments": "<string>"
            }
          }
        ],
        "tool_call_id": "<string>"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 1
    },
    "completion_tokens_details": {
      "reasoning_tokens": 123
    }
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

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.

Autorizaciones

Authorization

string

header

requerido

##Todas las API requieren autenticación con Bearer Token##

Obtener la API Key:

Visita la página de gestión de API Keys para obtener tu API Key

Añadir al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:kimi-k3.1-pro

requerido

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.

El TTL de escritura de caché (prompt_cache_options) solo es compatible con la serie K3.1; kimi-k3 no admite este parámetro.

Opciones disponibles:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

messages

object[]

requerido

Mensajes de la conversación. En conversaciones de varios turnos, incluye los mensajes históricos completos del assistant.

Minimum array length: 1

Show child attributes

max_completion_tokens

integer

predeterminado:131072

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.

Rango requerido: 1 <= x <= 1048576

reasoning_effort

enum<string>

predeterminado:max

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.

Opciones disponibles:

low,

high,

max,

medium,

xhigh,

minimal,

none

stream

boolean

predeterminado:false

Indica si la respuesta se devuelve como flujo SSE.

tools

object[]

Herramientas de función o búsqueda web. Declare la búsqueda con {"type":"web_search"}.

Maximum array length: 128

Option 1
Option 2

Show child attributes

tool_choice

Controla si el modelo llama a herramientas o fuerza una función concreta.

Opciones disponibles:

auto,

none,

required

prompt_cache_options

object

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.

Show child attributes

response_format

object

Formato de salida: text para texto plano, json_object para un objeto JSON o json_schema para salida estructurada conforme a un JSON Schema.

Show child attributes

max_tokens

integer

obsoleto

Alias antiguo del límite de salida. Use max_completion_tokens en nuevas solicitudes y evite configurar ambos.

Rango requerido: 1 <= x <= 1048576

temperature

number

predeterminado:1

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

number

predeterminado:0.95

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.

Respuesta

Respuesta de chat completion; las solicitudes en streaming devuelven un flujo de eventos SSE

string

object

string

Ejemplo:

"chat.completion"

created

integer

model

string

Ejemplo:

"kimi-k3.1-pro"

choices

object[]

Show child attributes

usage

object

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

API Kimi (todos los modelos) - Chat Completions: Referencia completa

Autorizaciones

Cuerpo

Respuesta