Documentazione API

Autenticazione e Base URL

L'API utilizza l'autenticazione standard con token Bearer. Ricevi la tua chiave immediatamente dopo la registrazione con Google o un indirizzo email. Imposta il Authorization header per Bearer YOUR_API_KEY per tutte le richieste. L'URL base è https://api.llmstatus.cc/v1. Questo endpoint funziona con qualsiasi SDK OpenAI o client compatibile. Devi solo modificare l'URL di base e fornire la tua chiave. Non è richiesto un numero di telefono per la registrazione. La tua identità rimane minima mentre ottieni l'accesso completo.

Prima richiesta

Invia una richiesta POST a /v1/chat/completions per ottenere una risposta immediata. L'identificatore del modello è uncensored. Gestisce contenuti per adulti, ricerca sulla sicurezza e argomenti controversi senza rifiuti. Non hai bisogno di un abbonamento o di una tariffa mensile. Gli errori non consumano il tuo credito prepagato. Invia il tuo prompt e ottieni direttamente l'output testuale.

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

Questa richiesta dimostra l'interazione più semplice possibile. Il server restituisce un oggetto JSON contenente il testo generato. Puoi regolare parametri come temperature o top_p per controllare la creatività. La risposta include le statistiche di utilizzo per trasparenza. Inizia con questa chiamata di base per verificare che la tua chiave funzioni correttamente.

Integrazione SDK Python

Utilizza l'SDK ufficiale openai Libreria Python per interagire con l'API. Configura l'URL base e la chiave API nell'inizializzazione del client. Il client gestisce la serializzazione e l'analisi degli errori per te. Questo approccio riduce significativamente il codice boilerplate. Puoi passare i messaggi come una lista di dizionari. Il modello rimane uncensored indipendentemente dal wrapper del client. Sono supportate sia la modalità streaming che quella non streaming. Questo metodo è ideale per servizi backend o script di elaborazione dati.

Copyfrom openai import OpenAI

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

L'SDK astrae i dettagli HTTP. Ti concentri sulla struttura del prompt e sulla gestione delle risposte. I codici di errore vengono sollevati come eccezioni. Puoi intercettarli per gestire limiti di frequenza o problemi di credito in modo elegante. Il codice rimane pulito e leggibile. Questo è il modo consigliato per gli sviluppatori Python per integrare l'API.

Utilizzo SDK Node.js

Installa il openai npm package for Node.js environments. Set the environment variable or pass the key directly to the constructor. The base URL must point to our service. This allows you to build serverless functions or web apps quickly. The SDK supports both CommonJS and ES modules. You can stream responses or get them in one go. The API key is passed securely in the header. This setup is perfect for JavaScript developers who need reliable text generation. No extra configuration is needed beyond the key and base URL.

Copyimport OpenAI from "openai";

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

L'SDK Node riflette la struttura del client Python. Invii messaggi e ricevi i completamenti. La gestione degli errori è integrata nella catena di promesse. Questo garantisce che la tua applicazione rimanga robusta. Usa questo metodo per interfacce chat in tempo reale o job in background. Il codice è conciso e facile da mantenere. Puoi estenderlo con intestazioni personalizzate se necessario.

Risposte in streaming

Abilita lo streaming impostando stream: true nella tua richiesta. Il server invia Server-Sent Events (SSE) token per token. Questo riduce la latenza percepita per gli utenti finali. Ricevi risposte parziali man mano che vengono generate. L'ultimo chunk contiene l'utilizzo totale dei token. Questo è cruciale per la trasparenza della fatturazione. Lo streaming funziona con tutti i parametri e gli strumenti. Usa questa modalità per le interfacce chat o la generazione di testo in diretta. Il client memorizza i token in buffer fino alla chiusura dello stream. Questo fornisce un'esperienza utente fluida senza attendere l'intera risposta.

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)

Gestisci gli eventi SSE nel tuo codice per aggiornare l'interfaccia utente in tempo reale. L'ultimo evento include i dati di utilizzo. Analizzali per monitorare accuratamente il consumo del tuo credito. Lo streaming è opzionale ma consigliato per le app interattive. Mantiene la connessione aperta fino al completamento. Questo metodo garantisce che tu paghi solo per ciò che viene generato. Gli errori durante lo streaming vengono segnalati nell'ultimo chunk.

Limiti, Errori e Finestra di Contesto

Hai una finestra di contesto di 100.000 token per prompt e completamento combinati. L'output massimo è di 16.000 token per richiesta. Il limite è di 300 richieste al minuto per chiave. Puoi avere 8 richieste concorrenti contemporaneamente. Il corpo della richiesta non può superare 8 MB. Un errore 401 significa che la tua chiave non è valida. Un errore 402 indica che non c'è più credito. Un errore 429 segnala che hai raggiunto il limite di velocità. Il credito non scade, quindi puoi ricaricare in seguito. Gli errori non addebitano il tuo credito. Usa questi codici per fare il debug della tua integrazione rapidamente. L'API è rigorosa ma prevedibile. Pianifica la tua concorrenza in base al limite di 8 richieste.