Kimi K3 API

moonshot/kimi-k3/chat

Kimi K3 to model agentowy od Moonshot AI do długiego kontekstu, za wywołaniem czatu zgodnym z OpenAI. Czyta 1 000 000 tokenów, odpowiada do 1 048 576, z wysiłkiem rozumowania low, high lub max, do 128 narzędzi i wejściem obrazu.

Wejście $2.70Wyjście $13.50za 1 mln tokenówWejście z pamięci podręcznej $0.30Cena oficjalna Moonshot AI$3~~$15~~

Uruchom model Zobacz API

Wyślij żądanie

Przykłady korzystają z publicznych definicji parametrów wybranego endpointu. Podmień klucz API i przykładowe media, a potem wyślij żądanie ze swojego serwera.

SDK i integracje

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

Uwierzytelnianie API

Klucz API trzymaj w zmiennej środowiskowej serwera SPICY_API_KEY. Dla żądań JSON używaj uwierzytelniania Bearer i 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/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'

Wygenerowane ze schematu wejścia tego modelu – tego samego, względem którego API waliduje każde żądanie.

Dla każdego logicznego żądania zachowaj jeden Idempotency-Key. Po przerwaniu połączenia nie wysyłaj automatycznie ponownie z nowym kluczem; zachowaj request_id, żeby sprawdzić przyjęte żądanie. Idempotentność nie odtwarza wcześniejszego strumienia czatu.

Parametry wejściowe

Parametry modelu umieść bezpośrednio w ciele żądania JSON, obok model. Ten endpoint nie używa opakowania input.

messagesarray<object>Wymagane

Najwyżej 256 uporządkowanych tur. Treść to zwykły łańcuch znaków albo tablica części: text oraz image_url z opcjonalnym detail auto, low albo high. Wynik narzędzia trafia do wiadomości z rolą tool niosącej jego tool_call_id.

Domyślnie: Nie określono
Ograniczenia: minItems:1
maxItems:256

messages[].rolestringWymagane wewnątrz obiektu

Role of the message author.

Domyślnie: Nie określono
Dozwolone wartości: "system""developer""user""assistant""tool"

messages[].namestringOpcjonalne

Optional name identifying the speaker within its role.

Domyślnie: Nie określono

messages[].contentstring | array | nullOpcjonalne

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

Domyślnie: Nie określono

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

Tool calls the assistant requested in this message.

Domyślnie: Nie określono

messages[].tool_call_idstringOpcjonalne

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

Domyślnie: Nie określono

messages[].reasoning_contentstringOpcjonalne

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

Domyślnie: Nie określono

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

Poproś o obiekt JSON, gdy wyjściem są dane ustrukturyzowane, a nie proza.

Domyślnie: Nie określono

tool_choicestring | objectOpcjonalne

auto pozwala modelowi pominąć wywołanie; required wymusza jedno; none zakazuje wszystkich.

Domyślnie: Nie określono

toolsarray<object>Opcjonalne

Do 128 definicji funkcji, deklarowanych w pierwszym żądaniu pętli.

Domyślnie: Nie określono
Ograniczenia: maxItems:128

stopstring | arrayOpcjonalne

Do 4 sekwencji, każda najwyżej 32 bajty, jako string albo tablica. Odpowiedź kończy się, gdy tylko model zapisze którąś z nich, a dopasowany tekst nie jest zwracany. Brak wartości domyślnej. Stawka się nie zmienia – odpowiedź ucięta wcześniej jest rozliczana tylko za wygenerowane tokeny.

Domyślnie: Nie określono
Ograniczenia: minLength:1
minItems:1
maxItems:4

reasoning_effortstringOpcjonalne

low, high albo max, domyślnie max – poziomy i wartość domyślna, które Moonshot dokumentuje dla K3, więc żądanie pomijające to pole dostaje od razu najstaranniejsze ustawienie. Przy krótkich, mechanicznych turach zejdź do high albo low, bo tam max kupuje głównie dodatkowe tokeny wyjściowe.

