Kimicode: prima richiesta in cinque minuti

URL di base e autenticazione

Inizia puntando il tuo client al nostro URL di base: https://api.kimicode.top/v1. Hai bisogno di una chiave API per ogni richiesta. Generane una cliccando Ottieni chiave API sul sito. Accedi con Google o con email e password. Non serve il numero di telefono. La chiave viene mostrata subito dopo la creazione. Tienila al sicuro: c'è una chiave attiva per account. Se ne generi una nuova, quella vecchia smette di funzionare. Passa la chiave nell'intestazione Authorization come token bearer.

Prima richiesta

Invia il tuo primo prompt all'endpoint delle chat completions. Usa l'ID del modello uncensored. L'API accetta formati standard compatibili con OpenAI. L'input entra, esce il testo. Errori e rifiuti sono gratuiti, paghi solo per l'utilizzo di token con successo. Testa la connettività con un prompt semplice.

Copiacurl https://api.kimicode.top/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."}]
  }'

Se la chiave non è valida, ottieni un errore 401. Se non hai credito, ottieni un 402. Controlla il saldo del tuo account se le richieste falliscono in modo imprevisto.

Integrazione SDK Python

Usa l'SDK Python ufficiale di OpenAI. Imposta l'URL di base sul nostro endpoint. Passa la tua chiave API. Il client gestisce automaticamente il formato della richiesta. Funziona per qualsiasi linguaggio che supporti client compatibili con OpenAI. Installa la libreria tramite pip. Configura il client con il tuo URL di base e la chiave. Invia un messaggio usando l'endpoint delle chat completions. La risposta contiene il testo generato. Puoi analizzare direttamente il contenuto dall'oggetto di risposta.

Copiafrom openai import OpenAI

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

Assicurati che il tuo codice gestisca le eccezioni in modo elegante. Problemi di rete o limiti di velocità potrebbero richiedere nuovi tentativi.

Utilizzo SDK Node

L'SDK Node.js funziona allo stesso modo. Importa il client. Configura l'URL di base e la chiave API. Chiama il metodo delle chat completions. Passa l'ID del modello e l'array dei messaggi. La struttura della risposta corrisponde al formato OpenAI. Estrai il contenuto del messaggio dell'assistente. Questo approccio funziona per la generazione lato server o per le edge functions. Non è necessaria alcuna configurazione aggiuntiva oltre alla modifica dell'URL di base.

Copiaimport OpenAI from "openai";

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

Gestisci gli errori controllando il codice di stato. I limiti di velocità restituiscono 429. I fondi insufficienti restituiscono 402.

Risposte in streaming

Abilita lo streaming impostando stream: true. L'API restituisce Server-Sent Events (SSE). Ogni chunk contiene contenuto parziale. I dettagli sull'utilizzo dei token appaiono nell'ultimo chunk. Questo riduce la latenza percepita per output lunghi. Gestisci correttamente la terminazione dello stream. Chiudi la connessione quando lo stream termina o si verifica un errore. Lo streaming funziona con tutti i client standard che supportano SSE.

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

Assicurati che il tuo client memorizzi correttamente gli chunk. Concatena il contenuto per formare la risposta finale.

Limiti, errori e contesto

La finestra di contesto è di 100.000 token totali. Non esiste un limite separato per l'output. Se max_tokens non è impostato, la risposta può estendersi fino alla fine della finestra. Il limite di richieste è di 300 richieste al minuto per chiave. Il limite di concorrenza è di 8 richieste simultanee. Il corpo della richiesta massimo è di 8 MB. Gli errori includono 401 per chiavi non valide, 402 per mancanza di credito e 429 per limiti di velocità. Il credito non scade mai. Gli errori sono gratuiti. Nessuna trappola di abbonamento.