Uncensored API Documentazione

Configurazione URL Base e Autenticazione

Connettiti al nostro endpoint LLM uncensored utilizzando la configurazione standard dell'SDK OpenAI. Puntando il client a HTTPS://api.openrouterabliterated.com/v1 e fornendo la tua chiave API generata nell'intestazione Authorization. Questo URL di base funziona con qualsiasi client compatibile con OpenAI, consentendoti di cambiare fornitore senza modificare il codice di integrazione.

Copycurl https://api.openrouterabliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 linux commands for disk usage"}]
  }'

L'autenticazione si basa su una singola chiave attiva per account. Quando generi una nuova chiave, quella precedente viene istantaneamente sostituita.

Prima richiesta: Chat Completions

Invia input di testo e ricevi output di testo utilizzando l'endpoint standard chat-completions. Configura l'ID del modello su "uncensored" per un modello open-weight ottimizzato per rispondere senza rifiuti per uso adulto lecito. Il modello supporta parametri come temperature, top_p e sequenze di stop per controllare il comportamento di generazione.

Copyfrom openai import OpenAI

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

Le richieste vengono addebitate in base all'utilizzo reale dei token. Errori e rifiuti non consumano il tuo credito prepagato. La finestra di contesto consente 100,000 token per prompt e completamento combinati.

Integrazione SDK Node

Inizializza il client con la tua chiave API e l'URL base specifico per garantire la compatibilità. Usa il SDK node per gestire le richieste asincrone in modo efficiente. Questa configurazione funziona sia per gli script locali che per le applicazioni server-side che richiedono output AI non censurati affidabili.

Copyimport OpenAI from "openai";

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

L'API restituisce risposte JSON strutturate. Puoi analizzare il contenuto direttamente nella logica della tua applicazione. Non è richiesto alcun routing o selezione del modello poiché serviamo un singolo modello dedicato uncensored.

Risposte in streaming e utilizzo dei token

Abilita lo streaming impostando il parametro stream su true nel payload della richiesta. L'API restituisce chunk di Server-Sent Events (SSE) per l'output in tempo reale. L'ultimo chunk contiene le statistiche complete sull'utilizzo dei token per l'accuratezza della 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 le risposte lunghe. Ogni token viene conteggiato nel tuo saldo prepagato. Puoi monitorare l'utilizzo in tempo reale mentre il modello genera testo.

Limiti di frequenza e concorrenza

Ogni chiave API è limitata a 300 richieste al minuto e 8 richieste concorrenti simultanee. La dimensione massima del corpo della richiesta è di 8 MB. Questi limiti garantiscono prestazioni stabili per applicazioni AI uncensored ad alto volume. Il superamento di questi limiti attiva un errore 429.

Implementa un exponential backoff nel tuo client per gestire i limiti di frequenza in modo elegante. Il massimo di 16,000 token per output per richiesta previene un utilizzo eccessivo delle risorse. Regola le impostazioni di concorrenza in base alle esigenze della tua applicazione.

Gestione degli errori e limiti di contesto

Gestisci gli errori HTTP standard come 401 per chiavi non valide e 402 per credito insufficiente. Lo status 429 indica esaurimento del limite di frequenza. Gli errori della finestra di contesto si verificano quando il prompt e il completion combinati superano 100,000 token. Controlla sempre il codice di stato della risposta prima di analizzare il contenuto.

Gli errori non addebitano il tuo credito prepagato. Se riscontri un errore di fatturazione, usa la pagina Supporto per la risoluzione. Il credito non scade mai, quindi puoi ritentare le richieste quando preferisci.