FAQ Uncensored API

Nozioni di base

Cos'è Uncensored API in una frase?

È un endpoint di completamento chat a pagamento e solo testo che serve un singolo modello, id uncensored, e non rifiuta contenuti adulti leciti, narrativa o soggetti controversi.

Quale URL devo chiamare?

Usa https://api.uncensoredapis.com/v1 come base. Le richieste chat vanno su POST /v1/chat/completions e l'elenco dei modelli è disponibile su GET /v1/models. Qualsiasi altro percorso restituisce 404.

Devo imparare un nuovo SDK?

No. La struttura delle richieste e delle risposte segue la convenzione comune delle chat completions, quindi i pacchetti ufficiali Python e Node funzionano dopo aver modificato l'URL di base e la chiave. Funziona anche curl semplice, come mostrano i docs.

C'è un modo per provarlo prima di pagare?

Sì. Un nuovo account riceve $0,50 di credito di prova gratuito, valido per 7 giorni, e non vengono richiesti dettagli di pagamento durante la registrazione. Registrati con email e password nella pagina delle chiavi e la chiave appare immediatamente.

Posso scegliere tra diversi modelli?

No. Esiste esattamente un modello e il suo id è uncensored. Una chiamata all'endpoint dei modelli restituisce quella singola voce, quindi non c'è nulla da selezionare o tra cui scegliere.

A chi è destinato il servizio?

Sviluppatori che creano prodotti per adulti, inclusi strumenti di narrativa, app di roleplay e assistenti di ricerca. Sei responsabile dei tuoi controlli sull'età e delle regole sui contenuti per ciò che rilasci.

Chiavi e accesso

Quante chiavi riceve un account?

Una. Se ne hai bisogno di una nuova, rigenerala dall'account; la chiave precedente smette di funzionare nello stesso momento, quindi distribuisci la sostituzione subito.

Dove dovrebbe risiedere la chiave?

Tienila in una variabile d'ambiente o in un gestore di segreti su un server che controlli. Il JavaScript nel browser e i binari per mobile possono essere ispezionati, quindi instrada il traffico client attraverso il tuo backend invece di incorporare la chiave.

Come viene inviata la chiave?

In un'intestazione Authorization: Bearer su ogni richiesta. Un valore mancante o errato restituisce 401 con un oggetto di errore JSON.

Voglio una chiave API senza censura per un team. Possiamo condividerne una?

Puoi, ma ogni processo condivide lo stesso limite di 300 richieste al minuto e lo stesso saldo. Metti un piccolo gateway davanti alla chiave e dai a ogni collega l'accesso al gateway invece che alla chiave stessa.

Limiti e prezzi

Quanto può essere grande un prompt?

La finestra di contesto è di 100.000 token, condivisa tra prompt e completamento. Il corpo di una singola richiesta non può superare 8 MB. Una richiesta il cui prompt più max_tokens supererebbe la finestra viene rifiutata con un 400.

Quanto può essere lunga una risposta?

Il default è 2048 token. Puoi aumentare max_tokens fino a un massimo di 32.000 per richiesta. Quando una risposta si interrompe per il limite, finish_reason restituisce length.

Quanto costa?

I token di input costano $0,25 per milione e quelli di output $1,00 per milione. Il saldo è prepagato, non c'è abbonamento e il saldo non scade mai. Consulta la tabella nella pagina prezzi.

Puoi dare una stima rapida?

Supponi un turno di chat con 1.500 token di prompt e 300 token di completamento, solo a scopo illustrativo. Questo costa $0,000375 per l'input più $0,0003 per l'output, ovvero circa $0,000675 per turno, quindi $1 acquistano circa 1.480 turni di questo tipo.

Cosa succede quando invio troppe richieste?

Ogni chiave può effettuare 300 richieste al minuto. Oltre questo limite ricevi un 429 e la risposta corretta è rallentare e riprovare con un ritardo.

Domande sull'integrazione

Quali parametri di campionamento posso impostare?

I parametri standard come temperature, top_p e stop vengono passati alla generazione. Impostali nel corpo della richiesta esattamente come faresti altrove.

L'API ricorda i turni precedenti per me?

No. Ogni richiesta è indipendente, quindi devi reinviare la conversazione in messages ogni volta. Taglia i turni più vecchi quando il totale si avvicina alla finestra di 100.000 token.

Posso trasmettere i token a un browser?

Sì, invia stream: true e leggi gli eventi inviati dal server. Fallo dal tuo backend e inoltra il testo alla pagina, in modo che la chiave non raggiunga mai il client.

È supportato il messaggio di sistema?

Sì. Inserisci un messaggio con il ruolo system come primo elemento dell'array per impostare tono, formato e limiti della conversazione.

Cosa devo controllare per primo quando l'output sembra tronco?

Leggi finish_reason. Un valore di length indica che il limite è stato raggiunto, quindi aumenta max_tokens o accorcia il prompt. Il riferimento elenca tutti i valori.

Saldo e fatturazione

Come aggiungo fondi?

Ricarica il tuo saldo prepagato dal tuo account. Non c'è nulla da abbonare e il saldo non utilizzato rimane disponibile perché non scade mai.

Cosa succede quando il credito di prova si esaurisce?

Il credito di prova è valido per 7 giorni. Dopo che è stato utilizzato o è scaduto, le richieste restituiscono 402 con il codice no_credit fino a quando non ricarichi il saldo.

Posso vedere quanto è costata una richiesta?

Ogni risposta include un blocco usage con i token di prompt, completamento e totali. Moltiplica per i prezzi per milione di token per ottenere l'addebito e tieni tu stesso un registro se vuoi una contabilità.

Le richieste fallite sono gratuite da ritentare?

Il retry è consentito, ma mantienilo limitato. Usa un backoff breve per 429 e 503 e non fare loop su 400, 401, 402 o 403, poiché non si risolvono da soli. Il playbook degli errori ha una politica pronta all'uso.

Contenuto e comportamento

Cosa non farà il modello?

I contenuti adulti legali non sono rifiutati, né la narrativa o gli argomenti controversi. L'eccezione rigida è qualsiasi contenuto sessuale che coinvolga minori, che viene bloccato con un 403 ogni volta, incluse le storie e il roleplay. Il servizio è per adulti di età superiore a 18 anni.

I miei prompt vengono usati per addestrare un modello?

No. I prompt non vengono utilizzati per l'addestramento.

In cosa differisce dal routing tramite un aggregatore?

Un aggregatore ti indirizza verso molti modelli, ognuno con le proprie regole. Questo servizio è un modello dietro una singola policy. La guida uncensored OpenRouter approfondisce questo confronto.

Può vedere immagini o creare embedding?

No. Gestisce solo testo, senza embedding, immagini, audio, video o fine-tuning.

Risoluzione dei problemi

Ottengo 402 con no_credit. Cosa faccio ora?

Il tuo saldo è esaurito o la prova è scaduta. Ricarica il saldo prepagato e invia di nuovo la richiesta.

Una richiesta restituisce upstream_busy 503.

È temporaneo. Attendi qualche secondo e riprova, usando un ritardo crescente e un po' di casualità se esegui molti worker.

Il mio stream termina e non riesco a trovare il conteggio dei token.

Con lo streaming attivo, un chunk finale contenente usage viene aggiunto automaticamente, subito prima di data: [DONE]. La sua lista choices è vuota, quindi controlla questo prima di indicizzare.

Funzionano gli strumenti e la chiamata di funzioni?

Sì, nel formato standard: passa un array tools e cerca tool_calls nella risposta.