Guida all'integrazione API Ki

URL Base e autenticazione

L'API vive a https://api.kiapi.cc/v1. Ottieni una chiave attiva per account, visibile immediatamente dopo la registrazione tramite Google o email. Modifica la base_url nel tuo client e imposta il Authorization header per Bearer YOUR_KEY. Questo funziona con qualsiasi SDK OpenAI standard.

• Base URL: https://api.kiapi.cc/v1
• Intestazione: Authorization: Bearer YOUR_KEY

Copycurl https://api.kiapi.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch latest version from github repo"}]
  }'

Endpoint Chat Completions

Invia messaggi a POST /v1/chat/completions. Usa l'ID del modello uncensored per output illimitati. L'endpoint accetta formati di chat standard con una finestra di contesto di 100,000 token in totale. Restituisce risposte testuali senza rifiuti di contenuto per uso adulto legale. Non sono disponibili embedding o generazione di immagini.

Copyfrom openai import OpenAI

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

Risposte in streaming (SSE)

Abilita lo streaming impostando stream: true. Ricevi server-sent events (SSE) per la consegna dei token in tempo reale. L'ultimo chunk contiene le statistiche complete di utilizzo per la fatturazione. Questo è ideale per interfacce chat che richiedono risposte parziali immediate. Puoi analizzare lo stream SSE per aggiornare l'UI istantaneamente.

Copyimport OpenAI from "openai";

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

Function calling e modalità JSON

Usa response_format: {"type": "json_object"} per output JSON rigorosi. L'API supporta le definizioni degli strumenti e le scelte degli strumenti per il function calling. Puoi definire strumenti personalizzati nel tools array. Il modello risponderà con dati strutturati quando richiesto. Questo funziona insieme alla generazione di testo standard.

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)

Parametri e limiti del modello

Supporta temperature, top_p, stop, seed, e parametri di penalità. L'output massimo è di 16,000 token per richiesta. Puoi inviare fino a 300 richieste al minuto. La concorrenza è limitata a 8 richieste simultanee per chiave. Il corpo della richiesta deve rimanere sotto 8 MB. Questi limiti garantiscono prestazioni stabili per le attività di generazione senza filtri.

Utilizzo dei token e fatturazione

I token di input costano $0.15 per milione. I token di output costano $0.50 per milione. Errori e rifiuti sono gratuiti. Il credito viene ricaricato solo tramite criptovalute. Il credito prepagato non scade mai. Paghi solo per l'utilizzo effettivo dei token. Non si applicano tariffe di abbonamento mensile. Il sistema traccia l'utilizzo con precisione per la fatturazione.