IT ▾
Ottieni chiave API

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

Un cavo spostato tra due prese su una scheda di commutazione, che illustra un URL di base API modificato
Illustrazione isometrica di un editor di codice collegato con un cavo luminoso a un server API

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:

  1. L'URL di base, che decide dove va la richiesta.
  2. La chiave API, che viene emessa per provider e funziona solo sui server di quel provider.
  3. 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_limited o concurrency.
  • 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.

ErroreSintomoSoluzione
Solo host, senza /v1404 su ogni chiamataAggiungi /v1 alla fine
Percorso completo incollato404 con un percorso duplicato nell'erroreTaglia l'indirizzo a /v1
Barra finale più unione manuale del percorsoDoppia barra nell'URLLascia che l'SDK unisca il percorso
Vecchia chiave, nuovo URL401Usa la chiave emessa dal nuovo provider
Vecchio URL, nuova chiave401 dal vecchio providerCerca nel repository e nello shell il vecchio indirizzo
http:// invece di https://Errore di reindirizzamento o connessioneUsa 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.

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.

Ottieni la chiave APILeggi la documentazione