kimiapikey.comGuida
Usa una chiave API stile Kimi in Cursor: guida alla configurazione
Cursor può comunicare con qualsiasi endpoint compatibile con OpenAI, quindi collegarlo a questa API richiede quattro campi e circa due minuti. Questa guida copre i valori esatti, un test che dimostra che la chiave funziona e gli errori che incontrerai più spesso.
Aggiornato

Punti chiave
- Cursor richiede tre valori: la tua chiave, il base URL https://api.kimiapikey.com/v1 e il nome del modello
uncensored. - Testa la chiave con curl prima, così un problema lato Cursor è facile da distinguere da uno lato API.
- Le modifiche in stile agent inviano prompt grandi, quindi monitora i token di input: $0,15 per 1M in entrata, $0,50 per 1M in uscita.
- La chiave di prova permette 2 richieste parallele, che l'agent di Cursor può superare. Una chiave completa ne permette 8.
La risposta breve
Se stai cercando come usare la chiave api kimi in cursor, la prima cosa da sapere è che una chiave emessa da un altro provider funziona solo con il suo endpoint. La chiave di questo sito funziona con l'endpoint del sito, e Cursor la accetta perché l'endpoint parla il formato delle chat completion di OpenAI. Incolla la chiave, punta Cursor a un diverso base URL e aggiungi un nome di modello personalizzato.
L'intera configurazione in ordine:
- Crea un account e copia la tua chiave dalla pagina delle chiavi API.
- Apri Cursor, vai su Impostazioni, poi Modelli.
- Incolla la chiave nel campo della chiave API OpenAI.
- Attiva l'override del base URL e inserisci
https://api.kimiapikey.com/v1. - Aggiungi un modello personalizzato chiamato
uncensorede selezionalo nella chat.
Il resto di questo articolo spiega ogni passaggio, ti offre un modo per testare la connessione fuori dall'editor e elenca cosa solitamente va storto.
Cosa è e cosa non è questa chiave
Questo sito vende accesso a un unico modello a pesi aperti, gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti sui contenuti per uso adulto lecito. Non è l'API ufficiale di Moonshot, Kimi o di qualsiasi altro venditore, e non è un router che inoltra la tua richiesta al modello di qualcun altro. Il nome del sito riflette ciò che le persone cercano, non chi gestisce il servizio. Se hai già una chiave da un altro vendor, continua a usarla con il suo endpoint. Le due chiavi non sono intercambiabili.
Quello che ottieni è un'API in stile OpenAI: POST /v1/chat/completions e GET /v1/models, autenticazione bearer-token, una finestra di contesto da 100.000 token, streaming, chiamata di funzioni e modalità JSON. È solo testo. Non c'è generazione di immagini, né embeddings né fine-tuning, il che conta in un editor perché le funzionalità di Cursor che dipendono da quelle non useranno questo endpoint. La spiegazione della chiave API Kimi entra nel dettaglio della denominazione e delle alternative.
Per la programmazione, "uncensored" ha un significato pratico. Il modello non si fermerà a metà di un'attività perché un nome di variabile o un fixture di test sembra sensibile. Gli strumenti di sicurezza per sistemi di tua proprietà, i parser di log pieni di stringhe brutte, gli scraper, i generatori di narrativa e i set di test di moderazione sono il tipo di lavoro che provoca rifiuti altrove. Il limite rigido rimane: nessun contenuto sessuale che coinvolga minorenni, mai.
Configurazione passo dopo passo in Cursor
1. Ottieni la chiave e il credito di prova
Registrati con Google, o con email e password. Nella pagina della chiave API puoi richiedere $0,50 di credito di prova gratuito con un clic. Non serve la carta, dura 7 giorni ed è uno a persona. È sufficiente per alcune centinaia di normali richieste di chat, così puoi completare tutta questa guida prima di pagare qualsiasi cosa.
2. Apri le impostazioni del modello
In Cursor, apri Impostazioni e trova la sezione Modelli. Le etichette del menu si spostano tra le versioni, quindi cerca un campo con nome per una chiave API OpenAI e un toggle o campo con nome per sovrascrivere il base URL OpenAI. Quelle sono le due impostazioni che contano.
3. Compila i tre valori
| Campo Cursor | Valore |
|---|---|
| Chiave API OpenAI | La tua chiave dal dashboard |
| Sovrascrivi base URL OpenAI | https://api.kimiapikey.com/v1 |
| Nome modello personalizzato | uncensored |
Inserisci il base URL esattamente come mostrato. Finisce in /v1, senza slash finale e senza /chat/completions, perché il client aggiunge il percorso da solo. Un URL incollato con il percorso completo produce un 404, e il messaggio di errore raramente dice il perché.
4. Seleziona il modello e invia un messaggio
Apri il pannello chat, scegli uncensored dall'elenco dei modelli e chiedi qualcosa di piccolo, come "scrivi una funzione che analizza le date ISO". Se una risposta va in streaming, hai finito. Se Cursor mostra un errore, non cambiare le impostazioni a caso. Vai alla sezione successiva e testa l'endpoint direttamente.
5. Conosci l'effetto collaterale dell'override
L'override del base URL si applica tipicamente a ogni modello in stile OpenAI che usi in Cursor, non solo a quello personalizzato. Se torni a un modello OpenAI standard in seguito, disattiva prima l'override, altrimenti la tua richiesta andrà a questo endpoint con un nome di modello che non serve.
Testa la chiave prima di dare la colpa all'editor
Due minuti con un terminale risparmiano un'ora di indovinare. Questa richiesta fa ciò che fa Cursor: invia una chat completion con un token bearer.
curl https://api.kimiapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the word ready."}],
"max_tokens": 20
}'
Un corpo JSON con un array choices significa che la chiave, l'URL e il nome del modello sono tutti corretti. Controlla anche le response headers. X-Balance-USD mostra il tuo credito residuo e X-Request-Id vale la pena tenerlo se mai dovessi tracciare una richiesta.
La stessa verifica in Python con l'SDK ufficiale OpenAI:
from openai import OpenAI
client = OpenAI(
base_url="https://api.kimiapikey.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ready."}],
max_tokens=20,
)
print(resp.choices[0].message.content)
Puoi anche elencare i modelli con GET /v1/models. Cursor e client simili a volte lo chiamano quando premi un pulsante di verifica, quindi una chiamata models funzionante è un buon segno. Se curl funziona e Cursor no, il problema è nelle impostazioni dell'editor, e la tabella degli errori qui sotto copre quelli soliti.
Cosa cambia quando il modello scrive codice nel tuo editor
La chat in un pannello laterale è economica. Una domanda breve con poche centinaia di token di contesto costa una frazione di centesimo. Le funzionalità dell'editor che allegano file, risultati di ricerca e cronologia conversazione costano di più perché ogni richiesta trasporta di nuovo tutto. Il modello ha una finestra di contesto di 100.000 token condivisa tra prompt e risposta, e Cursor riempirà volentieri molto di essa se alleghi una cartella grande.
Ecco un calcolo reale. Supponiamo che una richiesta trasporti 40.000 token di input e il modello scriva 1.500 token di risposta:
- Input: 40.000 / 1.000.000 x $0,15 = $0,006
- Output: 1.500 / 1.000.000 x $0,50 = $0,00075
- Totale: $0,00675 per richiesta, quindi 100 tali richieste costano $0,675
Questo è ben sotto un dollaro per un pomeriggio intenso, ma il lato input domina, quindi l'abitudine che fa risparmiare è allegare meno file, non fare domande più corte. Inizia una nuova chat quando l'argomento cambia, perché la vecchia cronologia viene pagata di nuovo a ogni turno.
La chiamata di funzioni è supportata dall'API, ed è ciò su cui si basano le funzionalità editor in stile agent. Il modello decide di chiamare un tool, il tuo client lo esegue e restituisce il risultato come messaggio role: "tool". Quanto bene qualsiasi modello guidi un agent in più passaggi dipende dal modello, quindi provaci su un'attività piccola prima di affidargli un refactoring. Un unico modello a pesi aperti dietro l'API significa che ottieni un unico comportamento, non un menu da cui scegliere.
Le funzionalità di Cursor che girano sui modelli propri di Cursor, come il completamento delle tab, generalmente non vengono attivate da una chiave personalizzata. Controlla la documentazione corrente di Cursor per sapere quali funzionalità accettano un endpoint OpenAI-style personalizzato, poiché questo elenco cambia tra le release.
Errori comuni e come risolverli
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| 404 o "non trovato" | Il base URL include il percorso dell'endpoint, o manca /v1 | Usa esattamente https://api.kimiapikey.com/v1 |
| 401 non autorizzato | Spazio extra o a capo nella chiave incollata, oppure una chiave vecchia | Ricopia la chiave dalla dashboard e incollala di nuovo |
| Modello non trovato | Nome del modello digitato in modo diverso | Usa uncensored, tutto minuscolo, nient'altro |
429 con codice concurrency | Troppe richieste simultanee per la tua chiave | Attendi che le richieste in corso terminino, oppure usa una chiave completa (8 concorrenti) |
429 con codice rate_limited | Più del limite per minuto | Rallenta; le chiavi di prova permettono 60 al minuto, quelle complete 300 |
429 con un'intestazione Retry-After: 5 | Sovraccarico temporaneo | Riprova dopo cinque secondi |
| Il pulsante di verifica fallisce, curl funziona | L'editor testa con un nome di modello che conosce | Salta il passaggio di verifica e invia un messaggio di chat reale |
L'errore di concorrenza merita una nota perché sorprende chi usa la chiave di prova. La prova permette 2 richieste concorrenti e un agent che avvia più operazioni in parallelo può superarle senza che tu faccia nulla. Anche una risposta in streaming occupa il suo slot fino alla fine dello streaming, quindi una risposta lunga tiene occupato uno slot per tutto il tempo. Una chiave completa permette 8 richieste concorrenti e 300 al minuto, il che è confortevole per uno sviluppatore.
Le richieste fallite e rifiutate non vengono addebitate, quindi riprovare dopo un errore non costa nulla in più. Puoi leggere i limiti completi nella pagina della documentazione.
Pagare per essa una volta esaurito il credito di prova
Non c'è un abbonamento. Ricarichi il credito prepagato con qualsiasi importo intero da $20 a $500 e le richieste lo consumano a $0,15 per 1M di token di input e $0,50 per 1M di token di output. Il credito non scade mai, quindi un mese senza coding non costa nulla. Le ricariche da $50 o più hanno un bonus: +5% da $50, +10% da $100 e +15% da $200. Puoi pagare con cripto (USDT su TRC20, USDC su Base). La pagina dei prezzi ha i numeri attuali in un unico posto.
Usando la richiesta da 40.000 input e 1.500 output di prima, una ricarica di $20 copre circa 2.960 richieste di questo tipo ($20 / $0,00675). La maggior parte delle richieste dell'editor è più piccola, quindi il numero reale è più alto. I tuoi prompt non vengono usati per il training, il che conta quando il codice che incolli appartiene a un cliente.
Quando finisci la configurazione, un primo compito sensato è uno piccolo che puoi revisionare rapidamente: un unit test per una funzione esistente, una regex con un commento lungo, o una riscrittura di un file rumoroso. Se i risultati si adattano al tuo flusso di lavoro, aggiungi credito. Se non lo fanno, hai speso pochi centesimi di credito di prova per scoprirlo.
Altre guide
- Prezzi delle chiavi API Kimi: quanto costa questa alternativa
- Integrazione della chiave API Kimi con SDK OpenAI e LangChain
- Chiave API Kimi: come funziona e quali sono le alternative
Domande frequenti
Il modello è lo stesso di Kimi ufficiale di Moonshot?
No, ospitiamo un modello a pesi aperti ottimizzato per essere senza censura. Non è GPT, Claude, Gemini, Grok, DeepSeek o il modello di nessun altro fornitore. È un modello distinto eseguito sui nostri server.
Addestrate il modello con i miei dati?
No. I tuoi prompt e le tue risposte non vengono utilizzati per l'addestramento. Valutiamo la privacy e la trasparenza, quindi i tuoi dati restano tuoi.
Quali sono i limiti di richieste?
Hai un limite di 300 richieste al minuto per chiave. La dimensione massima del corpo della richiesta è di 8 MB. Questi limiti sono progettati per garantire prestazioni stabili per tutti gli utenti.
Qual è la policy sui contenuti?
Il modello è senza censura per argomenti per adulti, controversi e creativi. Tuttavia, blocciamo i contenuti sessuali che coinvolgono minori. Questo è un limite rigido che si applica sempre, indipendentemente dal tuo livello di abbonamento.
Domande e risposte
Posso inserire una chiave Moonshot o Kimi in Cursor con questo base URL?
No. Una chiave funziona solo con l'endpoint del provider che l'ha emessa. Usa la chiave dalla tua dashboard qui, oppure mantieni l'altra chiave con l'URL del suo provider.
Quale nome del modello devo inserire in Cursor?
Inserisci uncensored, in minuscolo. È l'unico identificativo del modello servito da questa API; un nome diverso restituisce un errore modello non trovato.
Funziona con la modalità agent di Cursor?
L'API supporta la chiamata di funzioni, necessaria per le funzionalità degli agent. L'affidabilità con cui il modello completa attività complesse in più fasi varia, quindi testalo su un'attività piccola prima di una più grande.
Perché ricevo un errore 429 con la chiave di prova?
La chiave di prova consente 2 richieste parallele e 60 al minuto. Una chiave completa consente 8 richieste parallele e 300 al minuto; un'intestazione Retry-After: 5 indica un breve sovraccarico che puoi ritentare.
Il mio codice viene utilizzato per l'addestramento?
No. I prompt inviati all'API non vengono utilizzati per l'addestramento.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica il base URL. È tutta la configurazione.