kimiapikey.comDocumentazione
API Kimi: prima richiesta in cinque minuti
Ottieni la tua prima risposta in meno di cinque minuti usando l'interfaccia compatibile con OpenAI. Questa guida copre configurazione, autenticazione e utilizzo di base del modello senza censura.
Prerequisiti
Per iniziare, hai bisogno di una chiave API da kimiapikey.com. Registrati con solo email e password; non è richiesta la carta di credito per la prova. Hai anche bisogno di un ambiente di linguaggio supportato con un SDK ufficiale o compatibile installato. La nostra API segue il formato chat-completions di OpenAI, quindi il codice esistente per GPT-3.5/4 spesso funziona con modifiche minime. Assicurati che la versione del tuo SDK sia recente abbastanza da supportare il parametro base_url.
URL base e autenticazione
La nostra API risiede su https://api.kimiapikey.com/v1. L'autenticazione viene gestita tramite l'intestazione standard Authorization. Passa la tua chiave come token Bearer. Questo funziona con qualsiasi client che accetti endpoint compatibili con OpenAI. Se stai usando un proxy o un client personalizzato, assicurati che inoltri correttamente l'intestazione Authorization. L'ID del modello che richiederai è uncensored.
Prima richiesta
Invia una semplice chat completion per verificare la configurazione. Usa il comando curl sotto, sostituendo YOUR_API_KEY con la tua chiave effettiva. Questa richiesta invia un prompt breve al modello uncensored. Se va a buon fine, riceverai una risposta JSON con la risposta del modello. Controlla l'array choices per il testo generato. Se ottieni un errore 401, la tua chiave non è valida o è scaduta.
SDK Python
Usa la libreria ufficiale OpenAI Python per l'integrazione più semplice. Imposta base_url sul nostro endpoint e fornisci la tua chiave. Questo esempio mostra una chiamata di generazione di testo di base. Puoi regolare il parametro model se necessario, anche se uncensored è il valore predefinito. Questo approccio mantiene il tuo codice portabile tra diversi servizi compatibili con OpenAI.
SDK Node.js
Per progetti JavaScript/TypeScript, usa il pacchetto npm openai. Configura il client con il nostro URL base e la tua chiave API. Questo ti permette di fare richieste direttamente dal tuo ambiente Node. La sintassi rispecchia quella dell'SDK Python, garantendo coerenza se cambi linguaggio. Ricorda di gestire correttamente le risposte asincrone usando await.
Risposte in streaming
Per output in tempo reale, abilita lo streaming nel tuo SDK. Questo invia blocchi di testo mentre vengono generati, riducendo la latenza percepita. Usa il flag stream nella tua richiesta. L'SDK restituirà risposte parziali, permettendoti di aggiornare l'interfaccia utente in modo incrementale. È ideale per interfacce chat o generazione di contenuti lunghi dove il feedback immediato è prezioso.
Limiti ed errori
Ogni chiave è limitata a 300 richieste al minuto. Se superi questo limite, riceverai un errore 429. Il corpo della richiesta non deve superare 8 MB. Una finestra di contesto di 100.000 token si applica alla somma di prompt e completamento. Gli errori comuni includono 401 (chiave non valida) e 402 (credito insufficiente). Ricarica tramite il cruscotto per continuare a usare l'API. I crediti non scadono mai e non ci sono canoni mensili.
cURL
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": "Write a blunt product review of a cheap VPN."}]
}'Python
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": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Node.js
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: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Streaming
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Domande e risposte
L'API supporta la chiamata di funzioni?
Sì, l'endpoint supporta la chiamata di strumenti/funzioni nel formato standard OpenAI. Puoi definire gli strumenti nella richiesta e il modello restituirà argomenti strutturati.
Cosa succede se supero il limite di richieste?
Riceverai un errore 429 Troppe richieste. Attendi un attimo e riprova, oppure passa a un livello di credito prepagato superiore per mantenere un throughput maggiore.
Il modello è addestrato sui miei dati?
No. I prompt inviati all'API non vengono utilizzati per l'addestramento. I tuoi dati rimangono privati e non vengono usati per migliorare il modello base.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, cambia l'URL base. È tutta qui la configurazione.
Specifiche tecniche
Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.
| Voce | Valore |
|---|---|
| Formato | compatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave |
| ID modello | uncensored |
| Autenticazione | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.kimiapikey.com/v1 |
| Output massimo | fino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato) |
| Parametri | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| Function calling | sì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool |
| Streaming | sì — server-sent events; l'ultimo blocco riporta l'uso dei token |
| Finestra di contesto | 100.000 token (input + output) |
| Modalità JSON | response_format: {"type": "json_object"} |
| Concorrenza | 8 richieste contemporanee per chiave |
| Limite di frequenza | 300 richieste al minuto per chiave |
| Header | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Dimensione | fino a 8 MB per richiesta |
| Prezzo | $0,15 per 1M token in input · $0,50 per 1M in output |
| Fatturazione | credito prepagato in base all'uso reale; errori e rifiuti gratuiti |
| Bonus | +5% da $50, +10% da $100, +15% da $200 |
| Scadenza | il credito pagato non scade, nessun abbonamento |
| Ricarica | USDT (TRC20) o USDC (Base), qualsiasi importo intero da $20 a $500 |
| Prova gratuita | $0,50 per 7 giorni, senza carta · Chiave di prova: 2 richieste parallele, 60 al minuto; limiti completi (8 e 300) dopo la prima ricarica |
| Chiavi | una chiave attiva per account; una nuova sostituisce la precedente |
| Accesso | Google oppure e-mail e password |
| Contenuti | contenuti per adulti consentiti; rifiutati i contenuti sessuali con minori |
Codici di errore
Gli errori arrivano in JSON con un type fisso; le richieste fallite o rifiutate non si pagano.
| Codice | Tipo | Significato |
|---|---|---|
400 | bad_request | JSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo |
401 | missing_key · invalid_key · key_revoked | chiave mancante, errata o sostituita |
402 | no_credit | credito esaurito — ricarica e riparti subito |
403 | content_blocked | contenuti sessuali con minori — rifiutato, non addebitato |
404 | not_found | endpoint sconosciuto |
413 | request_too_large | corpo oltre 8 MB |
429 | rate_limited · concurrency | oltre 300/min o 8 in parallelo — attendi e riprova |
503 | upstream_busy | modello occupato — riprova tra pochi secondi |