API de Kimi K3: contexto 1M, texto e imágenes

moonshot/kimi-k3/chat

Kimi K3 es el modelo agente de contexto largo de Moonshot AI tras una llamada de chat compatible con OpenAI. Lee 1.000.000 de tokens, responde hasta 1.048.576, con esfuerzo de razonamiento low, high o max, hasta 128 herramientas y entrada de imagen.

Entrada $2.70Salida $13.50por 1 millón de tokensEntrada en caché $0.30

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/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

Como máximo 256 turnos ordenados. El contenido es una cadena o un arreglo de partes: text e image_url con un detail opcional auto, low o high. Un resultado de herramienta va en un mensaje con rol tool que lleva su tool_call_id.

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"
              },
              "detail": {
                "enum": [
                  "auto",
                  "low",
                  "high"
                ],
                "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"
                    },
                    "detail": {
                      "enum": [
                        "auto",
                        "low",
                        "high"
                      ],
                      "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 un objeto JSON cuando la salida sea dato estructurado y no prosa.

Valor predeterminado: Sin especificar

tool_choicestring | objectOpcional

auto deja que el modelo se salte una llamada; required obliga a una; none las prohíbe todas.

Valor predeterminado: Sin especificar

toolsarray<object>Opcional

Hasta 128 definiciones de funciones, declaradas en la primera solicitud del bucle.

Valor predeterminado: Sin especificar
Restricciones: maxItems:128

stopstring | arrayOpcional

Hasta 4 secuencias de 32 bytes como máximo cada una, como cadena o como arreglo. La respuesta termina en cuanto el modelo escribe una de ellas, y el texto que coincide no se devuelve. Sin valor por defecto. No cambia la tarifa: una respuesta cortada antes se cobra solo por los tokens que produjo.

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

reasoning_effortstringOpcional

low, high o max, max por defecto: los niveles y el valor por defecto que Moonshot documenta para K3, así que una solicitud que omite el campo ya recibe el ajuste más cuidadoso. Baja a high o low en turnos cortos y mecánicos, donde max sobre todo compra tokens de salida extra.

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

max_tokensintegerOpcional

Limita la respuesta a 1 048 576. El valor por defecto de 32 768 todavía puede cortar sin aviso la reescritura de un archivo entero: ajústalo al entregable. Los tokens de razonamiento también se cobran como salida, así que deja margen por encima de la respuesta visible que esperas.

Valor predeterminado: 32768
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"
                        },
                        "detail": {
                          "enum": [
                            "auto",
                            "low",
                            "high"
                          ],
                          "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": 32768,
      "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."
    }
  },
  "x-input-token-limit": 1000000,
  "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/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/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/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/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/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/api?model=moonshot%2Fkimi-k3%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