Uncensored Endpoint: URL base, ID del modello e limiti
Un endpoint uncensored qui indica un'API testuale ospitata e compatibile con OpenAI che risponde senza filtri sui contenuti per uso adulto legale. Questa pagina elenca l'URL base esatto, l'ID del modello, i metodi, i limiti e i codici di errore necessari prima di scrivere codice.
Punti chiave
- L'URL base è https://api.uncensoredendpoint.com/v1 e l'unico ID modello è uncensored.
- Sono disponibili due metodi: POST /v1/chat/completions e GET /v1/models.
- La finestra di contesto è di 100.000 token, prompt e completamento insieme.
- Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto.

Impostazioni di connessione in breve
Se ti servono solo i valori, eccoli. Tutto il resto in questa pagina spiega come si comportano nella pratica.
| Impostazione | Valore |
|---|---|
| URL di base | https://api.uncensoredendpoint.com/v1 |
| ID modello | uncensored |
| Intestazione di autenticazione | Authorization: Bearer YOUR_KEY |
| Endpoint | POST /v1/chat/completions, GET /v1/models |
| Finestra di contesto | 100.000 token, prompt più completamento |
| Dimensione massima del corpo della richiesta | 8 MB |
| Limiti completi della chiave | 8 richieste concorrenti, 300 richieste al minuto |
| Limiti della chiave di prova | 2 richieste concorrenti, 60 richieste al minuto |
| Prezzo | $0,15 per 1M di token di input, $0,50 per 1M di token di output |
Il servizio usa lo stesso formato wire dell'API chat completions di OpenAI. Se uno strumento ti permette di inserire un URL base personalizzato e una chiave API, può comunicare con questo. Ottieni una chiave dalla pagina della chiave API e la documentazione contiene lo stesso riferimento in forma più breve.
Cosa fa ogni metodo
Esistono solo due route, il che mantiene l'interfaccia ridotta.
GET /v1/modelsrestituisce l'elenco dei modelli. Vedrai una voce,uncensored. Molti client usano questa route per popolare un menu a discesa dei modelli, quindi è anche un modo rapido per confermare che la tua chiave e URL siano corretti.POST /v1/chat/completionsè il cavallo di battaglia. Prende una lista di messaggi e restituisce un completamento, sia come risposta JSON unica che come stream di eventi server-sent.
La vecchia route di completamento testo, la route delle risposte, gli embedding, le route di immagine e audio non fanno parte del prodotto. Se una libreria ne usa una, prevedi un errore e passa la libreria alla modalità chat.
Un controllo rapido da terminale:
curl https://api.uncensoredendpoint.com/v1/models \
-H "Authorization: Bearer $API_KEY"
Una lista JSON che contiene uncensored significa che la chiave funziona. Un HTTP 401 significa che la chiave è mancante, digitata male o contiene spazi o newline estranei, che è la causa più comune quando la chiave proviene da una variabile di shell.
La tua prima richiesta in curl, Python e Node
Tutti e tre gli esempi inviano la stessa cosa: un messaggio di sistema, un messaggio utente, una temperatura bassa. Sostituisci YOUR_KEY o imposta la variabile d'ambiente API_KEY.
curl https://api.uncensoredendpoint.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a context window is in two sentences."}
],
"temperature": 0.7
}'
Con l'SDK Python ufficiale, passi solo due argomenti extra al client:
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredendpoint.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a context window is in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
E in Node con lo stesso SDK:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredendpoint.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are a concise assistant." },
{ role: "user", content: "Explain what a context window is in two sentences." },
],
});
console.log(resp.choices[0].message.content);
La risposta include un oggetto usage con i conteggi dei token di prompt e completamento. Tienili d'occhio: questi due numeri sono su cui vieni fatturato. Le intestazioni di risposta includono anche X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests e X-RateLimit-Limit-Concurrency. Registra l'ID richiesta con ogni chiamata, poiché è la prima cosa che il supporto chiederà se qualcosa sembra sbagliato.
Streaming, chiamata di funzioni e modalità JSON
Tre funzionalità coprono la maggior parte delle applicazioni reali e tutte e tre seguono le forme OpenAI che già conosci.
Streaming
Imposta stream: true e leggi gli eventi server-sent. L'utilizzo viene segnalato alla fine dello stream, quindi puoi ancora contare i token senza una seconda richiesta. Un dettaglio importante per la pianificazione della capacità: una richiesta in streaming occupa la sua slot di concorrenza fino al termine dello stream. Un client lento che legge una risposta lunga a gocce mantiene una slot occupata per tutto il tempo.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
Chiamata di funzioni
Passa tools e opzionalmente tool_choice. Quando il modello decide di chiamare una funzione, ricevi tool_calls nella risposta (anche in streaming, se usi lo streaming). Esegui la funzione tu stesso e invia il risultato indietro come messaggio con role: "tool". Il modello è un singolo modello a pesi aperti, quindi testa gli schemi delle tue funzioni con alcuni prompt realistici e mantieni le descrizioni dei parametri brevi e letterali.
Modalità JSON
Invia response_format: {"type":"json_object"} per richiedere un output JSON valido. Specifica anche nel prompt che vuoi JSON e descrivi i campi che ti aspetti. Analizza comunque in modo difensivo e riprova una volta in caso di errore di parsing invece di fidarti ciecamente dell'output.
I controlli di campionamento vengono passati attraverso: temperature, top_p, stop, seed e le penalità di frequenza e presenza.
La finestra da 100.000 token in pratica
La finestra di contesto è di 100.000 token e questo numero copre insieme prompt e completamento. Il completamento può usare tutto ciò che il prompt lascia libero e max_tokens è opzionale. Se invii 90.000 token di prompt, al massimo circa 10.000 rimangono per la risposta.
Una regola approssimativa per il testo inglese è che un token è un po' meno di una parola, quindi 100.000 token equivalgono a circa 70.000 parole. È sufficiente per un lungo capitolo di manoscritto, una grande porzione di un codice sorgente o diverse ore di cronologia chat. Tre abitudini mantengono questo utile:
- Taglia la cronologia per scelta. I client di chat reinviano l'intera conversazione a ogni turno, quindi i costi e la latenza crescono di conseguenza. Mantieni il system prompt, un riassunto dei turni precedenti e gli ultimi messaggi.
- Imposta
max_tokensquando la dimensione dell'output è importante. È opzionale, ma un limite ti protegge da una risposta incontrollata su un prompt lungo. - Attenzione al limite del corpo di 8 MB. È separato dalla finestra dei token. Il testo puro raramente raggiunge gli 8 MB, ma i blob in base64 incollati in un prompt potrebbero farlo.
Poiché la fatturazione è per token, una richiesta a finestra piena costa soldi veri rispetto a una breve. La pagina dei prezzi ha i tassi e puoi calcolare qualsiasi richiesta come token di input moltiplicati per $0,15 più token di output moltiplicati per $0,50, ciascuno diviso per un milione.
Limiti di velocità e la famiglia 429
Una chiave completa permette 8 richieste simultanee e 300 richieste al minuto. La chiave di prova è più restrittiva: 2 simultanee e 60 al minuto. Quando superi un limite, l'API risponde con HTTP 429 e il codice di errore ti dice quale limite è stato superato:
| Codice di errore | Significato | Cosa fare |
|---|---|---|
rate_limited | Troppe richieste al minuto | Rallenta; distribuisci le chiamate nel minuto |
concurrency | Troppe richieste in esecuzione contemporaneamente | Accoda dal tuo lato; limita i lavoratori paralleli a 8 (2 nella prova) |
429 con Retry-After: 5 | Sovraccarico temporaneo | Attendi 5 secondi, poi riprova |
La difesa più semplice è un semaforo nel tuo codice, dimensionato alla tua chiave. In Python con asyncio, asyncio.Semaphore(8) attorno a ogni chiamata rimuove completamente l'errore di concurrency. Aggiungi un retry che rispetti l'intestazione Retry-After e che preveda un breve ritardo esponenziale come fallback quando l'intestazione è assente. Ricorda che gli streaming occupano uno slot per tutta la loro durata, quindi un batch di otto streaming lunghi bloccherà una nona richiesta anche se il conteggio per minuto è basso.
Le richieste fallite o rifiutate non vengono fatturate, quindi un ciclo di retry non ti costa per i tentativi che sono stati respinti.
Cos'è il modello e cosa non è
Il servizio esegue un unico modello a pesi aperti, ospitato da un provider indipendente e ottimizzato per rispondere senza rifiuti sui contenuti per uso adulto legale. Non è l'API ufficiale di alcun grande vendor e non è un router che sceglie tra vendor. C'è un unico modello, uncensored, quindi non c'è nulla tra cui scegliere e nessun tier di prezzo da confrontare.
I limiti sono chiari. Il testo entra e il testo esce. Non genera immagini, audio o video, non offre embeddings e non offre il fine-tuning. L'unica regola fissa sui contenuti è che i contenuti sessuali che coinvolgono minorenni non sono mai permessi. I prompt non sono usati per l'addestramento.
Questa inquadratura aiuta quando pianifichi un progetto. Strumenti di finzione e roleplay per adulti, app companion, ricerche sul comportamento del modello e strumenti che gestiscono testo schietto o sensibile senza che il modello si ritiri sono tutti casi d'uso ideali. Se ti servono embedding per la ricerca, avrai bisogno di un provider separato per quella parte e puoi comunque usare questo endpoint per la generazione.
Prima di andare in produzione
Una demo funzionante richiede cinque minuti di lavoro. Un servizio affidabile richiede un po' di più. Inizia con la prova: i nuovi utenti possono richiedere $0,50 di credito con un clic nella pagina della chiave dopo la registrazione, una volta per persona, valido per 7 giorni e senza bisogno di pagamento. La registrazione funziona con Google o con email e password. Questo è sufficiente per centinaia di chiamate di test brevi per verificare la tua integrazione.
Quando passi al traffico reale, ricarica con qualsiasi importo intero da $20 a $500. Il pagamento è tramite criptovalute (USDT su TRC20, USDC su Base). Il credito non scade mai e non c'è abbonamento, quindi un saldo resta disponibile fino a quando non lo spendi. Il bonus è del 5% da $50, del 10% da $100 e del 15% da $200.
Poi lavora attraverso una breve lista: memorizza la chiave in una variabile d'ambiente o in un gestore di segreti, mai nel codice lato client; registra X-Request-Id; monitora X-Balance-USD in modo da poter inviare un alert prima che il saldo si esaurisca; limita i lavoratori paralleli; e gestisci il 429 con un ritardo invece che con un ciclo stretto. La checklist di produzione per le chiavi API passa in rassegna la gestione delle chiavi in maggiore dettaglio e la documentazione contiene il riferimento ai parametri.
Altre guide
Domande e risposte
Ho bisogno di un SDK speciale?
No. Funziona qualsiasi SDK o client OpenAI. Cambia l'URL base e la chiave, imposta il modello su uncensored e il resto del codice resta invariato.
Può generare immagini o embedding?
No. L'API è solo per il testo. Non c'è generazione di immagini, audio o video, né embedding né fine-tuning.
Cosa succede quando supero il limite di richieste?
Ottieni HTTP 429. Il codice di errore è rate_limited quando superi il numero di richieste al minuto e concurrency quando troppe richieste vengono eseguite contemporaneamente. Attendi un momento e riprova.
C'è una regola rigida sui contenuti?
Sì. I contenuti sessuali che coinvolgono minorenni non sono mai consentiti. Per tutto il resto il modello è ottimizzato per rispondere senza rifiuti, per uso adulto legale.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, cambia l'URL di base. È tutta la configurazione.