Documentazione API Kimicode

URL Base e Autenticazione

Connettiti all'API utilizzando l'URL base fornito e una chiave token prepagata. L'autenticazione avviene passando la tua chiave API nell'intestazione della richiesta, garantendo che solo il tuo account acceda ai tuoi crediti. Iscriviti tramite Google o email per ricevere la tua chiave immediatamente senza verifica del numero di telefono.

Copycurl https://api.kimicodeapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the current rate limit for free tier users?"}]
  }'

Le tue richieste hanno come destinazione l'endpoint standard compatibile con OpenAI. Questo design ti permette di sostituire il nostro servizio senza riscrivere il codice del tuo client esistente, purché aggiorni l'URL di base e le credenziali.

Endpoint Chat Completions

Invia messaggi al modello utilizzando il POST /v1/chat/completions endpoint. Devi specificare l'ID del modello come uncensored al modello linguistico di grandi dimensioni ottimizzato in esecuzione sui nostri server. Il sistema accetta ruoli di messaggio standard come user o assistant per conversazioni multi-turno.

Copyfrom openai import OpenAI

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

Questo endpoint gestisce input testuale e restituisce testo generato. Non supporta embedding, immagini o audio. Concentrati sulla struttura del prompt per ottenere i migliori risultati dal modello uncensored.

Risposte in streaming (SSE)

Abilita la consegna dei token in tempo reale impostando il parametro stream su true nella richiesta. L'API restituisce chunk di Server-Sent Events (SSE), consentendo alla tua applicazione di visualizzare il testo mentre viene generato. L'ultimo chunk contiene le statistiche complete sull'utilizzo dei token per la fatturazione.

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)

Lo streaming riduce la latenza percepita per gli utenti finali. Puoi elaborare ogni token man mano che arriva, il che è ideale per le interfacce chat. Ricorda che lo streaming non modifica il comportamento sottostante del modello o il prezzo dei token.

Function Calling e strumenti

Definisci gli strumenti nella richiesta per consentire al modello di generare chiamate di funzioni strutturate. L'API supporta i parametri tool_choice, consentendoti di forzare il modello a utilizzare uno strumento specifico o di decidere in modo autonomo. Questa funzione funziona con i formati standard degli strumenti OpenAI, rendendo l'integrazione semplice.

Copyimport OpenAI from "openai";

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

Utilizza il function calling per estrarre dati o attivare azioni nelle tue applicazioni. Il modello interpreta le definizioni degli strumenti e restituisce oggetti JSON contenenti gli argomenti necessari. Questa capacità estende l'API oltre la semplice generazione di testo.

Modalità JSON e parametri

Imposta un output JSON rigoroso impostando response_format a {"type": "json_object"}. Questo garantisce che il modello restituisca JSON, che è cruciale per il parsing programmatico. Puoi anche regolare parametri come temperatura, top_p e sequenze di stop per controllare la creatività e la lunghezza dell'output.

Il modello supporta una finestra di contesto di 100,000 token. Questo ti permette di passare grandi quantità di contesto in una singola richiesta. L'output massimo è di 16,000 token per richiesta, o 2,048 se non specifichi max_tokens.

Limiti, Errori e Contesto

Monitora i limiti delle tue richieste per evitare interruzioni del servizio. L'API consente 300 richieste al minuto per chiave e fino a 8 richieste concorrenti. Il corpo della tua richiesta deve rimanere inferiore a 8 MB. Se superi questi limiti, riceverai un errore di limite di velocità 429.

I fallimenti di autenticazione restituiscono un errore 401 se la chiave non è valida. Un errore 402 indica credito prepagato insufficiente. Gli errori durante la generazione non consumano i tuoi token. La finestra di contesto include sia i token del prompt che quelli di completamento. Il credito non utilizzato non scade mai, garantendo che il tuo saldo prepagato rimanga disponibile per progetti futuri.