Wprowadzenie
Kimi K3.1 Pro to flagowy model Moonshot AI, wydany 23 października 2026 roku jako pierwszy model serii K3.1; Moonshot opisuje go jako swój najbardziej zdolny model o otwartych wagach. Tutaj jest to jeden endpoint czatu zgodny z OpenAI: do 1 048 576 tokenów wejścia, z tekstem, obrazami i wideo w wiadomościach, wywołania funkcji, strumieniowanie oraz reasoning_effort o wartości low, high lub max w każdym żądaniu.
| Pole | Wartość |
|---|---|
| Wejście | Tekst |
| Wyjście | Tekst |
| Budżet wejścia | 1,048,576 tokens |
| Limit max_tokens | 1,048,576 |
| Dane wejściowe | tekst / obrazy / wideo |
Najważniejsze funkcje
Milion tokenów materiałów roboczych w jednym żądaniu
Okno wejściowe o rozmiarze 1 048 576 tokenów mieści całe repozytorium, pakiet umów albo długi wątek badawczy w niezmienionej postaci. Umieść materiał na początku, a pytanie na końcu. Model odpowiada na podstawie tego, co mówią dokumenty, a nie na podstawie streszczenia, które zgubiło jedną potrzebną klauzulę.
Rozumowanie zawsze włączone, z trzema pokrętłami
Moonshot udostępnia Kimi K3.1 Pro jako model z myśleniem: zanim odpowie, rozważa problem, a tego ustawienia nie można wyłączyć. Wybierasz natomiast, jak intensywnie model pracuje. low utrzymuje szybkie odpowiedzi, high sprawdza się przy problemach wieloetapowych, a max, tutaj domyślny, daje modelowi najwięcej miejsca przy trudnym zadaniu.
Zrzuty ekranu, diagramy i nagrania obok pytania
Wiadomość użytkownika może łączyć tekst z częściami image_url i video_url. Przekaż modelowi zrzut ekranu działającego niepoprawnie interfejsu wraz ze stack trace, wykres z pytaniem o niego albo krótkie nagranie ekranu z opisem błędu, i poproś o jedną odpowiedź, która wykorzysta wszystko naraz.
Wywołania funkcji, nad którymi twoja aplikacja nadal ma kontrolę
Model może zwrócić wywołanie funkcji zamiast prozy. Twój kod sprawdza argumenty, wykonuje akcję i odsyła wynik jako wiadomość tool. W jednym wywołaniu można użyć do 128 narzędzi, parallel_tool_calls jest domyślnie włączone, a odpowiedzi mogą być strumieniowane w miarę ich powstawania.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
messages | Tak | Prześlij do Kimi K3.1 Pro rozmowę w kolejności wraz ze źródłami do zadania „plan projektu oparty na źródłach”; powiąż wyniki narzędzi z ich |
max_tokens | Nie | Dla Kimi K3.1 Pro domyślne |
reasoning_effort | Nie | W Kimi K3.1 Pro dostępne są low, high, max, domyślnie max; porównaj ustawienia dla zadania „plan projektu oparty na źródłach” według zużycia tokenów wyjściowych. |
stop | Nie | Zatrzymaj odpowiedź Kimi K3.1 Pro jedną sekwencją lub listą do czterech; dopasowany znacznik pomija się w końcowym tekście. od 1 znaków · od 1 elementów · do 4 elementów |
tools | Nie | Zdefiniuj dla Kimi K3.1 Pro do 128 funkcji w formacie OpenAI do zadania „plan projektu oparty na źródłach”; argumenty sprawdza i operacje wykonuje aplikacja. do 128 elementów |
parallel_tool_calls | Nie | Pozwala się tu Kimi K3.1 Pro proponować kilka niezależnych funkcji w jednej turze; ich wykonaniem nadal steruje aplikacja. Domyślnie: |
tool_choice | Nie | W Kimi K3.1 Pro |
response_format | Nie | Poproś Kimi K3.1 Pro o tekst lub uporządkowany JSON do zadania „plan projektu oparty na źródłach” i sprawdź pola oczekiwane przez aplikację. |
Cennik
Wejście $2 / Wyjście $10 za 1 mln tokenów
Zastosowania
Przegląd kodu i plany migracji na skalę repozytorium
Umieść drzewo źródeł, nieprzechodzące testy i prośbę o zmianę w jednym wywołaniu i poproś o uwagi, które da się przypisać do pliku i wiersza. Użyj high lub max, gdy odpowiedź musi prześledzić wywołanie przez wiele plików, a potem poproś o plan uporządkowany według zależności, z kontrolą dla każdego kroku.
Badania na stosie długich dokumentów
Oznacz każdy artykuł, akta sprawy lub transkrypcję, wskaż, która wersja ma pierwszeństwo, gdy dwie są sprzeczne, i poproś o wnioski z podanym źródłem przy każdym z nich. Okno jest na tyle duże, że cały zbiór pozostaje w zasięgu wzroku bez dzielenia go na części.
Agenci, którzy oglądają zrzuty ekranu i nagrania
Wyślij zrzut ekranu interfejsu lub krótkie nagranie razem z zadaniem, zdefiniuj narzędzia, których agent może używać, i pozwól mu pracować w pętli na wynikach narzędzi, aż skończy. Twój własny kod pozostaje tym, który faktycznie klika, zapisuje lub wdraża.
Strukturalna ekstrakcja z chaotycznych danych wejściowych
Przekazuj faktury, formularze lub obrazy wykresów, opisz pola, które chcesz uzyskać, przez parametry narzędzia albo response_format, i waliduj wynik, zanim trafi do twojej bazy danych.
Wskazówki
Zacznij od max, a potem obniżaj dla szybkości
max jest wartością domyślną i właściwym punktem startu przy trudnym zadaniu. Gdy wiesz, jakiej jakości odpowiedzi potrzebujesz, wypróbuj high, a low stosuj do krótkich, rutynowych wymian, w których opóźnienie ma większe znaczenie niż głębia.
Zostaw w
max_tokensmiejsce na myślenieMyślenie jest wliczane do
max_tokens, którego domyślna wartość to 4 096. Przy długim raporcie, dużej poprawce lub czymkolwiek na poziomie high lub max ustaw wartość wyraźnie wyższą niż długość, jakiej się spodziewasz, bo inaczej budżet może się wyczerpać, zanim pojawi się widoczna odpowiedź.Długi materiał na początku, pytanie na końcu
Umieszczaj dokumenty, kod lub transkrypcje wcześnie w rozmowie, nadaj każdemu krótką etykietę i zadaj pytanie na końcu. Trzymaj instrukcje w wiadomości systemowej, oddzielone od cytowanego materiału, aby tekst zawarty w dokumencie nie został wzięty za twoje polecenie.
Pomiń temperature i
top_pModel sam ustala próbkowanie, więc te dwa pola nie są częścią żądania. Tonem i różnorodnością steruj promptem, a sekwencje zatrzymujące stosuj wtedy, gdy odpowiedź ma się kończyć na określonym znaczniku.
Porównuj źródła w Kimi K3.1 Pro
W limicie 1 048 576 tokenów wejściowych zmieścisz zlecenie, fragmenty źródeł i ograniczenia techniczne. Przy analizie finansowej poproś o źródło każdego wniosku, a przy planie rozwoju o zależności i sposób sprawdzenia każdego etapu.
Ustaw wysiłek rozumowania
K3.1 Pro zawsze rozumuje: dostępne są low, high i max, domyślnie max. W tym endpoincie nie ustawia się temperature ani top_p. Zostaw w max_tokens miejsce na rozumowanie i wynik, a długie odpowiedzi odbieraj strumieniowo.
Połącz media i narzędzia
Wskaż, co trzeba sprawdzić na zrzucie lub w filmie; ten endpoint nie przyjmuje dźwięku. W aplikacji zweryfikuj i wykonaj proponowaną funkcję, a wynik zwróć z pasującym tool_call_id. Zachowaj pełną wiadomość assistant do dalszej analizy.
O treści decyduje wybrany model. W Kimi K3.1 Pro: Obsługa NSFW może się zmieniać; nie gwarantuje się działania bez ograniczeń.
Szybki start z API
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'
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
