Guida rapida API Kimi

Prerequisiti: installazione dell'SDK

Installa l'SDK ufficiale per il tuo linguaggio preferito per gestire autenticazione e serializzazione in modo automatico. La nostra API aderisce allo standard OpenAI, quindi qualsiasi libreria client compatibile funziona con modifiche minime alla configurazione.

Per Python, installa la libreria tramite pip. Per Node.js, usa npm o yarn. Questi strumenti gestiscono il client HTTP e l'analisi JSON per te.

Autenticazione: Impostazione della chiave API di kimi

Ottieni la tua chiave dal dashboard e passala come Authorization header. Usa l'URL di base https://api.apikimi.cc/v1 per tutte le richieste.

Memorizza la chiave in modo sicuro nelle tue variabili di ambiente o nei file di configurazione. Il formato dell'intestazione è Bearer YOUR_API_KEY.

Invio della tua prima richiesta

Invia una richiesta POST a /v1/chat/completions con il tuo ID modello uncensored. La risposta restituisce direttamente il testo generato.

Assicurati di impostare il model field correttamente. L'API restituisce l'output grezzo senza rifiuti di contenuto per gli argomenti leciti.

Risposte in streaming

Abilita lo streaming impostando stream: true nel corpo della richiesta. Questo restituisce chunk come Server-Sent Events (SSE).

Analizza il flusso SSE per visualizzare i token in tempo reale. L'ultimo chunk include le statistiche sull'utilizzo dei token per la fatturazione.

Configurazione del Function Calling

Definisci gli strumenti nel tools array all'interno della tua richiesta. Il modello restituisce chiamate a strumento invece di testo diretto quando appropriato.

Gestisci le chiamate agli strumenti nella logica della tua applicazione e invia i risultati all'API per ulteriori elaborazioni. Supporto per tool_choice consente un'applicazione rigorosa.

Gestazione degli errori e limiti

Gestisci gli errori HTTP standard: 401 per chiavi non valide, 402 per credito insufficiente e 429 per i limiti di frequenza. La finestra di contesto supporta un totale di 100,000 token.

L'output max è 16.000 token per richiesta. Gli errori non consumano credito. Regola la tua logica di retry in base al codice di errore.

cURL

Copycurl https://api.apikimi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the key differences between Rust and Go memory management"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apikimi.cc/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

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apikimi.cc/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

Copystream = 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)