API | Kimi K3.1 API — Contesto 1M e ragionamento

moonshot/kimi-k3.1-pro/chat

Kimi K3.1 Pro è il modello di punta di Moonshot AI, uscito il 23 ottobre 2026 come primo modello della serie K3.1; Moonshot lo descrive come il suo modello a pesi aperti più capace finora. Qui è un unico endpoint di chat compatibile con OpenAI: fino a 1.048.576 token di input, con testo, immagini e video nei messaggi, chiamate di funzione, streaming e un reasoning_effort di low, high o max in ogni richiesta.

Input $2Output $10per 1 milione di tokenInput in cache $0.20Scrittura in cache $2

Esegui il modello Vedi l’API

Invia una richiesta

Gli esempi usano le definizioni pubbliche dei parametri dell’endpoint selezionato. Sostituisci la chiave API e i media di esempio, poi invia la richiesta dal tuo server.

SDK e integrazioni

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

Autenticazione dell’API

Tieni la chiave API nella variabile d’ambiente del server SPICY_API_KEY. Per le richieste JSON usa l’autenticazione Bearer e Content-Type: application/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'

Generato dallo schema di input di questo modello, lo stesso su cui l’API valida ogni richiesta.

Tieni una sola Idempotency-Key per ogni richiesta logica. Dopo un’interruzione di rete, non rispedire automaticamente con una chiave nuova; conserva il request_id per indagare sulla richiesta accettata. L’idempotenza non ritrasmette uno stream di chat già avvenuto.

Parametri di input

Metti i parametri del modello direttamente nel corpo JSON della richiesta, accanto a model. Questo endpoint non usa un contenitore input.

messagesarray<object>Obbligatorio

Invia a Kimi K3.1 Pro la conversazione in ordine con le fonti per un piano di progetto fondato sulle fonti; associa ogni risultato degli strumenti al relativo tool_call_id.Kimi K3.1 Pro — Invia il video inline, nel limite complessivo di 14 MB di media.

Predefinito: Non specificato
Vincoli: minItems:1
maxItems:256

messages[].rolestringObbligatorio dentro l’oggetto

Role of the message author.

Predefinito: Non specificato
Valori ammessi: "system""developer""user""assistant""tool"

messages[].namestringFacoltativo

Optional name identifying the speaker within its role.

Predefinito: Non specificato

messages[].contentstring | array | nullFacoltativo

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

Predefinito: Non specificato

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

Tool calls the assistant requested in this message.

Predefinito: Non specificato

messages[].tool_call_idstringFacoltativo

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

Predefinito: Non specificato

messages[].reasoning_contentstringFacoltativo

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

Predefinito: Non specificato

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

Chiedi a Kimi K3.1 Pro testo o JSON strutturato per un piano di progetto fondato sulle fonti e verifica i campi attesi dalla tua applicazione.

Predefinito: Non specificato

tool_choicestring | objectFacoltativo

Per Kimi K3.1 Pro, tool_choice accetta auto / none / required / function; restituisci ogni risultato con il tool_call_id della chiamata originale.

Predefinito: Non specificato

parallel_tool_callsbooleanFacoltativo

Consente a Kimi K3.1 Pro di proporre più funzioni indipendenti in un turno; la tua applicazione continua a controllarne l’esecuzione.

Predefinito: true

toolsarray<object>Facoltativo

Definisci per Kimi K3.1 Pro fino a 128 funzioni in formato OpenAI per un piano di progetto fondato sulle fonti; la tua applicazione convalida gli argomenti ed esegue le operazioni proposte.

Predefinito: Non specificato
Vincoli: maxItems:128

stopstring | arrayFacoltativo

Ferma l’uscita di Kimi K3.1 Pro con una sequenza o un elenco di massimo quattro; il marcatore riconosciuto non compare nel testo finale.

Predefinito: Non specificato
Vincoli: minLength:1
minItems:1
maxItems:4

reasoning_effortstringFacoltativo

Kimi K3.1 Pro accetta low, high, max, con max come valore predefinito; confronta le impostazioni per un piano di progetto fondato sulle fonti osservando i token di uscita consumati.

Predefinito: "max"
Valori ammessi: "low""high""max"

max_tokensintegerFacoltativo

Per Kimi K3.1 Pro, max_tokens ha valore predefinito 4,096 e limite 1,048,576 token di uscita, ragionamento fatturabile incluso; lascia spazio per un piano di progetto fondato sulle fonti.

Predefinito: 4096
Vincoli: 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
}

Leggi il risultato

Con stream impostato a false la richiesta restituisce direttamente la risposta di chat completata. Leggi choices[].message; non serve interrogare nessuna attività. Imposta stream a true quando il tuo client supporta i Server-Sent Events.

Esempio di risposta completata

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

L’esempio di risposta è illustrativo. usage riporta il conteggio dei token; conteggi e addebiti dipendono dalla tua richiesta reale.

SDK e integrazioni

Usa SpicyAPI nella tua app, nel terminale, con un assistente IA o in un workflow visivo. Scegli una guida di configurazione.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Comandi da terminale e script di automazione.

MCP

Claude Code · Cursor · Codex

Agent Skill

Istruzioni riutilizzabili per il tuo assistente IA.

n8n

Nodi della community per installazioni self-hosted e template HTTP Request importabili per n8n Cloud.

ComfyUI

Workflow di immagini, video e audio su una tela a nodi.

Altre integrazioni

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

Esplora i workflow pronti all’uso

Questo è un modello di chat, quindi funziona ovunque funzioni l’API chat di OpenAI: tieni il tuo client, cambia l’URL di base e seleziona questo modello con il suo identificatore.

Punta qui qualsiasi client compatibile 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

Tutto quello che usa l’API chat di OpenAI funziona allo stesso modo: gli SDK, il Vercel AI SDK, LangChain, aider e Cline. Il server MCP e la CLI spicyapi coprono le attività multimediali asincrone. La configurazione di ciascuno strumento è nell’area sviluppatori.

Usalo in SillyTavern e nelle app di roleplay

In SillyTavern, RisuAI, Agnai o in qualsiasi app con un’impostazione compatibile con OpenAI, incolla l’URL di base qui sotto e la tua chiave API, poi scegli moonshot/kimi-k3.1-pro/chat come modello. Le chiamate dal browser sono consentite, e i cursori che questo modello non supporta vengono ignorati invece di essere rifiutati.

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

Guida a SillyTavern RisuAI, Agnai e altre Estensione per SillyTavern

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi scegli moonshot/kimi-k3.1-pro/chat nel nodo SpicyAPI Chat per usare questo modello dentro un grafo di ComfyUI.

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

Esempi di workflow Guida all’installazione Codice sorgente su GitHub

Il pannello incorporato legge lo stesso schema di questa pagina, quindi non può discostarsi dall’API. Se nella tua documentazione i contenuti devono essere ricercabili, leggi il JSON sotto /api/embed/models/ e renderizzalo per conto tuo.

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

Apri il pannello

Playground

Invia una richiesta

Autenticazione dell’API

Parametri di input

Leggi il risultato

SDK e integrazioni

Usalo in SillyTavern e nelle app di roleplay

Usalo in ComfyUI