IT ▾
Ottieni chiave API

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.

Ottieni la chiave API

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.

Ottieni la chiave APILeggi la documentazione

Specifiche tecniche

Tutti i limiti e le funzioni reali dell'API in un unico posto: controllali prima di ricaricare.

VoceValore
Formatocompatibile OpenAI: qualsiasi SDK OpenAI funziona cambiando base URL e chiave
ID modellouncensored
AutenticazioneAuthorization: Bearer YOUR_KEY
EndpointPOST /v1/chat/completions · GET /v1/models
Base URLhttps://api.kimiapikey.com/v1
Output massimofino al resto della finestra di 100.000 token; max_tokens opzionale (nessun limite separato)
Parametritemperature, top_p, stop, seed, presence_penalty, frequency_penalty
Function callingsì — tools, tool_choice; risposte con tool_calls anche in streaming; risultati come role: tool
Streamingsì — server-sent events; l'ultimo blocco riporta l'uso dei token
Finestra di contesto100.000 token (input + output)
Modalità JSONresponse_format: {"type": "json_object"}
Concorrenza8 richieste contemporanee per chiave
Limite di frequenza300 richieste al minuto per chiave
HeaderX-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency
Dimensionefino a 8 MB per richiesta
Prezzo$0,15 per 1M token in input · $0,50 per 1M in output
Fatturazionecredito prepagato in base all'uso reale; errori e rifiuti gratuiti
Bonus+5% da $50, +10% da $100, +15% da $200
Scadenzail credito pagato non scade, nessun abbonamento
RicaricaUSDT (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
Chiaviuna chiave attiva per account; una nuova sostituisce la precedente
AccessoGoogle oppure e-mail e password
Contenuticontenuti 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.

CodiceTipoSignificato
400bad_requestJSON non valido, messaggi vuoti, parametro errato o contesto troppo lungo
401missing_key · invalid_key · key_revokedchiave mancante, errata o sostituita
402no_creditcredito esaurito — ricarica e riparti subito
403content_blockedcontenuti sessuali con minori — rifiutato, non addebitato
404not_foundendpoint sconosciuto
413request_too_largecorpo oltre 8 MB
429rate_limited · concurrencyoltre 300/min o 8 in parallelo — attendi e riprova
503upstream_busymodello occupato — riprova tra pochi secondi