API | Kimi K3.1 API — 1M contexto y razonamiento

moonshot/kimi-k3.1-pro/chat

Kimi K3.1 Pro es el modelo insignia de Moonshot AI y se lanzó el 23 de octubre de 2026 como primer modelo de la serie K3.1; Moonshot lo describe como su modelo de pesos abiertos más capaz hasta la fecha. Aquí es un único endpoint de chat compatible con OpenAI: hasta 1,048,576 tokens de entrada con texto, imágenes y video en los mensajes, llamadas a funciones, streaming y un reasoning_effort de low, high o max en cada solicitud.

Entrada $2Salida $10por 1 millón de tokensEntrada en caché $0.20Escritura en caché $2

Ejecutar modelo Ver API

Enviar una solicitud

Los ejemplos usan las definiciones públicas de parámetros del endpoint seleccionado. Sustituye la clave de API y los medios de ejemplo, y envía la solicitud desde tu servidor.

SDK e integraciones

POSThttps://api.spicyapi.ai/v1/chat/completions

Autenticación de API

Guarda la clave de API en la variable de entorno del servidor SPICY_API_KEY. Usa autenticación Bearer y Content-Type: application/json en las solicitudes JSON.

Authorization: Bearer $SPICY_API_KEY

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "moonshot/kimi-k3.1-pro/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

Generado a partir del esquema de entrada de este modelo: el mismo con el que la API valida cada solicitud.

Conserva un Idempotency-Key por cada solicitud lógica. Tras una interrupción de red, no reenvíes automáticamente con una clave nueva; guarda el request_id para investigar la solicitud aceptada. La idempotencia no vuelve a reproducir un flujo de chat anterior.

Parámetros de entrada

Los parámetros del modelo se incluyen junto a model en el cuerpo JSON. Este endpoint no utiliza un contenedor input.

messagesarray<object>Obligatorio

Envía a Kimi K3.1 Pro la conversación en orden con las fuentes para un plan con fuentes verificables; vincula cada resultado de herramienta con su tool_call_id.Kimi K3.1 Pro — El video se envía inline dentro del límite combinado de 14 MB de medios.

Valor predeterminado: Sin especificar
Restricciones: minItems:1
maxItems:256

messages[].rolestringObligatorio dentro del objeto

Role of the message author.

Valor predeterminado: Sin especificar
Valores permitidos: "system""developer""user""assistant""tool"

messages[].namestringOpcional

Optional name identifying the speaker within its role.

Valor predeterminado: Sin especificar

messages[].contentstring | array | nullOpcional

Message content, either plain text or a list of content parts.

Valor predeterminado: Sin especificar

