Passa al contenuto principale

Kimi Code

Libre WebUI include un plugin del provider Kimi Code per l'API di programmazione compatibile con OpenAI di Moonshot AI.

Configurare il provider​

Crea una chiave API nella console di Kimi Code, quindi salvala per il tuo utente in Impostazioni > Plugin > Kimi Code (Moonshot AI) oppure forniscila come variabile di ambiente per l'intero deployment:

KIMI_API_KEY=...

Dopo aver salvato la credenziale, attiva il plugin. I relativi modelli appariranno nel selettore dei modelli.

Modelli disponibili​

ID modelloModelloDisponibilità
k3Kimi K3Moderato e superiori; contesto fino a 1M nei livelli idonei
k3-256kKimi K3Moderato e superiori; contesto fisso di 256K
kimi-for-codingKimi K2.7 CodeTutti i membri di Kimi Code
kimi-for-coding-highspeedKimi K2.7 Code HighSpeedAllegretto e superiori; velocità maggiore e consumo di quota più elevato

Kimi documenta per K3 il supporto di una finestra di contesto fino a un milione di token per i livelli di abbonamento idonei. Libre WebUI lascia non impostato il livello di impegno del ragionamento di K3, così l'API Kimi applica il valore predefinito documentato, attualmente high.

I modelli Kimi Code scelgono valori di campionamento fissi per la modalità di ragionamento attiva. Libre WebUI non invia quindi a questo provider le impostazioni globali relative a temperatura, top-p, penalità di frequenza o penalità di presenza. Ciò segue la raccomandazione di Kimi ed evita errori di parametro non valido quando cambiano i valori predefiniti.

Endpoint API​

Il plugin incluso usa l'endpoint compatibile con OpenAI di Kimi Code:

https://api.kimi.com/coding/v1/chat/completions

L'endpoint può essere sostituito nelle variabili del plugin per gateway o proxy compatibili. Le sostituzioni HTTP sono supportate per i gateway self-hosted, ma inviano la chiave API e il contenuto della richiesta senza crittografia del trasporto. Usa HTTP soltanto su una rete attendibile e preferisci HTTPS ogni volta che il gateway supporta TLS.

Privacy e utilizzo​

Kimi Code è un provider remoto. I prompt, il contesto della conversazione e i contenuti allegati inviati tramite questo plugin vengono elaborati da Kimi secondo le sue condizioni e la sua informativa sulla privacy. Nei deployment condivisi, usa credenziali per utente affinché ogni persona controlli il proprio account, la propria quota e la fatturazione.

Kimi chiede ai client di terze parti di conservare la loro vera identità. Non configurare un proxy in modo che impersoni un altro prodotto e non modificare l'identificazione del client per ottenere un accesso diverso.

Risoluzione dei problemi​

Non autorizzato o HTTP 401

  • Verifica che la chiave API provenga dalla console di Kimi Code.
  • Verifica che il modello selezionato sia incluso nel tuo livello di abbonamento.
  • K3 richiede Moderato o superiore, mentre HighSpeed richiede Allegretto o superiore.

Il contesto di K3 è più piccolo del previsto

  • I limiti del contesto di K3 dipendono dall'abbonamento.
  • Moderato supporta per K3 un contesto più piccolo rispetto ad Allegretto e ai livelli superiori.
  • Seleziona k3-256k quando vuoi richiedere esplicitamente la route K3 da 256K con quota inferiore.
  • Avvia una nuova chat dopo aver cambiato famiglia di modelli per evitare di riutilizzare una cache di contesto incompatibile.

HTTP 429

  • Leggi il messaggio del provider mostrato nell'attività di Work. Kimi distingue tra sovraccarico temporaneo del motore, limiti delle richieste simultanee, limiti di utilizzo progressivi ed esaurimento della quota mensile.
  • Riprova dopo il ritardo indicato in caso di sovraccarico temporaneo. Per gli errori di quota è necessario attendere il ripristino o cambiare il piano dell'account.

Il modello non appare

  • Attiva il plugin Kimi Code.
  • Verifica che la chiave API sia salvata per l'utente corrente o disponibile come KIMI_API_KEY.
  • Ricarica l'elenco dei modelli dopo aver modificato le impostazioni del plugin.

Documentazione correlata​