Guida rapida per utenti Kimicode

Prerequisiti

Prima di scrivere codice, crea un account su kimicode.cc con Google o email. Riceverai immediatamente una singola chiave API. Non serve verifica del telefono né carta di credito. Il tuo account inizia con $0,50 di credito di prova valido per sette giorni. Se hai bisogno di più capacità, ricarica tramite cripto (USDT su TRC20 o USDC su Base) a partire da $10. Il credito non scade mai e errori o rifiuti non consumano token.

Assicurati che il tuo ambiente di sviluppo abbia Node.js (v18+) o Python 3.8+. Questa API segue rigorosamente la specifica del client openai, il che significa che puoi sostituire il nostro endpoint senza modificare la logica della libreria. Serviamo un unico modello senza censura con l'ID uncensored.

Installa SDK

Installa l'SDK ufficiale OpenAI per il tuo linguaggio preferito. Questo garantisce la compatibilità con le funzionalità di streaming, chiamata di funzioni e modalità JSON.

Per Python, usa pip per installare la libreria standard:

• pip install openai

Per Node.js, installa il pacchetto npm:

• npm install openai

Queste librerie gestiscono automaticamente la formattazione HTTP. Non hai bisogno di un client specifico del fornitore. L'API kimicode accetta parametri standard come temperature, top_p e max_tokens.

Inizializza Client

Configura il tuo oggetto client con l'URL di base kimicode e la tua chiave API. L'URL di base è https://api.kimicode.cc/v1. Imposta api_key sul valore ricevuto alla registrazione. Questa configurazione sostituisce l'endpoint predefinito api.openai.com.

• URL di base: https://api.kimicode.cc/v1
• Modello: uncensored
• Autenticazione: Token Bearer tramite api_key

Non mescolare questa chiave con altri fornitori. Funziona esclusivamente con l'endpoint kimicode. Il client verificherà la chiave alla prima richiesta. Se la chiave non è valida, riceverai immediatamente un errore 401.

Invia una Richiesta

Invia una richiesta standard di completamento chat. L'ID del modello deve essere uncensored. Puoi regolare max_tokens fino a 32.000. Se omesso, il valore predefinito è 2.048. La finestra di contesto è di 100.000 token totali per prompt e completamento combinati.

• Input: Messaggi di testo nell'array messages.
• Output: Risposta di testo in choices[0].message.content.

Questo endpoint supporta la modalità JSON tramite response_format: {"type": "json_object"}. Non supporta embedding, immagini o audio. Concentrati sulla generazione di testo di alta qualità senza rifiuti di contenuti per argomenti adulti leciti.

Risposte in Streaming

Abilita lo streaming impostando stream: true. L'API restituisce Server-Sent Events (SSE). Ogni chunk contiene testo parziale. Le statistiche di utilizzo dei token sono incluse nell'ultimo chunk dello stream. Questo consente la visualizzazione in tempo reale dell'output senza attendere la risposta completa.

• Flag stream: Imposta a true nel corpo della richiesta.
• Tipo di evento: chat.completion.chunk
• Dati: Contiene delta.content per le parti di testo.

Lo streaming non modifica il prezzo. Paghi per i token totali elaborati. Gli errori durante lo streaming sono gestiti in modo elegante. Se la connessione si interrompe, puoi riavviare la richiesta. Il modello senza censura mantiene la coerenza anche su stream lunghi entro il limite di 100k.

Limiti, Errori e Contesto

Monitora i tuoi limiti di utilizzo: 300 richieste al minuto per chiave, 8 richieste concorrenti e un corpo della richiesta di 8 MB. Se superi il limite di richieste, ricevi un errore 429. Se il tuo credito prepagato è esaurito, ricevi un errore 402; ricarica tramite cripto per riprendere. Un errore 401 indica una chiave API non valida o mancante. Nota che le richieste fallite e i rifiuti non consumano token. Il limite rigido sui contenuti blocca i contenuti sessuali che coinvolgono minori. Tutti gli altri contenuti adulti leciti sono consentiti.

Chiamata di Funzioni

Definisci gli strumenti nel parametro tools. Il modello restituisce le chiamate di funzioni nella risposta. Usa tool_choice per imporre un comportamento specifico. Questa funzione è identica allo standard OpenAI. Analizza le chiamate nel codice ed eseguile. Invia i risultati nei messaggi successivi. L'API kimicode gestisce le definizioni in modo efficiente. Verifica che lo schema JSON sia valido. La chiamata di funzioni non richiede crediti extra oltre ai token. È ideale per agent o estrazione dati strutturati.

cURL

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

Python

Copyfrom openai import OpenAI

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