{
  "type": [
    "string",
    "array",
    "null"
  ],
  "items": {
    "oneOf": [
      {
        "type": "object",
        "required": [
          "type",
          "text"
        ],
        "properties": {
          "text": {
            "type": "string"
          },
          "type": {
            "const": "text"
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "image_url"
        ],
        "properties": {
          "type": {
            "const": "image_url"
          },
          "image_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      },
      {
        "type": "object",
        "required": [
          "type",
          "video_url"
        ],
        "properties": {
          "type": {
            "const": "video_url"
          },
          "video_url": {
            "type": "object",
            "required": [
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              }
            }
          }
        }
      }
    ]
  },
  "description": "Message content, either plain text or a list of content parts."
}

messages[].tool_callsarray<object>Opcional

Tool calls the assistant requested in this message.

Valor predeterminado: Sin especificar

messages[].tool_call_idstringOpcional

Identifier of the tool call this message answers. Required on tool messages.

Valor predeterminado: Sin especificar

messages[].reasoning_contentstringOpcional

Reasoning text from a previous assistant reply, preserved when continuing a tool conversation.

Valor predeterminado: Sin especificar

{
  "type": "array",
  "x-ui": {
    "order": 100,
    "widget": "chat-messages",
    "primary": true
  },
  "items": {
    "type": "object",
    "allOf": [
      {
        "if": {
          "required": [
            "reasoning_content"
          ]
        },
        "then": {
          "properties": {
            "role": {
              "const": "assistant"
            }
          }
        }
      }
    ],
    "required": [
      "role"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Optional name identifying the speaker within its role."
      },
      "role": {
        "enum": [
          "system",
          "developer",
          "user",
          "assistant",
          "tool"
        ],
        "type": "string",
        "description": "Role of the message author."
      },
      "content": {
        "type": [
          "string",
          "array",
          "null"
        ],
        "items": {
          "oneOf": [
            {
              "type": "object",
              "required": [
                "type",
                "text"
              ],
              "properties": {
                "text": {
                  "type": "string"
                },
                "type": {
                  "const": "text"
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "image_url"
              ],
              "properties": {
                "type": {
                  "const": "image_url"
                },
                "image_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "video_url"
              ],
              "properties": {
                "type": {
                  "const": "video_url"
                },
                "video_url": {
                  "type": "object",
                  "required": [
                    "url"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          ]
        },
        "description": "Message content, either plain text or a list of content parts."
      },
      "tool_calls": {
        "type": "array",
        "items": {
          "type": "object"
        },
        "description": "Tool calls the assistant requested in this message."
      },
      "tool_call_id": {
        "type": "string",
        "description": "Identifier of the tool call this message answers. Required on tool messages."
      },
      "reasoning_content": {
        "type": "string",
        "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
      }
    },
    "additionalProperties": false
  },
  "maxItems": 256,
  "minItems": 1,
  "description": "Conversation history in order, oldest message first."
}

response_formatobjectOpcional

Pide a Kimi K3.1 Pro texto o JSON estructurado para un plan con fuentes verificables y valida los campos que tu aplicación espera recibir.

Valor predeterminado: Sin especificar

tool_choicestring | objectOpcional

En Kimi K3.1 Pro, tool_choice acepta auto / none / required / function; devuelve cada resultado con el tool_call_id de la llamada original.

Valor predeterminado: Sin especificar

parallel_tool_callsbooleanOpcional

Permite que Kimi K3.1 Pro proponga varias funciones independientes en un turno; tu aplicación sigue controlando su ejecución.

Valor predeterminado: true

toolsarray<object>Opcional

Define para Kimi K3.1 Pro hasta 128 funciones en formato OpenAI para un plan con fuentes verificables; tu aplicación valida los argumentos y ejecuta las operaciones propuestas.

Valor predeterminado: Sin especificar
Restricciones: maxItems:128

stopstring | arrayOpcional

Detén la salida de Kimi K3.1 Pro con una secuencia o una lista de hasta cuatro; la coincidencia no se incluye en el texto final.

Valor predeterminado: Sin especificar
Restricciones: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcional

Kimi K3.1 Pro acepta low, high, max, con max como valor predeterminado; compara ajustes para un plan con fuentes verificables y revisa el consumo de tokens de salida.

Valor predeterminado: "max"
Valores permitidos: "low""high""max"

max_tokensintegerOpcional

En Kimi K3.1 Pro, max_tokens vale 4,096 por defecto y admite hasta 1,048,576 tokens de salida, incluido el razonamiento facturable; reserva espacio para un plan con fuentes verificables.

Valor predeterminado: 4096
Restricciones: minimum:1
maximum:1048576

{
  "type": "object",
  "required": [
    "messages"
  ],
  "x-pricing": {
    "billingMode": "formula",
    "variantFields": []
  },
  "properties": {
    "stop": {
      "type": [
        "string",
        "array"
      ],
      "x-ui": {
        "order": 65,
        "widget": "text",
        "affects_price": false
      },
      "items": {
        "type": "string",
        "maxLength": 32,
        "minLength": 1
      },
      "maxItems": 4,
      "minItems": 1,
      "minLength": 1,
      "description": "Sequences that end the reply as soon as the model writes one; the matched text is not returned."
    },
    "tools": {
      "type": "array",
      "x-ui": {
        "order": 35,
        "widget": "json"
      },
      "items": {
        "type": "object"
      },
      "maxItems": 128,
      "description": "Tool definitions the model may call."
    },
    "messages": {
      "type": "array",
      "x-ui": {
        "order": 100,
        "widget": "chat-messages",
        "primary": true
      },
      "items": {
        "type": "object",
        "allOf": [
          {
            "if": {
              "required": [
                "reasoning_content"
              ]
            },
            "then": {
              "properties": {
                "role": {
                  "const": "assistant"
                }
              }
            }
          }
        ],
        "required": [
          "role"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Optional name identifying the speaker within its role."
          },
          "role": {
            "enum": [
              "system",
              "developer",
              "user",
              "assistant",
              "tool"
            ],
            "type": "string",
            "description": "Role of the message author."
          },
          "content": {
            "type": [
              "string",
              "array",
              "null"
            ],
            "items": {
              "oneOf": [
                {
                  "type": "object",
                  "required": [
                    "type",
                    "text"
                  ],
                  "properties": {
                    "text": {
                      "type": "string"
                    },
                    "type": {
                      "const": "text"
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "image_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "image_url"
                    },
                    "image_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                {
                  "type": "object",
                  "required": [
                    "type",
                    "video_url"
                  ],
                  "properties": {
                    "type": {
                      "const": "video_url"
                    },
                    "video_url": {
                      "type": "object",
                      "required": [
                        "url"
                      ],
                      "properties": {
                        "url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              ]
            },
            "description": "Message content, either plain text or a list of content parts."
          },
          "tool_calls": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "Tool calls the assistant requested in this message."
          },
          "tool_call_id": {
            "type": "string",
            "description": "Identifier of the tool call this message answers. Required on tool messages."
          },
          "reasoning_content": {
            "type": "string",
            "description": "Reasoning text from a previous assistant reply, preserved when continuing a tool conversation."
          }
        },
        "additionalProperties": false
      },
      "maxItems": 256,
      "minItems": 1,
      "description": "Conversation history in order, oldest message first."
    },
    "max_tokens": {
      "type": "integer",
      "x-ui": {
        "unit": "tokens",
        "order": 80,
        "widget": "number",
        "advanced": false,
        "affects_price": false
      },
      "default": 4096,
      "maximum": 1048576,
      "minimum": 1,
      "description": "Maximum number of tokens to generate in the reply."
    },
    "tool_choice": {
      "type": [
        "string",
        "object"
      ],
      "x-ui": {
        "order": 30,
        "widget": "json"
      },
      "description": "Controls whether and which tool the model may call."
    },
    "response_format": {
      "type": "object",
      "x-ui": {
        "order": 25,
        "widget": "json"
      },
      "description": "Requested reply format, such as plain text or a JSON object."
    },
    "reasoning_effort": {
      "enum": [
        "low",
        "high",
        "max"
      ],
      "type": "string",
      "x-ui": {
        "order": 70,
        "widget": "radio"
      },
      "default": "max",
      "description": "How much reasoning the model spends before answering."
    },
    "parallel_tool_calls": {
      "type": "boolean",
      "x-ui": {
        "order": 33,
        "widget": "switch",
        "affects_price": false
      },
      "default": true,
      "description": "Whether the model may request more than one tool call in a single turn."
    }
  },
  "x-image-token-limit": 24576,
  "x-input-token-limit": 1048576,
  "additionalProperties": false,
  "x-max-tokens-includes-reasoning": true
}

Leer el resultado

Con stream en false, la solicitud devuelve directamente la respuesta completa: lee choices[].message, sin consultar ninguna tarea. Pon stream en true si tu cliente admite Server-Sent Events.

Ejemplo de respuesta completada

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "created": 1788652800,
  "model": "moonshot/kimi-k3.1-pro/chat",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Here is a concise summary of the release notes."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 14,
    "total_tokens": 46
  }
}

Esta respuesta solo ilustra la estructura. usage trae el número de tokens; el consumo y el costo reales dependen de tu solicitud.

SDK e integraciones

Usa SpicyAPI en tu app, terminal, asistente de IA o flujo visual. Elige una guía de configuración.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandos de terminal y scripts de automatización.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrucciones reutilizables para tu asistente de IA.

n8n

Nodos comunitarios para instalaciones propias y plantillas HTTP Request importables para n8n Cloud.

ComfyUI

Flujos de imagen, video y audio en un lienzo de nodos.

Más integraciones

SillyTavern Telegram / Discord App proxy OpenAI SDK LangChain Vercel AI SDK

Explorar flujos listos para usar

Es un modelo de chat, así que funciona donde se use la API de chat de OpenAI: mantén tu cliente, cambia la URL base y elige este modelo por su ID.

Conecta aquí cualquier cliente compatible con OpenAI

export OPENAI_BASE_URL="https://api.spicyapi.ai/v1"
export OPENAI_API_KEY="$SPICY_API_KEY"

aider --model openai/moonshot/kimi-k3.1-pro/chat

Todo lo que use la API de chat de OpenAI funciona de la misma manera: SDKs, Vercel AI SDK, LangChain, aider, Cline. El servidor MCP y la CLI spicyapi cubren tareas de medios asíncronas. Encontrarás la configuración de cada herramienta en el centro de desarrolladores.

Úsalo en SillyTavern y apps de roleplay

En SillyTavern, RisuAI, Agnai o cualquier app con una opción compatible con OpenAI, pega la URL base de abajo y tu clave de API, y elige moonshot/kimi-k3.1-pro/chat como modelo. Se aceptan llamadas desde el navegador, y los controles que este modelo no admite se ignoran en lugar de rechazarse.

Base URL: https://api.spicyapi.ai/v1
Model: moonshot/kimi-k3.1-pro/chat

Guía de SillyTavern RisuAI, Agnai y más Extensión de SillyTavern

Úsalo en ComfyUI

Instala los nodos de SpicyAPI desde ComfyUI Manager o con el comando de abajo y elige moonshot/kimi-k3.1-pro/chat en el nodo SpicyAPI Chat para usar este modelo dentro de un grafo de ComfyUI.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi

Ejemplos de workflows Guía de configuración Código en GitHub

El panel incrustado lee el mismo esquema que esta página, así que no puede desincronizarse de la API. Si tu documentación necesita contenido indexable, toma el JSON de /api/embed/models/ y renderízalo tú mismo.

<iframe src="https://spicyapi.ai/embed/es/models/kimi-k3-1-pro/api?model=moonshot%2Fkimi-k3.1-pro%2Fchat" width="100%" height="560" loading="lazy" title="Ejemplo de solicitud" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Abrir el panel

Playground

Enviar una solicitud

Autenticación de API

Parámetros de entrada

Leer el resultado

SDK e integraciones

Úsalo en SillyTavern y apps de roleplay

Úsalo en ComfyUI