Configura l'API compatibile con OpenAI di Open WebUI in 5 minuti
Per usare le impostazioni dell'API compatibile con OpenAI di open webui, aggiungi una connessione con un URL base e una chiave, e il modello appare nel selettore. Ecco la configurazione esatta per Abliterated API, da Docker alla prima chat.
Aggiornato

Punti chiave
- Il base URL è https://api.abliteratedapi.com/v1 e l'ID del modello è
uncensored. - Aggiungilo nelle impostazioni delle connessioni admin, oppure passa OPENAI_API_BASE_URL e OPENAI_API_KEY a Docker.
- Testa la chiave con curl prima, così puoi distinguere un problema della chiave da uno dell'interfaccia.
- Open WebUI è solo il front-end: paghi per token per ciò che il modello legge e scrive, e non serve una carta per iniziare.
La versione breve
Se vuoi la configurazione dell'API compatibile con OpenAI di open webui in un paragrafo: apri le impostazioni admin, aggiungi una connessione API OpenAI, imposta l'URL su https://api.abliteratedapi.com/v1, incolla la tua chiave, salva e seleziona il modello chiamato uncensored. È tutto. Open WebUI parla con qualsiasi cosa che implementi il formato delle chat completions di OpenAI, e questa API lo fa.
Il servizio è un'API testuale ospitata compatibile con OpenAI che esegue un modello a pesi aperti, ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale. È gestito da un provider indipendente e non è l'API ufficiale di alcun laboratorio di modelli. Open WebUI è solo il front-end di chat a cui punti questa API.
Prima di iniziare
- Una chiave API. Creane una nella pagina delle chiavi API. La registrazione è con Google o con email e password. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic in quella pagina, valido per 7 giorni e senza carta.
- Un Open WebUI in esecuzione. Un'installazione Docker o un'installazione pip funzionano entrambi. I passaggi seguenti coprono Docker e la schermata delle impostazioni.
- Accesso alla rete dalla macchina che esegue Open WebUI a
api.abliteratedapi.comtramite HTTPS.
Controlla la chiave prima di toccare l'interfaccia. Se questa chiamata restituisce un elenco contenente uncensored, la chiave e l'URL sono corretti:
curl https://api.abliteratedapi.com/v1/models -H "Authorization: Bearer $ABLITERATED_API_KEY"
Poi conferma che una vera generazione funzioni:
curl https://api.abliteratedapi.com/v1/chat/completions -H "Authorization: Bearer $ABLITERATED_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'Metodo 1: aggiungi la connessione nelle impostazioni
Questa è la strada più semplice e funziona su un'installazione esistente. Le etichette del menu cambiano tra le versioni di Open WebUI, quindi i nomi qui sotto potrebbero differire leggermente.
- Accedi a Open WebUI come amministratore e apri il Pannello di amministrazione, poi Impostazioni, poi Connessioni.
- Trova la sezione API OpenAI e aggiungi una nuova connessione con il pulsante più.
- Nel campo URL inserisci
https://api.abliteratedapi.com/v1. Fermati a/v1. Non aggiungere/chat/completions; Open WebUI aggiunge il percorso da solo. - Incolla la tua chiave nel campo chiave. Viene inviata come
Authorization: Bearer <key>. - Usa il pulsante di verifica accanto ai campi se la tua versione lo ha, poi salva.
Apri una nuova chat e apri il selettore del modello. Il modello uncensored dovrebbe essere nell'elenco, perché Open WebUI lo legge da GET /v1/models. Se l'elenco rimane vuoto, vai alla sezione risoluzione dei problemi di seguito.
Metodo 2: impostalo all'avvio con Docker
Per una nuova installazione, passa l'endpoint come variabili di ambiente. Open WebUI legge OPENAI_API_BASE_URL e OPENAI_API_KEY all'avvio.
# base URL: https://api.abliteratedapi.com/v1 model to pick in the UI: uncensored
docker run -d -p 3000:8080 -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1" -e OPENAI_API_KEY="$ABLITERATED_API_KEY" -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Poi visita http://localhost:3000, crea il primo account (diventerà l'amministratore) e avvia una chat. Il volume denominato mantiene le tue chat e le impostazioni quando aggiorni il container.
Una cosa che confonde molti: molte impostazioni di Open WebUI vengono salvate nel suo database dopo il primo avvio, e il valore salvato può prevalere su una variabile d'ambiente successiva. Se cambi la chiave o l'URL in Docker e non succede nulla, cambiali nella schermata Connessioni o reimposta l'impostazione memorizzata.
Impostazioni da regolare
Una volta che le chat funzionano, alcune opzioni migliorano l'esperienza e rendono il conto prevedibile.
Usa la finestra di contesto in modo sensato
La finestra di contesto è di 100.000 token, condivisa tra prompt e risposta. Open WebUI invia di nuovo la cronologia della chat per ogni messaggio, quindi una conversazione lunga diventa più costosa con ogni scambio. A $0,15 per 1M di token di input, una cronologia di 20.000 token costa $0,003 da inviare, che è economico, ma si accumula su migliaia di messaggi. Avvia una nuova chat per un nuovo argomento.
Streaming e campionamento
Open WebUI trasmette le risposte per impostazione predefinita e l'API supporta lo streaming su SSE. Nei parametri avanzati puoi impostare temperatura, top_p, sequenze di arresto, un seme per output ripetibili e le penalità. Questi vengono passati al modello. Lascia max_tokens vuoto a meno che tu non voglia un limite rigido, poiché è facoltativo.
Attività in background
Open WebUI può effettuare chiamate extra al modello in background per attività come la denominazione di una chat. Ognuna è una richiesta reale sul tuo saldo e conta verso i limiti. Se noti chiamate che non hai digitato, controlla le impostazioni del modello di attività e puntale a un modello per cui sei disposto a pagare, o disattiva le funzionalità di assistenza.
Preset e prompt di sistema
Open WebUI ti consente di salvare un preset del modello nella sua sezione workspace: un nome, un modello base, un prompt di sistema e parametri predefiniti. Creane uno su uncensored per ogni lavoro che fai spesso, come un assistente di editing, un revisore di codice o un personaggio per una sessione di narrativa interattiva. Un breve prompt di sistema che indica il ruolo, il tono e il formato delle risposte fa più di lunghe istruzioni incollate in ogni chat.
Qui aiuta il profilo del modello. È un modello a pesi aperti ottimizzato per rispondere senza rifiuti di contenuti per uso adulto legale, che si adatta a narrativa, roleplay e app di tipo compagno per adulti, dove un rifiuto nel mezzo di una scena interrompe il flusso. Non cambia il limite rigido: nessun contenuto sessuale che coinvolga minorenni, mai. Mantieni i preset e le istanze condivise entro quella regola e nel rispetto della legge del tuo paese.
Se altre persone usano la tua istanza Open WebUI, ricorda che condividono tutti la tua chiave e i suoi limiti. Una chiave completa consente 8 richieste parallele, quindi un piccolo gruppo di utenti attivi va bene, mentre un grande gruppo che chatta insieme può raggiungere il limite. Dare a ogni persona o team la propria chiave distribuisce il carico e rende il saldo più facile da tracciare.
Quanto costa l'esecuzione
Paghi solo per i token, dal credito prepagato: $0,15 per 1M di token di input e $0,50 per 1M di token di output. Le richieste fallite o rifiutate non vengono addebitate e il credito non scade mai. Un messaggio di chat tipico con 3.000 token di cronologia e una risposta di 400 token costa $0,00045 + $0,0002 = $0,00065, quindi $10 di utilizzo sono circa 15.000 messaggi.
Le ricariche vanno da $20 a $500 in qualsiasi importo intero, con +5% da $50, +10% da $100 e +15% da $200. Puoi pagare con cripto (USDT su TRC20, USDC su Base). Vedi la pagina dei prezzi per i dettagli. Il saldo rimanente viene restituito nell'intestazione X-Balance-USD di ogni risposta API, se vuoi monitorarlo da uno script.
Risoluzione dei Problemi
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Elenco modelli vuoto | URL o chiave errati | Esegui il test curl per /v1/models. L'URL deve terminare con /v1. |
| Connessione rifiutata o timeout da Docker | Nessun HTTPS in uscita dal container | Controlla le impostazioni DNS, proxy e firewall sull'host. |
| Errore di autenticazione su ogni messaggio | Chiave incollata con spazi o chiave vecchia | Ricopia la chiave dalla pagina delle chiavi e salva di nuovo. |
| Errori quando più persone chattano contemporaneamente | Limiti di richieste | Una chiave completa permette 8 richieste concorrenti e 300 al minuto; una chiave di prova ne permette 2 e 60. |
| Le chat lunghe smettono di funzionare | Finestra di contesto piena | La finestra è di 100.000 token. Avvia una nuova chat o riassumi. |
Se il test curl passa ma Open WebUI fallisce, il problema è nelle impostazioni del front end. Se il test curl fallisce, controlla prima la tua chiave e il saldo. La guida rapida della documentazione elenca ogni parametro di richiesta, e l'articolo su cos'è e non è l'API chat uncensored spiega l'ambito del modello, incluso il limite rigido: nessun contenuto sessuale che coinvolge minorenni.
Altre guide
Domande e risposte
Quale URL inserisco in Open WebUI?
Usa https://api.abliteratedapi.com/v1 e nient'altro dopo. Open WebUI aggiunge /chat/completions e /models da solo.
Quale nome del modello scelgo?
L'ID del modello è uncensored. Appare nel selettore del modello una volta salvata la connessione e caricato l'elenco dei modelli.
Ho bisogno di una carta per provarlo?
No. I nuovi utenti possono richiedere $0,50 di credito di prova con un clic nella pagina della chiave API dopo la registrazione. È valido per 7 giorni e non richiede carta.
Posso eseguirlo insieme a modelli locali?
Sì. Open WebUI supporta più connessioni contemporaneamente, quindi questo endpoint può stare accanto ai modelli locali e ciascuno appare nello stesso selettore dei modelli.
Le mie chat vengono usate per l'addestramento?
No. I prompt inviati all'API non vengono usati per l'addestramento. La cronologia delle chat memorizzata da Open WebUI rimane nella tua installazione.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.
Ottieni la chiave API