IT ▾

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

Interfaccia di chat collegata con un cavo luminoso a un server API ospitato, che rappresenta una connessione Open WebUI

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.com tramite 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.

  1. Accedi a Open WebUI come amministratore e apri il Pannello di amministrazione, poi Impostazioni, poi Connessioni.
  2. Trova la sezione API OpenAI e aggiungi una nuova connessione con il pulsante più.
  3. Nel campo URL inserisci https://api.abliteratedapi.com/v1. Fermati a /v1. Non aggiungere /chat/completions; Open WebUI aggiunge il percorso da solo.
  4. Incolla la tua chiave nel campo chiave. Viene inviata come Authorization: Bearer <key>.
  5. 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

SintomoCausa probabileSoluzione
Elenco modelli vuotoURL o chiave erratiEsegui il test curl per /v1/models. L'URL deve terminare con /v1.
Connessione rifiutata o timeout da DockerNessun HTTPS in uscita dal containerControlla le impostazioni DNS, proxy e firewall sull'host.
Errore di autenticazione su ogni messaggioChiave incollata con spazi o chiave vecchiaRicopia la chiave dalla pagina delle chiavi e salva di nuovo.
Errori quando più persone chattano contemporaneamenteLimiti di richiesteUna chiave completa permette 8 richieste concorrenti e 300 al minuto; una chiave di prova ne permette 2 e 60.
Le chat lunghe smettono di funzionareFinestra di contesto pienaLa 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.

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