IT ▾
Ottieni la chiave API

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.

Aggiornato

Punti chiave

  1. L'URL base è https://api.uncensoredendpoint.com/v1 e l'unico ID modello è uncensored.
  2. Sono disponibili due metodi: POST /v1/chat/completions e GET /v1/models.
  3. La finestra di contesto è di 100.000 token, prompt e completamento insieme.
  4. Una chiave completa permette 8 richieste concorrenti e 300 richieste al minuto.
Illustrazione isometrica di un tubo dati che collega un laptop a un server API

Impostazioni di connessione in breve

Se ti servono solo i valori, eccoli. Tutto il resto in questa pagina spiega come si comportano nella pratica.

ImpostazioneValore
URL di basehttps://api.uncensoredendpoint.com/v1
ID modellouncensored
Intestazione di autenticazioneAuthorization: Bearer YOUR_KEY
EndpointPOST /v1/chat/completions, GET /v1/models
Finestra di contesto100.000 token, prompt più completamento
Dimensione massima del corpo della richiesta8 MB
Limiti completi della chiave8 richieste concorrenti, 300 richieste al minuto
Limiti della chiave di prova2 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/models restituisce 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_tokens quando 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 erroreSignificatoCosa fare
rate_limitedTroppe richieste al minutoRallenta; distribuisci le chiamate nel minuto
concurrencyTroppe richieste in esecuzione contemporaneamenteAccoda dal tuo lato; limita i lavoratori paralleli a 8 (2 nella prova)
429 con Retry-After: 5Sovraccarico temporaneoAttendi 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.

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.

Ottieni chiave APILeggi la documentazione