API Kimi (todos los modelos) - Messages: Referencia completa

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

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

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

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

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

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

POST

messages

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

{
  "id": "<string>",
  "type": "message",
  "role": "assistant",
  "model": "kimi-k3.1-pro",
  "content": [
    {
      "type": "text",
      "text": "<string>"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": "<string>",
  "usage": {
    "input_tokens": 123,
    "cache_creation_input_tokens": 123,
    "cache_read_input_tokens": 123,
    "output_tokens": 123,
    "output_tokens_details": {
      "thinking_tokens": 123
    },
    "cache_creation": {
      "ephemeral_5m_input_tokens": 1,
      "ephemeral_1h_input_tokens": 1
    },
    "server_tool_use": {
      "web_search_requests": 1
    }
  }
}

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

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

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

{
  "type": "error",
  "error": {
    "type": "<string>",
    "message": "<string>"
  },
  "request_id": "<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.

La salida estructurada (output_config.format), las secuencias de detención (stop_sequences) y el TTL de escritura de caché (cache_control) solo son compatibles con la serie K3.1, no con kimi-k3. Las respuestas de kimi-k3 pueden contener únicamente bloques text, sin bloques thinking.

Opciones disponibles:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed,

kimi-k3

max_tokens

integer

requerido

Número máximo de tokens permitidos para esta generación, incluidos thinking y el texto final.

Rango requerido: 1 <= x <= 1048576

messages

object[]

requerido

Lista de mensajes de Anthropic Messages. En conversaciones de varios turnos, devuelve sin cambios los bloques de contenido completos del assistant.

Minimum array length: 1

Show child attributes

system

Prompt de sistema como cadena o array de bloques text.

stream

boolean

predeterminado:false

Indica si se devuelve un flujo de eventos Anthropic SSE.

tools

object[]

Funciones personalizadas o búsqueda web del servidor. La búsqueda integrada usa type=web_search_20250305 y name=web_search; se cobra por llamada realizada.

Option 1
Option 2

Show child attributes

tool_choice

object

Show child attributes

stop_sequences

string[]

Secuencias de detención. Una coincidencia exacta detiene la salida y la secuencia coincidente no se emite. Hasta 5 secuencias de un máximo de 32 bytes cada una. Al coincidir, stop_reason es end_turn y stop_sequence es null.

Solo son compatibles con kimi-k3.1-pro / kimi-k3.1-pro-highspeed, no con kimi-k3.

Maximum array length: 5

cache_control

object

Opciones de escritura de caché de nivel superior, compatibles solo con kimi-k3.1-pro / kimi-k3.1-pro-highspeed; kimi-k3 no admite este parámetro. Solo cache_control de nivel superior controla el TTL de escritura; los marcadores de caché de los bloques de mensajes no sustituyen este campo. El valor predeterminado si se omite es 5m.

Show child attributes

output_config

object

Configuración de salida: esfuerzo de razonamiento y salida estructurada.

Show child attributes

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 Message; las solicitudes en streaming devuelven un flujo de eventos Anthropic SSE

string

type

enum<string>

Opciones disponibles:

message

role

enum<string>

Opciones disponibles:

assistant

model

string

Ejemplo:

"kimi-k3.1-pro"

content

object[]

Bloque de contenido de Anthropic para texto, imagen, razonamiento, uso de herramientas o resultados de herramientas.

Show child attributes

stop_reason

enum<string> | null

Opciones disponibles:

end_turn,

max_tokens,

tool_use,

refusal,

null

stop_sequence

string | null

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) - Messages: Referencia completa

Autorizaciones

Cuerpo

Respuesta