Kimi K3.1 Pro / Highspeed - API Responses

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "input": "Reply with OK.",
  "reasoning": {
    "effort": "low"
  },
  "max_output_tokens": 1024
}
'

{
  "id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
  "object": "response",
  "created_at": 123,
  "completed_at": 123,
  "status": "in_progress",
  "model": "<string>",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>",
      "status": "in_progress"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 123
    },
    "output_tokens": 123,
    "output_tokens_details": {
      "reasoning_tokens": 123
    },
    "total_tokens": 123
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "instructions": "<string>",
  "reasoning": {},
  "text": {},
  "tools": [
    {
      "type": "function",
      "name": "<string>",
      "description": "<string>",
      "parameters": {},
      "strict": true
    }
  ],
  "tool_choice": "auto",
  "max_output_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "parallel_tool_calls": true,
  "service_tier": "<string>",
  "store": true,
  "background": true,
  "previous_response_id": "<string>",
  "conversation": {},
  "prompt_cache_options": {
    "mode": "implicit",
    "ttl": "5m"
  }
}

{
  "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>"
  }
}

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

POST

responses

curl --request POST \
  --url https://direct.evolink.ai/v1/responses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kimi-k3.1-pro",
  "input": "Reply with OK.",
  "reasoning": {
    "effort": "low"
  },
  "max_output_tokens": 1024
}
'

{
  "id": "resp_68f0c1c2d3e4f5a6b7c8d9e0",
  "object": "response",
  "created_at": 123,
  "completed_at": 123,
  "status": "in_progress",
  "model": "<string>",
  "output": [
    {
      "type": "reasoning",
      "id": "rs_68f0c1c2d3e4f5a6b7c8d9e0",
      "summary": [
        {
          "type": "summary_text",
          "text": "<string>"
        }
      ],
      "encrypted_content": "<string>",
      "status": "in_progress"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "cached_tokens": 123,
      "cache_write_tokens": 123
    },
    "output_tokens": 123,
    "output_tokens_details": {
      "reasoning_tokens": 123
    },
    "total_tokens": 123
  },
  "incomplete_details": {
    "reason": "max_output_tokens"
  },
  "error": {
    "code": "<string>",
    "message": "<string>"
  },
  "instructions": "<string>",
  "reasoning": {},
  "text": {},
  "tools": [
    {
      "type": "function",
      "name": "<string>",
      "description": "<string>",
      "parameters": {},
      "strict": true
    }
  ],
  "tool_choice": "auto",
  "max_output_tokens": 123,
  "temperature": 123,
  "top_p": 123,
  "parallel_tool_calls": true,
  "service_tier": "<string>",
  "store": true,
  "background": true,
  "previous_response_id": "<string>",
  "conversation": {},
  "prompt_cache_options": {
    "mode": "implicit",
    "ttl": "5m"
  }
}

{
  "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>"
  }
}

{
  "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 interfaces requieren autenticación mediante Bearer Token##

Obtención de la API Key:

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

Al usarla, añádela en la cabecera de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:kimi-k3.1-pro

requerido

Use kimi-k3.1-pro o kimi-k3.1-pro-highspeed; Highspeed genera más rápido.

Opciones disponibles:

kimi-k3.1-pro,

kimi-k3.1-pro-highspeed

input

requerido

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.

instructions

string

Instrucciones de sistema de nivel superior, aplicadas antes que las demás.

stream

boolean

predeterminado:false

Si es true, devuelve la respuesta como un flujo SSE.

max_output_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

object

Configuración de razonamiento.

Show child attributes

text

object

Configuración del texto de salida.

Show child attributes

tools

(Herramienta de función · object | Herramienta personalizada · object | Herramienta de espacio de nombres · object | Herramienta de búsqueda web · object)[]

Herramientas que el modelo puede llamar.

Definición de herramienta por type. Admite function, custom (solo apply_patch), namespace y web_search; no admite otros tipos.

Herramienta de función
Herramienta personalizada
Herramienta de espacio de nombres
Herramienta de búsqueda web

Show child attributes

tool_choice

enum<string>

Controla las herramientas. Con auto, el modelo decide si llama a una herramienta.

Opciones disponibles:

auto

include

enum<string>[]

Campos adicionales, solo para web_search. web_search_call.action.sources devuelve fuentes web encontradas y web_search_call.results, resultados de imágenes.

Opciones disponibles:

web_search_call.results,

web_search_call.action.sources

prompt_cache_options

object

Opciones de escritura en la caché de contexto. Si se omite, se escribe automáticamente en la caché de 5m. Las escrituras y lecturas se facturan por separado.

Show child attributes

Respuesta

Respuesta creada correctamente

Una respuesta del modelo.

string

Identificador único de la respuesta.

Ejemplo:

"resp_68f0c1c2d3e4f5a6b7c8d9e0"

object

enum<string>

Opciones disponibles:

response

created_at

integer

Marca de tiempo Unix de creación de la respuesta.

completed_at

integer | null

Marca de tiempo Unix de finalización. Presente cuando status es completed o incomplete; null para in_progress o failed.

status

enum<string>

Estado de la respuesta. La instantánea inicial del streaming tiene estado in_progress.

Opciones disponibles:

in_progress,

completed,

incomplete,

failed

model

string

Modelo que generó esta respuesta.

output

(Razonamiento · object | Mensaje · object | Function Call · object | Llamada a herramienta personalizada · object | Llamada de búsqueda web · object)[]

Array de salida en este orden: web_search_call (si existe), reasoning, message y llamadas a herramientas.

Elemento del array output, distinguido por type.

Razonamiento
Mensaje
Function Call
Llamada a herramienta personalizada
Llamada de búsqueda web

Show child attributes

usage

object | null

input_tokens incluye lecturas y escrituras de caché; reste cached_tokens y cache_write_tokens para obtener la entrada normal. output_tokens ya incluye el razonamiento.

Show child attributes

incomplete_details

object | null

Motivo cuando status es incomplete.

Show child attributes

error

object | null

Detalles del error cuando status es failed.

Show child attributes

instructions

string | null

reasoning

object | null

text

object | null

tools

(Herramienta de función · object | Herramienta personalizada · object | Herramienta de espacio de nombres · object | Herramienta de búsqueda web · object)[] | null

Definición de herramienta por type. Admite function, custom (solo apply_patch), namespace y web_search; no admite otros tipos.

Herramienta de función
Herramienta personalizada
Herramienta de espacio de nombres
Herramienta de búsqueda web

Show child attributes

tool_choice

enum<string> | null

Controla las herramientas. Con auto, el modelo decide si llama a una herramienta.

Opciones disponibles:

auto

max_output_tokens

integer | null

temperature

number | null

top_p

number | null

parallel_tool_calls

boolean

service_tier

string | null

store

boolean

Siempre false.

background

boolean | null

Siempre false.

previous_response_id

string | null

Siempre null.

conversation

object | null

Siempre null.

prompt_cache_options

object

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í.

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

Kimi K3.1 Pro / Highspeed - API Responses

Autorizaciones

Cuerpo

Respuesta