Domyślnie: "max"
Dozwolone wartości: "low""high""max"

max_tokensintegerOpcjonalne

Ogranicza odpowiedź do 1 048 576. Nawet domyślne 32 768 może po cichu uciąć przepisany w całości plik – dopasuj wartość do wyniku. Tokeny rozumowania są rozliczane również jako wyjście, więc zostaw zapas powyżej oczekiwanej widocznej odpowiedzi.

Domyślnie: 32768
Ograniczenia: 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
}

Odczytaj wynik

Przy stream ustawionym na false żądanie zwraca gotową odpowiedź czatu od razu. Czytaj choices[].message; odpytywanie zadania nie jest potrzebne. Ustaw stream na true, jeśli twój klient obsługuje Server-Sent Events.

Przykład odpowiedzi po zakończeniu

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

Przykładowa odpowiedź jest poglądowa. usage podaje liczbę tokenów; liczba tokenów i opłata zależą od twojego rzeczywistego żądania.

SDK i integracje

Korzystaj ze SpicyAPI w aplikacji, terminalu, asystencie AI lub wizualnym przepływie pracy. Wybierz instrukcję konfiguracji.

SDKs

TypeScript · Python · Go · PHP · Java

CLI

Polecenia terminala i skrypty automatyzacji.

MCP

Claude Code · Cursor · Codex

Agent Skill

Instrukcje wielokrotnego użytku dla asystenta AI.

n8n

Węzły społecznościowe dla instalacji self-hosted i szablony HTTP Request do importu w n8n Cloud.

ComfyUI

Przepływy obrazów, wideo i dźwięku na płótnie węzłów.

Więcej integracji

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

Przeglądaj gotowe przepływy pracy

To model czatowy, więc działa wszędzie tam, gdzie działa czatowe API OpenAI: zostaw swojego klienta, zmień adres bazowy i wskaż ten model po jego identyfikatorze.

Podłącz dowolnego klienta zgodnego z OpenAI

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

aider --model openai/moonshot/kimi-k3/chat

Narzędzia obsługujące API czatu OpenAI działają w ten sam sposób: SDK, Vercel AI SDK, LangChain, aider i Cline. Serwer MCP i CLI spicyapi obsługują asynchroniczne zadania multimedialne. Konfiguracje poszczególnych narzędzi znajdziesz w centrum dla deweloperów.

Używaj w SillyTavern i aplikacjach do roleplayu

W SillyTavern, RisuAI, Agnai lub dowolnej aplikacji z ustawieniem zgodnym z OpenAI wklej poniższy bazowy URL i swój klucz API, a jako model wybierz moonshot/kimi-k3/chat. Wywołania prosto z przeglądarki są dozwolone, a suwaki, których ten model nie obsługuje, są pomijane zamiast odrzucane.

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

Przewodnik po SillyTavern RisuAI, Agnai i inne Rozszerzenie SillyTavern

Użyj w ComfyUI

Zainstaluj węzły SpicyAPI przez ComfyUI Manager albo poleceniem poniżej, a potem wybierz moonshot/kimi-k3/chat w węźle SpicyAPI Chat, aby używać tego modelu w schemacie ComfyUI.

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

Przykładowe workflowy Poradnik konfiguracji Kod źródłowy na GitHubie

Osadzony panel czyta ten sam schemat co ta strona, więc nie może się od API rozjechać. Jeśli twoja dokumentacja potrzebuje treści przeszukiwalnej, pobierz JSON spod /api/embed/models/ i wyrenderuj go samodzielnie.

<iframe src="https://spicyapi.ai/embed/pl/models/kimi-k3/api?model=moonshot%2Fkimi-k3%2Fchat" width="100%" height="560" loading="lazy" title="Przykładowe żądanie" style="border:1px solid rgba(0,0,0,.12)"></iframe>

Otwórz panel

Obszar roboczy

Wyślij żądanie

Uwierzytelnianie API

Parametry wejściowe

Odczytaj wynik

SDK i integracje

Używaj w SillyTavern i aplikacjach do roleplayu

Użyj w ComfyUI