Documentazione API & Guida Rapida

Autenticazione & URL di Base

Avvia ogni richiesta puntando il tuo client verso HTTPS://api.uncensoredia.com/v1 e allegando la tua chiave. Autorizzazione usa lo standard Bearer schema, quindi incolla semplicemente il token ricevuto dopo la registrazione con Google o email. L'endpoint è completamente API compatibile con openai conforme, il che significa che devi solo sostituire il base_url e la chiave API nella tua configurazione esistente. Non devi gestire layer di routing complessi o intestazioni proxy. Assicurati solo che il tuo Authorization header contiene il tuo token univoco. Questa configurazione garantisce che le tue richieste raggiungano il modello uncensored dedicato senza alcun filtro intermedio. Se ricevi un 401 errore, verifica che la tua chiave sia attiva e formattata correttamente.

Endpoint Chat Completions

Invia messaggi a POST /v1/chat/completions per ricevere risposte testuali dal modello senza censure. Questo singolo endpoint gestisce tutte le tue esigenze di generazione, dai prompt semplici alle conversazioni complesse a più turni. Puoi controllare la lunghezza e la casualità dell'output utilizzando parametri come max_tokens, temperature, e top_p. Il modello supporta un'enorme 100.000 token finestra di contesto, permettendoti di inserire documentazione estesa o lunghe cronologie di conversazione. Puoi inviare fino a 16.000 token nella risposta. Se ometti max_tokens, il limite predefinito è 2.048 token. Questo endpoint non supporta la generazione di immagini o audio. È strettamente testo in, testo out. Usa il seguente comando curl per testare la tua connessione immediatamente.

Integrazione SDK Python

Utilizza la libreria Python ufficiale di OpenAI per interagire con l'API con modifiche minime al codice. Devi solo sovrascrivere il base_url e api_key nella configurazione del client. Questo approccio garantisce che la tua logica esistente per la gestione delle risposte, degli errori e dei ritentativi rimanga intatta. La libreria gestisce automaticamente la serializzazione JSON e lo streaming se la abiliti. Questo metodo è ideale per servizi backend o script che devono elaborare grandi volumi di testo. Il modello uncensored risponde alle richieste standard di completamento chat senza richiedere logica di parsing personalizzata. Configura il client una volta e usalo in tutta la tua applicazione. Ecco come inizializzare il client e inviare una richiesta di base.

Setup SDK Node.js

Integra l'API nelle tue applicazioni JavaScript o TypeScript utilizzando il @anthropic-ai/sdk o l' openai pacchetto. Imposta il baseURL al nostro endpoint e fornisci la tua chiave API. Questo ti permette di utilizzare metodi familiari come chat.completions.create() direttamente. L'SDK gestisce le richieste HTTP e analizza le risposte JSON per te. Puoi gestire facilmente errori come 402 (credito insufficiente) o 429 (limite di frequenza) all'interno della logica della tua applicazione. Questa configurazione è perfetta per server web, bot o qualsiasi ambiente Node.js. Il modello senza filtri funziona perfettamente con il formato di richiesta standard. Configura il tuo client per garantire la compatibilità con le aspettative dell'API.

Risposte in streaming

Abilita la consegna dei token in tempo reale impostando stream: true nella tua richiesta. L'API restituisce uno stream di Server-Sent Events (SSE), permettendoti di visualizzare il testo man mano che viene generato. Questo migliora l'esperienza utente per le interfacce chat e riduce la latenza percepita. Ogni chunk contiene una risposta parziale e l'ultimo chunk include le statistiche sull'utilizzo dei token. Puoi elaborare questi chunk in modo incrementale per costruire la risposta completa. Questa funzione è essenziale per le applicazioni che richiedono feedback immediato. Il modello uncensored supporta lo streaming per tutti i tipi di richiesta. Gestisci gli eventi dello stream per aggiornare la tua UI in modo efficiente. Usa questo codice per implementare lo streaming nel tuo client.

Limiti di frequenza e limiti di contesto

L'API impone limiti rigorosi per garantire prestazioni stabili per tutti gli utenti. Puoi inviare fino a 300 richieste al minuto per chiave e hanno 8 richieste concorrenti attivo in qualsiasi momento. La dimensione massima del corpo della richiesta è 8 MB. Se superi questi limiti, riceverai un 429 codice di stato. Assicurati di gestire i retry con backoff esponenziale per evitare di superare ripetutamente questi limiti. La finestra di contesto è di 100.000 token, ma l'output massimo è di 16.000 token. Se hai bisogno di più output, regola il max_tokens parametro. Errori come 401 (chiave non valida) e 402 (nessun credito) sono immediati e non consumano la tua allowance di token. Gestisci attentamente la tua quota per evitare interruzioni del servizio durante attività di generazione ad alto volume.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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)