Documentazione API: Endpoint Compatibili OpenAI

Autenticazione & URL di Base

Accedi all'API impostando la tua chiave univoca e l'URL di base nelle variabili di ambiente. L'endpoint si trova all'indirizzo https://api.apikeykimi.com/v1. Devi includere l'intestazione Authorization: Bearer YOUR_API_KEY con ogni richiesta. Questa chiave viene generata istantaneamente al momento della registrazione tramite Google o email. È l'unica credenziale necessaria per l'autenticazione. Non è necessaria la configurazione di ambiti o autorizzazioni.

Copycurl https://api.apikeykimi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "convert this json object to python dictionary syntax"}]
  }'

Endpoint Chat Completions

Invia messaggi al modello utilizzando lo standard /v1/chat/completions endpoint. endpoint. Specifica l'ID del modello come uncensored nel corpo della richiesta. L'API restituisce il testo generato in base alla cronologia dei tuoi prompt. Puoi regolare parametri come temperatura e top_p per controllare la creatività. Il modello supporta il function calling e la modalità JSON per output strutturati.

Copyfrom openai import OpenAI

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

Risposte in streaming (SSE)

Abilita la consegna dei token in tempo reale impostando stream: true nella tua richiesta. Il server restituisce uno stream di Server-Sent Events. Ogni chunk contiene testo parziale fino al completamento della risposta. Questo è ideale per le interfacce chat e le visualizzazioni di codifica in diretta. I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk dello stream.

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)

Function Calling & JSON Mode

Definisci gli strumenti o forza l'output JSON utilizzando il response_format parametro. Imposta json_object per garantire risposte JSON valide. Puoi anche passare le definizioni degli strumenti per il function calling. Il modello aderisce rigorosamente a questi vincoli. Ciò consente un'integrazione affidabile con servizi esterni. Usa tool_choice per controllare come vengono invocati gli strumenti.

Limiti dei Token & Vincoli

La finestra di contesto supporta fino a 100.000 token per input e output combinati. L'output massimo per richiesta è di 16.000 token. Se non imposti max_tokens, il limite predefinito è 2.048 token. Le richieste sono limitate a 8 MB nella dimensione del corpo. Sei limitato a 300 richieste al minuto. Solo 8 richieste possono essere eseguite simultaneamente per chiave.

Gestione degli errori & Limiti di utilizzo

Gestisci gli errori controllando il codice di stato HTTP. Un 401 indica una chiave API non valida o scaduta. Un errore 402 significa che il tuo credito prepagato è esaurito. Una risposta 429 segnala che hai superato il limite di frequenza di 300 richieste al minuto. Gli errori e i rifiuti non consumano token. Controlla il tuo saldo sul dashboard per evitare interruzioni.

Node.js

Copyimport OpenAI from "openai";

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