Kimi Code
Libre WebUI에는 Moonshot AI의 OpenAI 호환 코딩 API를 위한 Kimi Code 공급자 플러그인이 번들로 포함되어 있습니다.
공급자 구성하기
Kimi Code Console에서 API 키를 만든 다음, **설정 > 플러그인 > Kimi Code (Moonshot AI)**에서 사용자 계정에 저장하거나 배포 전체 환경 변수로 제공합니다.
KIMI_API_KEY=...
자격 증명을 저장한 뒤 플러그인을 활성화하세요. 그러면 해당 모델이 모델 선택기에 나타납니다.
사용 가능한 모델
| 모델 ID | 모델 | 가용성 |
|---|---|---|
k3 | Kimi K3 | Moderato 이상, 해당 요금제에서 최대 1M 컨텍스트 |
k3-256k | Kimi K3 | Moderato 이상, 고정 256K 컨텍스트 |
kimi-for-coding | Kimi K2.7 Code | 모든 Kimi Code 회원 |
kimi-for-coding-highspeed | Kimi K2.7 Code HighSpeed | Allegretto 이상, 더 빠른 속도와 더 많은 할당량 사용 |
Kimi 문서에 따르면 해당 멤버십 등급의 K3는 최대 100만 토큰 컨텍스트 창을 지원합니다. Libre WebUI는 K3의 추론 수준을 설정하지 않으므로 Kimi API가 문서화된 기본값(현재 high)을 적용합니다.
Kimi Code 모델은 활성 추론 모드에 고정된 샘플링 값을 선택합니다. 따라서 Libre WebUI는 전역 온도, top-p, 빈도 페널티 또는 존재 페널티 설정을 이 공급자에 보내지 않습니다. 이는 Kimi의 권장 사항을 따르며 기본값이 변경될 때 잘못된 매개변수 오류가 발생하지 않도록 합니다.
API 엔드포인트
번들 플러그인은 Kimi Code의 OpenAI 호환 엔드포인트를 사용합니다.
https://api.kimi.com/coding/v1/chat/completions
호환 게이트웨이나 프록시를 사용하려면 플러그인 변수에서 엔드포인트를 재정의할 수 있습니다. 자체 호스팅 게이트웨이에는 HTTP 재정의를 지원하지만, 이 경우 전송 암호화 없이 API 키와 요청 콘텐츠를 보냅니다. 신뢰할 수 있는 네트워크에서만 HTTP를 사용하고 게이트웨이가 TLS를 지원하면 항상 HTTPS를 우선하세요.
개인정보 보호와 사용
Kimi Code는 원격 공급자입니다. 이 플러그인을 통해 전송된 프롬프트, 대화 컨텍스트와 첨부 콘텐츠는 Kimi의 약관 및 개인정보 처리방침에 따라 처리됩니다. 공유 배포에서는 사용자별 자격 증명을 사용해 각 사용자가 자신의 계정, 할당량, 결제를 관리하도록 하세요.
Kimi는 타사 클라이언트가 실제 클라이언트 ID를 유지하도록 요구합니다. 다른 제품을 사칭하거나 다른 접근 권한을 얻기 위해 클라이언트 식별 정보를 변경하도록 프록시를 구성하지 마세요.
문제 해결
승인되지 않음 또는 HTTP 401
- API 키가 Kimi Code Console에서 발급된 것인지 확인합니다.
- 선택한 모델이 멤버십 등급에 포함되어 있는지 확인합니다.
- K3에는 Moderato 이상, HighSpeed에는 Allegretto 이상이 필요합니다.
K3 컨텍스트가 예상보다 작음
- K3 컨텍스트 한도는 멤버십에 따라 다릅니다.
- Moderato는 Allegretto 및 상위 등급보다 작은 K3 컨텍스트를 지원합니다.
- 할당량을 적게 사용하는 256K K3 경로를 명시적으로 사용하려면
k3-256k를 선택합니다. - 호환되지 않는 컨텍스트 캐시를 다시 사용하지 않도록 모델 제품군을 전환한 뒤 새 채팅을 시작합니다.
HTTP 429
- Work 활동에 표시된 공급자 메시지를 읽으세요. Kimi는 일시적인 엔진 과부하, 동시 요청 한도, 이동 기간 사용량 한도와 월간 할당량 소진을 구분합니다.
- 일시적인 과부하는 표시된 지연 시간 후 다시 시도하세요. 할당량 오류가 발생하면 재설정될 때까지 기다리거나 계정 요금제를 변경해야 합니다.
모델이 표시되지 않음
- Kimi Code 플러그인을 활성화합니다.
- 현재 사용자의 API 키가 저장되어 있거나
KIMI_API_KEY로 제공되는지 확인합니다. - 플러그인 설정을 변경한 뒤 모델 목록을 다시 로드합니다.