kimiapikey.comGuida
URL di base Moonshot API: punta il tuo codice altrove
L'URL di base Moonshot API è solo una stringa nel tuo client in stile OpenAI e modificarlo è il modo in cui punti lo stesso codice a un provider diverso. Questa pagina mostra dove si trova quella stringa in Python, Node, curl e strumenti comuni, e come puntarla a un endpoint alternativo.
Aggiornato


Punti chiave
- L'URL di base è un'impostazione singola; il corpo della richiesta rimane nel formato chat OpenAI.
- Modifica tre cose quando cambi: URL di base, chiave API, ID del modello.
- Il nostro endpoint è https://api.kimiapikey.com/v1 e l'ID del modello è uncensored.
- È un modello ospitato in modo indipendente, non il servizio ufficiale di Moonshot, quindi ritesta i tuoi prompt.
Cosa fa effettivamente un URL di base
I client compatibili con OpenAI costruiscono ogni richiesta da due parti: un URL di base e un percorso. L'SDK li unisce, quindi una chiamata a chat.completions.create diventa un POST a <base_url>/chat/completions. I provider che seguono questo formato, tra cui Moonshot, pubblicano il proprio URL di base nella loro documentazione. Cercalo lì invece di copiarlo da un post sul forum, perché è l'unico valore che non puoi indovinare.
Il cambio di provider richiede quindi tre modifiche e nient'altro:
- L'URL di base, che decide dove va la richiesta.
- La chiave API, che viene emessa per provider e funziona solo sui server di quel provider.
- L'ID del modello, perché ogni provider nomina i propri modelli in modo diverso.
Messaggi, ruoli, streaming, strumenti e modalità JSON mantengono la stessa forma, motivo per cui la migrazione è breve. Tutto ciò che dipende da una funzionalità specifica del provider, come uno strumento di ricerca web integrato, richiederà una gestione separata.
È anche utile tenere i tre valori insieme in un blocco di configurazione o in un file di ambiente per provider. Quando l'URL di base, la chiave e l'ID del modello sono affiancati, il cambio indietro è una modifica di una riga e si evita lo stato di migrazione a metà in cui una nuova chiave è abbinata a un vecchio indirizzo.
Python: il pacchetto openai
In Python imposti l'URL di base quando crei il client. Questo esempio parla con l'endpoint di questo sito:
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": "Explain a base URL in one sentence."}],
)
print(resp.choices[0].message.content)
Se preferisci mantenere il codice libero dalle impostazioni, usa l'ambiente. L'SDK legge OPENAI_BASE_URL e OPENAI_API_KEY quando chiami OpenAI() senza argomenti, quindi un deployment può cambiare provider senza modifiche al codice. Tieni presente che questo significa anche che una variabile residua nel tuo shell può sovrascrivere un valore che hai scritto nel file.
Node e curl
Il pacchetto JavaScript ufficiale usa lo stesso nome di opzione, scritto in camel case:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.kimiapikey.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Hello" }],
stream: false,
});
console.log(resp.choices[0].message.content);
In assenza totale di SDK, l'endpoint è semplicemente l'inizio dell'indirizzo:
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":"Hello"}]}'
Lo stesso endpoint accetta anche POST /v1/responses, e GET /v1/models elenca ciò che serve. L'autenticazione richiede un token bearer nell'header Authorization in ogni caso.
Editor e interfacce chat
Gli strumenti GUI espongono l'URL di base con etichette diverse: "API base", "Override OpenAI Base URL", "Custom endpoint" o "Provider URL". Il valore che incolli è la stessa stringa del codice sopra, che termina con /v1. Non incollare l'indirizzo completo /chat/completions a meno che lo strumento non richieda l'URL completo.
Dopo il salvataggio, inserisci manualmente l'ID del modello se lo strumento non scarica l'elenco. Alcuni editor validano la chiave rispetto a un provider fisso e rifiutano valori personalizzati: in tal caso, cerca un'impostazione che attivi prima la modalità personalizzata o compatibile con OpenAI. L'articolo su l'utilizzo di una chiave API stile Kimi in Cursor illustra nel dettaglio uno di questi strumenti.
Cosa cambia quando si cambiano i provider
Un formato corrispondente non significa un comportamento corrispondente. Prima di spostare il traffico di produzione, controlla questi punti uno per uno:
- Stile dell'output. Un modello diverso scrive in modo diverso. Esegui i tuoi prompt reali, non un esempio semplice.
- Dimensioni del contesto. L'endpoint qui ha una finestra di 100.000 token per prompt più completamento. Se la tua configurazione attuale invia prompt più lunghi, tagliali prima.
- Limiti. Una chiave completa permette 8 richieste parallele e 300 al minuto. Superato uno di questi limiti, ottieni un HTTP 429 con codice
rate_limitedoconcurrency. - Funzionalità. Sono supportati streaming su SSE, tool calling e modalità JSON. Non sono supportate generazione di immagini, audio e video, embeddings e fine-tuning: si tratta di un'API solo testo.
- Nomenclatura. Il servizio esegue un modello a pesi aperti scelto per rispondere senza rifiuti di contenuto per l'uso adulto legale. Non è l'API ufficiale di Moonshot e non è un router tra fornitori.
Un modo neutro per confrontare è registrare gli stessi dieci prompt attraverso entrambi gli endpoint e leggere le risposte fianco a fianco. Questo richiede minuti e risparmia supposizioni.
Errori sull'URL base e come si presentano
La maggior parte degli errori dopo un cambio deriva dall'indirizzo, non dalla chiave. Ecco come si manifesta ogni errore e come risolverlo.
| Errore | Sintomo | Soluzione |
|---|---|---|
Solo host, senza /v1 | 404 su ogni chiamata | Aggiungi /v1 alla fine |
| Percorso completo incollato | 404 con un percorso duplicato nell'errore | Taglia l'indirizzo a /v1 |
| Barra finale più unione manuale del percorso | Doppia barra nell'URL | Lascia che l'SDK unisca il percorso |
| Vecchia chiave, nuovo URL | 401 | Usa la chiave emessa dal nuovo provider |
| Vecchio URL, nuova chiave | 401 dal vecchio provider | Cerca nel repository e nello shell il vecchio indirizzo |
http:// invece di https:// | Errore di reindirizzamento o connessione | Usa https ovunque |
Un modo veloce per trovare residui è cercare nel tuo progetto e nelle impostazioni di deployment il vecchio nome host. Cerca nei file .env, variabili CI, file Docker compose e qualsiasi impostazione dell'editor, poiché una singola copia dimenticata è sufficiente per inviare traffico al vecchio provider.
Streaming e strumenti dopo il cambio
Imposta stream: true e la risposta arriva come eventi inviati dal server, con l'utilizzo dei token riportato alla fine. Il tool calling utilizza i campi tools e tool_choice standard, con tool_calls in streaming e i risultati inviati come messaggi con role: "tool". Se il tuo codice gestisce già questi elementi per il vecchio provider, dovrebbe continuare a funzionare; conferma eseguendo una chiamata in streaming e una chiamata con tool prima di passare completamente. Ricorda che una richiesta in streaming occupa la sua slot di concorrenza fino alla fine dello stream.
Verifica dei costi prima del cambio
La fatturazione è per token: $0,15 per 1M di token di input e $0,50 per 1M di token di output, prelevati dal credito prepagato, senza abbonamento. Le richieste fallite o rifiutate non vengono addebitate e il credito non scade. Per i prezzi di un altro provider, controlla la pagina dei prezzi corrente, poiché questi cambiano.
Un esempio pratico. Supponiamo che una richiesta abbia 2.000 token di input e 500 token di output:
- Input: 2.000 / 1.000.000 × $0,15 = $0,0003
- Output: 500 / 1.000.000 × $0,50 = $0,00025
- Totale: $0,00055 per richiesta, quindi 1.000 richieste costano $0,55
Il minimo ricarico è di $20, e ricariche più grandi aggiungono un bonus: +5% da $50, +10% da $100 e +15% da $200. Sono accettate solo cripto (USDT su TRC20, USDC su Base). I dettagli completi sono nella pagina dei prezzi, e la spiegazione specifica per Kimi è in prezzi chiave API Kimi.
Ottieni una chiave ed esegui la prima richiesta
Registrati con Google o con email e password, poi apri la pagina chiave API. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic, uno per persona, valido per 7 giorni e senza bisogno di carta. Le chiavi di prova sono limitate a 2 richieste parallele e 60 al minuto, che sono più che sufficienti per un test.
Incolla la chiave nello snippet Python sopra, eseguilo e conferma di ricevere del testo. La documentazione elenca ogni parametro, e gli header di risposta X-Request-Id e X-Balance-USD aiutano nel debug e nel monitoraggio del saldo. I prompt inviati al servizio non vengono utilizzati per l'addestramento.
Altre guide
- Chiave API Kimi non funziona: cause, soluzioni, fallback
- Usa una chiave API stile Kimi in Cursor: Guida alla configurazione
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.
Addestri sui 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
Devo modificare il codice quando cambio l'URL di base?
Di solito solo tre valori: URL di base, chiave API e ID del modello. Il formato del messaggio, lo streaming e la chiamata di funzioni restano gli stessi finché il nuovo provider li supporta.
L'URL di base deve terminare con /v1?
Sì per questo endpoint: https://api.kimiapikey.com/v1. L'SDK aggiunge /chat/completions da solo, quindi non includerlo.
È l'API ufficiale di Moonshot?
No. È un modello a pesi aperti ospitato in modo indipendente dietro un'API compatibile con OpenAI. Non è il servizio di Moonshot e non è un router tra fornitori.
Dove trovo l'ID del modello?
Chiama GET /v1/models con la tua chiave. Su questo endpoint l'ID del modello è uncensored.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.