Documentazione per sviluppatori

URL Base e Autenticazione

La tua chiave API autentica ogni richiesta al nostro chat-completions endpoint. Ricevi questa chiave immediatamente dopo la registrazione tramite Google o email su Ottieni la chiave API pagina. Non è richiesto un numero di telefono. Conserva la tua chiave in modo sicuro e passala nel Authorization header.

Base URL: https://api.cheapllm.cc/v1. Tutte le richieste devono includere questo header: Authorization: Bearer YOUR_API_KEY. Errori come 401 indicano una chiave mancante o non valida. Sostituisci la tua vecchia chiave in qualsiasi momento per generarne una nuova; esiste una sola chiave attiva per account.

Prima richiesta

Invia il tuo primo prompt utilizzando lo standard chat/completions endpoint. endpoint. L'ID del modello è uncensored. Questo modello open-weight risponde senza rifiuti di contenuti per uso adulto lecito, inclusi temi fiction o controversi. Hai input testuale e output testuale. Nessuna generazione di embedding o immagini.

Di seguito è riportato un esempio base di cURL. Sostituisci YOUR_API_KEY con la tua chiave. Il corpo della richiesta definisce il messaggio utente. Elaboriamo una finestra di contesto di 100.000 token (prompt + completamento). Gli errori e i rifiuti sono gratuiti, quindi testa liberamente.

• Imposta model a uncensored.
• Includi messages array.
• Aggiungi l'intestazione della tua chiave API.

Copycurl https://api.cheapllm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set timezone to UTC for all logs"}]
  }'

Integrazione SDK Python

Utilizza l'SDK Python ufficiale di OpenAI per interagire con la nostra API. Imposta l'URL di base sul nostro endpoint e fornisci la tua chiave. Questo approccio funziona con qualsiasi libreria client compatibile con OpenAI. Configura parametri come temperature e top_p come necessario. Lo streaming è supportato tramite Server-Sent Events (SSE). Questo metodo è ideale per applicazioni in tempo reale dove vuoi visualizzare i token man mano che vengono generati.

Installa la libreria con pip install openai. Inizializza il client con il nostro URL di base. Il codice sottostante mostra una semplice richiesta di completamento. Regola il contenuto del messaggio in base al tuo caso d'uso. La nostra API gestisce il routing verso il modello corretto internamente.

Copyfrom openai import OpenAI

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

Integrazione SDK Node

Per gli sviluppatori Node.js, il pacchetto npm OpenAI funziona perfettamente. Imposta l'URL di base sull'endpoint della nostra API. Questo ti consente di utilizzare pattern familiari da altri provider. Configura l'ID del modello per uncensored. Puoi anche abilitare la modalità JSON o il function calling se la tua applicazione richiede output strutturati. L'SDK gestisce l'autenticazione automaticamente quando configurato correttamente.

Installa il pacchetto con npm install openaimax_tokens per controllare la lunghezza dell'output. Gli errori vengono restituiti come codici di stato HTTP standard. Usa questo per prototipazione rapida o integrazioni in produzione.

Copyimport OpenAI from "openai";

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

Risposte in streaming tramite SSE

Abilita lo streaming impostando stream: true nella tua richiesta. L'API restituisce Server-Sent Events (SSE). Ogni chunk contiene testo parziale. L'ultimo chunk include le statistiche sull'utilizzo dei token. Questa funzione è cruciale per l'esperienza utente nelle interfacce chat. Riduce significativamente la latenza percepita. Puoi analizzare lo stream per visualizzare il testo in tempo reale.

Gestisci gli eventi dello stream nel codice client. Chiudi la connessione quando lo stream termina. La nostra API supporta fino a 8 richieste concorrenti per chiave. Questo limite garantisce un utilizzo equo. Monitora il tuo utilizzo tramite i dati dell'ultimo chunk. Gli errori durante lo streaming restituiscono comunque codici di stato appropriati. Usa questo per scenari di roleplay o conversazione continua.

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)

Limiti, Errori e Finestra di Contesto

La nostra API ha limiti rigorosi per garantire la stabilità. Puoi inviare 300 richieste al minuto per chiave. Le richieste concorrenti sono limitate a 8. I corpi delle richieste non possono superare gli 8 MB. La finestra di contesto è di 100.000 token totali. L'output massimo è di 16.000 token per richiesta (2.048 se max_tokens è non impostato). Gli errori restituiscono codici specifici: 401 per chiavi non valide, 402 per credito insufficiente e 429 per limiti di frequenza. Il credito non scade. Errori come le addebiti doppi vengono risolti tramite Supporto. La privacy è mantenuta; i prompt non vengono utilizzati per l'addestramento. Non è consentito contenuto sessuale che coinvolga minori.