소개
Kimi K3.1 Pro는 Moonshot AI의 플래그십 모델로, 2026년 10월 23일 K3.1 시리즈의 첫 번째 모델로 출시되었습니다. Moonshot은 이를 지금까지 가장 뛰어난 오픈 웨이트 모델이라고 소개합니다. 여기서는 OpenAI 호환 채팅 엔드포인트 하나로 제공됩니다. 메시지에 텍스트, 이미지, 동영상을 합쳐 최대 1,048,576토큰까지 입력할 수 있고, 함수 호출과 스트리밍을 지원하며, 모든 요청에서 reasoning_effort를 low, high, max 중에서 선택할 수 있습니다.
| 항목 | 값 |
|---|---|
| 입력 | 텍스트 |
| 출력 | 텍스트 |
| 입력 예산 | 1,048,576 tokens |
| max_tokens 상한 | 1,048,576 |
핵심 기능 및 하이라이트
한 번의 요청에 100만 토큰 분량의 작업 자료를
1,048,576토큰 입력 창에는 저장소 전체, 계약서 묶음, 긴 리서치 대화를 원래 모습 그대로 담을 수 있습니다. 자료를 앞에 두고 질문은 마지막에 놓아 주십시오. 모델은 필요한 조항 하나를 빠뜨린 요약이 아니라 문서에 적힌 내용을 근거로 답변합니다.
항상 켜져 있는 추론, 세 가지 설정
Moonshot은 Kimi K3.1 Pro를 사고형 모델로 제공합니다. 답변하기 전에 먼저 생각하며, 이 설정은 끌 수 없습니다. 선택하는 것은 얼마나 열심히 생각할지입니다. low는 응답을 빠르게 유지하고, high는 여러 단계로 이루어진 문제에 맞으며, 여기서 기본값인 max는 어려운 과제에 모델이 가장 많은 여유를 갖도록 합니다.
질문 옆에 스크린샷, 다이어그램, 클립을
사용자 메시지에는 텍스트와 image_url, video_url 파트를 섞어 넣을 수 있습니다. 스택 트레이스가 함께 찍힌 오류 화면 스크린샷, 질문이 붙은 차트, 버그 보고서와 함께 보낸 짧은 화면 녹화를 전달하고, 이 모든 것을 활용한 하나의 답변을 요청해 보십시오.
함수 호출은 애플리케이션이 계속 주도합니다
모델은 산문 대신 함수 호출을 반환할 수 있습니다. 여러분의 코드가 인자를 검증하고, 작업을 실행한 뒤, 결과를 tool 메시지로 다시 보냅니다. 한 번의 호출에 최대 128개의 도구를 사용할 수 있고, parallel_tool_calls는 기본으로 켜져 있으며, 응답은 작성되는 대로 스트리밍할 수 있습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
messages | 예 | Kimi K3.1 Pro에 근거 기반 개발 계획 자료를 포함한 대화를 순서대로 보냅니다. 도구 결과는 원래 tool_call_id와 연결합니다.Kimi K3.1 Pro — 영상은 인라인으로 전송하며 미디어 합계는 14MB까지입니다. 1개 이상 · 256개 이하 |
max_tokens | 아니요 | Kimi K3.1 Pro의 |
reasoning_effort | 아니요 | Kimi K3.1 Pro에서는 low, high, max를 선택하며 기본값은 max입니다. 근거 기반 개발 계획 사례에서 설정별 출력 토큰 사용량을 비교합니다. |
stop | 아니요 | Kimi K3.1 Pro의 중지 문자열을 하나 또는 최대 4개 지정합니다. Kimi K3.1 Pro에서는 일치한 표시는 최종 텍스트에 포함되지 않습니다. 1자 이상 · 1개 이상 · 4개 이하 |
tools | 아니요 | Kimi K3.1 Pro에 근거 기반 개발 계획용 OpenAI 형식 함수 정의를 최대 128개 전달합니다. Kimi K3.1 Pro에서는 인수 검증과 실행은 앱에서 처리합니다. 128개 이하 |
parallel_tool_calls | 아니요 | Kimi K3.1 Pro이 한 응답에서 여러 독립 함수를 제안하도록 허용하는 설정입니다. 각 작업 실행은 앱에서 관리합니다. 기본값: |
tool_choice | 아니요 | Kimi K3.1 Pro의 tool_choice는 auto / none / required / function를 받습니다. Kimi K3.1 Pro에서는 실행 결과는 원래 호출의 tool_call_id와 함께 돌려줍니다. |
response_format | 아니요 | Kimi K3.1 Pro에 근거 기반 개발 계획 결과를 텍스트 또는 구조화된 JSON으로 요청합니다. Kimi K3.1 Pro에서는 반환된 JSON이 필요한 필드를 충족하는지 검증합니다. |
요금
입력 $2 / 출력 $10 100만 토큰당
활용 사례
저장소 단위의 코드 리뷰와 마이그레이션 계획
소스 트리, 실패하는 테스트, 변경 요청을 하나의 호출에 담고, 파일과 줄 번호로 짚을 수 있는 지적 사항을 요청하십시오. 답변이 여러 파일에 걸친 호출을 따라가야 하면 high 또는 max를 쓰고, 각 단계마다 확인 방법을 붙인 의존성 순서의 계획을 요청하십시오.
긴 문서 더미를 대상으로 한 리서치
논문, 사건 기록, 녹취록마다 라벨을 붙이고, 두 자료가 서로 다를 때 어느 버전이 우선하는지 지정한 뒤, 각 결론 옆에 출처를 명시한 답변을 요청하십시오. 컨텍스트 창이 충분히 커서 자료를 나누지 않고 전체를 한눈에 유지할 수 있습니다.
스크린샷과 클립을 보는 에이전트
작업과 함께 인터페이스 스크린샷이나 짧은 녹화를 보내고, 에이전트가 호출할 수 있는 도구를 정의한 다음, 작업이 끝날 때까지 도구 결과를 바탕으로 반복하게 하십시오. 실제로 클릭하고, 쓰고, 배포하는 주체는 여러분의 코드로 남겨 두십시오.
지저분한 입력에서 구조화된 데이터 추출
청구서, 양식, 차트 이미지를 전달하고, 원하는 필드를 도구의 매개변수나 response_format으로 설명하십시오. 돌아온 결과는 데이터베이스에 들어가기 전에 반드시 검증하십시오.
프롬프트 가이드 및 실전 팁
max로 시작하고, 속도가 필요하면 낮추십시오
어려운 과제에서는 max가 기본값이자 출발점으로 알맞습니다. 필요한 답변 품질을 파악한 뒤에는 high를 시험해 보고, 깊이보다 지연 시간이 더 중요한 짧고 반복적인 대화에는 low를 쓰십시오.
max_tokens에 사고를 위한 여유를 남기십시오
사고 토큰은 max_tokens에 포함되며, 기본값은 4,096입니다. 긴 보고서, 큰 패치, high나 max로 처리하는 모든 작업에서는 읽게 될 길이보다 훨씬 크게 설정하십시오. 그렇지 않으면 보이는 답변이 시작되기 전에 예산이 소진될 수 있습니다.
긴 자료는 앞에, 질문은 마지막에
문서, 코드, 녹취록은 대화 초반에 배치하고, 각각에 짧은 이름표를 붙인 뒤, 질문은 끝에 쓰십시오. 지시 사항은 인용된 자료와 분리해 시스템 메시지에 두어, 문서 안의 문장이 요청으로 오해되지 않도록 하십시오.
temperature와 top_p는 생략하십시오
샘플링은 모델이 직접 정하므로 이 두 필드는 요청에 포함되지 않습니다. 어조와 다양성은 프롬프트로 조절하고, 답변이 특정 표시에서 끝나야 할 때는 정지 시퀀스를 사용하십시오.
Kimi K3.1 Pro로 자료를 대조합니다
입력 한도인 1,048,576토큰 안에 기획서, 출처 발췌문과 구현 제약을 함께 담습니다. 재무 검토에서는 문서별 이름과 판단 근거를 요청하고, 개발 계획에서는 의존 관계와 단계별 확인 방법을 지정합니다.
추론량과 답변을 조절합니다
K3.1 Pro는 항상 추론하며 low, high, max 중 기본값은 max입니다. 이 엔드포인트에서는 temperature와 top_p를 설정할 수 없습니다. 긴 답변은 스트리밍으로 받고 max_tokens에는 추론과 최종 답변이 모두 들어갈 여유를 둡니다.
이미지, 영상과 도구를 연결합니다
이미지나 영상에 확인할 부분을 명시하며 오디오는 보내지 않습니다. 도구 호출은 실행 제안이므로 앱에서 인수를 검증하고 실행한 뒤 일치하는 tool_call_id로 결과를 돌려줍니다. 후속 조사에서는 assistant 응답 전체를 보존합니다.
콘텐츠 허용 여부는 선택한 Kimi K3.1 Pro이 결정합니다. Kimi K3.1 Pro에서는 NSFW 동작은 달라질 수 있으며, 제한 없는 콘텐츠 처리를 보장하지 않습니다.
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'
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
