엔드포인트와 별칭
공식 빠른 시작은 Moonshot API 기본 주소 https://api.moonshot.ai/v1과 Chat Completions 모델 별칭 kimi-k3를 사용합니다.
한국어
KIMI K3 API + SILLYTAVERN
Kimi K3 API 계약부터 확인하고 설정하세요
SillyTavern은 OpenAI 호환 연결로 Kimi K3에 접속할 수 있지만 모델마다 규칙이 다릅니다. 정확한 엔드포인트와 별칭부터 확인한 다음 요청 본문, 추론 블록, 공급자, 상태 코드 순서로 점검하세요.
공식 문서는 https://api.moonshot.ai/v1과 kimi-k3를 사용합니다. K3는 항상 thinking이 켜져 있으므로 K2.x thinking 블록 대신 reasoning_effort를 사용하세요.
공식 정보 확인
OpenAI 호환이 같은 파라미터를 뜻하지는 않습니다
Kimi 공식 문서는 K3 규칙을 명확히 설명합니다. 커뮤니티 검색 결과는 느린 응답, 과도한 추론, quota, 필터 형태의 응답을 점검할 단서지만 서비스 보장은 아닙니다.
추론도 응답의 일부입니다
K3는 항상 thinking이 켜져 있습니다. 스트리밍에서는 reasoning_content가 최종 content와 분리될 수 있고 여러 턴에서는 전체 assistant 메시지를 보존해야 할 수 있습니다.
공급자마다 동작이 다릅니다
호환 프런트엔드라고 해서 모든 공급자가 같은 계약을 쓰지는 않습니다. 모델 목록, 별칭, 한도, 지원 필드와 반환된 추론 블록 보존 여부를 확인하세요.
API 계약
프리셋을 건드리기 전 네 가지 확인
인증 문제와 모델 파라미터 문제를 나누어 확인하세요. 키는 환경 변수에 저장하고 Chat Completions부터 시작합니다.
최소 요청 구조
curl https://api.moonshot.ai/v1/chat/completions \
+ -H "Authorization: Bearer $MOONSHOT_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{"model":"kimi-k3","reasoning_effort":"high","messages":[{"role":"user","content":"Hello"}]}'코드는 공식 필드 이름을 보여 줍니다. OpenAI 클라이언트가 받는다는 이유로 K3 고정 필드를 추가하지 마세요.
- 01
1. Base URL
OpenAI 클라이언트의 base URL을 https://api.moonshot.ai/v1로 설정합니다. 공급자 프록시는 다른 URL을 쓸 수 있으므로 문서에 있는 주소를 사용하세요.
- 02
2. Bearer 키
Kimi API Platform에서 키를 만들고 Authorization: Bearer로 보냅니다. MOONSHOT_API_KEY나 공급자 변수에 보관하고 공개 프리셋에 실제 키를 넣지 마세요.
- 03
3. 정확한 모델 별칭
공식 K3 API 경로에는 kimi-k3를 사용합니다. 화면 이름 Kimi K3가 요청 slug와 같지 않을 수 있으므로 외부 공급자의 모델 목록에서 확인하세요.
- 04
4. assistant 턴 보존
응답에 reasoning_content가 있으면 다음 턴에 전체 assistant 메시지를 보냅니다. 보존된 thinking 필드를 삭제하면 빈 응답이나 잘못된 응답이 될 수 있습니다.
모델 전용 필드
K3는 reasoning_effort를 사용하며 K2.x 블록을 복사하지 않습니다
모든 Kimi 모델을 하나의 API처럼 취급하면 문제가 생깁니다. K3와 K2.x는 추론 제어가 다르고 익숙한 필드를 거부할 수 있습니다.
K3 추론
최상위 reasoning_effort에 low, high, max 중 하나를 지정합니다. 공식 기본값은 max이고 thinking은 계속 켜져 있습니다.
K2.x thinking
thinking 객체는 K2.x 예시에 속합니다. 공급자가 변환 계층을 명시하지 않았다면 thinking: { type: enabled }를 K3 요청에 넣지 마세요.
도구와 partial mode
K3의 tool_choice는 auto, none, required를 지원합니다. partial mode는 partial=true인 assistant 메시지를 사용하며 SillyTavern 텍스트 템플릿과는 별개입니다.
K3에서는 temperature, top_p, n, presence_penalty, frequency_penalty를 생략하세요. 공식 참조에서 고정값으로 설명합니다. 공급자 전용 제어는 해당 문서를 따르세요.
공급자 확인
같은 화면 뒤에 다른 계약이 있을 수 있습니다
Moonshot을 직접 호출할 때는 공식 행을 사용하세요. 게이트웨이나 공유 엔드포인트에서는 문서로 확인하기 전까지 각 값을 공급자 전용으로 취급합니다.
| Moonshot 공식 API | 게이트웨이 또는 외부 공급자 | |
|---|---|---|
| Base URL | https://api.moonshot.ai/v1 | 공급자가 제공한 URL 그대로 사용 |
| 모델 필드 | kimi-k3 | 표시된 slug 또는 별칭 확인 |
| 추론 제어 | reasoning_effort: low | high | max | 필드를 전달하는지 변환하는지 확인 |
| 한도와 접근 | Kimi 계정 등급과 현재 한도 | 공급자 결제, quota, RPM, TPM, 동시성 |
| 기록 | 전체 assistant 메시지 보존 | reasoning_content 보존 여부 확인 |
오류 확인
프롬프트를 다시 쓰기 전에 상태 코드를 읽으세요
코드별로 다음 확인 항목을 정리했습니다. 공급자마다 오류 문구는 다를 수 있습니다.
키가 없거나 형식이 잘못되었거나 만료되었거나 잘못된 호스트로 전송되었습니다.
Authorization 헤더, 환경 변수, 선택한 공급자와 계정 권한을 확인하세요. 키가 노출되었다면 교체하세요.
이 공급자에서 URL 경로나 모델 별칭을 사용할 수 없습니다.
base URL이 /v1로 끝나는지, 경로가 /chat/completions인지, 모델 목록에 kimi-k3 또는 문서화된 별칭이 있는지 확인하세요.
속도, 동시성, quota 또는 계정 한도에 도달했습니다.
공급자 한도 페이지를 확인하고 병렬 턴을 줄이며 컨텍스트를 짧게 만든 뒤 backoff로 재시도하세요. 커뮤니티의 보고를 공통 한도로 보지 마세요.
지원하지 않는 필드, 맞지 않는 thinking 형식 또는 불완전한 assistant 턴이 있습니다.
K2.x thinking과 K3 고정 파라미터를 제거하고 messages를 검증하세요. 필요하면 reasoning_content를 포함한 assistant 메시지를 반환하세요.
설정을 줄이는 방법
API를 연결하기 전에 페이지 옆에서 Kimi 사용
캐릭터 시트, wiki 또는 글쓰기 brief에 질문하려는 경우 Tabbit 브라우저 채팅을 사용할 수 있습니다. SillyTavern의 대체품이 아니며 ST 카드나 lorebook을 제공하지 않습니다.
01
현재 문맥 열기
캐릭터 시트, lore 페이지 또는 초안을 탭에 열어 두세요. Tabbit은 현재 페이지, 스크린샷 또는 로컬 파일을 참조할 수 있습니다.
02
실시간 선택기에서 Kimi-K3 선택
Chat 또는 새 탭 모델 선택기에서 Kimi-K3를 선택하세요. 이미지는 화면 예시이므로 설치 후 현재 목록과 접근 조건을 확인하세요.
03
읽으면서 질문하고 비교
사이드바에서 질문하거나 한 화면에서 여러 모델 답변을 비교하세요. 이 브라우저 흐름에서는 엔드포인트 설정을 건너뛰고 캐릭터 기능은 SillyTavern에 남겨 둘 수 있습니다.
역할을 구분하세요
SillyTavern과 Tabbit은 서로 다른 계층을 담당합니다
다음 작업에 맞는 도구를 선택하세요. 브라우저 채팅 바로가기는 캐릭터 카드 엔진이 아닙니다.
| SillyTavern | Tabbit | |
|---|---|---|
| API 엔드포인트와 키 | 공급자, 키, 별칭, 템플릿을 직접 설정 | 사용 가능한 내장 모델 선택 |
| 캐릭터 카드와 lorebook | SillyTavern의 핵심 흐름 | 페이지나 파일을 맥락으로 사용 |
| 추론 진단 | 공급자 응답과 확장을 확인 | API 필드를 관리하지 않고 페이지 옆에서 질문 |
| 확장과 그룹 채팅 | SillyTavern 생태계 | 서로 다른 제품 영역 |
K3 API FAQ
다음 실패한 턴에서 확인할 것
공식 Kimi K3 엔드포인트는 무엇인가요?+
공식 가이드는 https://api.moonshot.ai/v1과 /chat/completions 경로를 사용합니다. 게이트웨이는 다른 base URL을 제공할 수 있습니다.
SillyTavern에 어떤 모델 별칭을 입력하나요?+
공식 Moonshot API는 kimi-k3를 사용합니다. 다른 공급자는 현재 모델 목록의 정확한 slug를 입력하세요.
thinking과 reasoning_effort 중 무엇을 보내나요?+
K3는 reasoning_effort에 low, high, max를 사용하고 thinking은 항상 켜져 있습니다. thinking 객체는 K2.x용입니다.
응답이 느리거나 비어 있거나 추론이 긴 이유는 무엇인가요?+
K3는 항상 추론합니다. effort, 스트리밍 처리, 다음 요청에서 전체 assistant 메시지와 reasoning_content를 보존하는지 확인하세요. 커뮤니티 보고는 서비스 보장이 아닙니다.
OpenAI 프리셋을 복사하면 왜 400이 나오나요?+
temperature 같은 K3 고정 필드와 K2.x thinking을 제거한 뒤 별칭, messages, 공급자 스키마를 확인하세요.
API 키 없이 Kimi K3를 써 볼 수 있나요?+
현재 Tabbit 모델 선택기에 Kimi-K3가 표시되므로 엔드포인트를 만들지 않고 브라우저 경로를 시험할 수 있습니다. 접근과 quota는 바뀔 수 있습니다.
캐릭터의 깊이는 SillyTavern에 맡기고 페이지 질문은 Tabbit에서 하세요.
카드, lorebook, 확장이 필요하면 SillyTavern을 설정하세요. 페이지에 지금 Kimi에게 묻고 싶다면 Tabbit을 열고 현재 선택기에서 모델을 고르세요.
macOS와 Windows에서 사용할 수 있습니다. 모델 접근은 현재 에디션과 요금제에 따라 달라집니다.