Come collegare Open WebUI a CheapTokens

Open WebUI è un'interfaccia chat self-hosted che può comunicare con qualsiasi API compatibile con OpenAI. CheapTokens espone esattamente questo tipo di API, quindi puoi usarla come motore dietro la tua interfaccia chat e pagare da un unico saldo prepagato invece di mantenere un abbonamento separato per ogni modello.

Alla fine di questa guida avrai una connessione funzionante, tre modelli nel selettore dei modelli e un primo messaggio con risposta.

Cosa ti serve#

• Un'istanza Open WebUI in esecuzione su cui hai i diritti di amministratore.
• Una chiave API CheapTokens e un saldo ricaricato. Se non hai ancora una chiave, vedi La tua prima richiesta API con CheapTokens.
• L'URL di base: https://api.cheaptokens.dev/v1.

Passo 1. Apri le impostazioni di connessione#

In Open WebUI vai su Settings → Admin → Connections. Nella sezione Manage OpenAI API Connections clicca Add Connection.

Le etichette dei menu sono tratte dalla documentazione di Open WebUI, che non indica versione né data. Se la tua versione le formula diversamente, cerca la stessa sezione: connessioni compatibili con OpenAI.

Passo 2. Compila i campi#

ID dei modelli per l'allowlist:

deepseek-ai/DeepSeek-V4-Flash-0731
zai-org/GLM-5.3-Flash
MiniMaxAI/MiniMax-M2.7

Aggiungili uno per uno. L'allowlist mantiene il selettore essenziale: solo i modelli che elenchi appariranno ai tuoi utenti.

Passo 3. Verifica e salva#

Clicca Verify Connection. Open WebUI controlla l'endpoint /models del provider, e alcuni provider implementano quell'endpoint in modo diverso o non lo implementano affatto. Il salvataggio di per sé non verifica nulla.

Quindi considera la verifica un indizio, non una sentenza definitiva: se segnala un errore ma l'URL e la chiave sono corretti, mantieni gli ID dei modelli inseriti manualmente, clicca Save e prova con una chat reale nel passo successivo. Un messaggio in chat è il controllo affidabile.

Passo 4. Invia il primo messaggio#

Apri una nuova chat, scegli deepseek-ai/DeepSeek-V4-Flash-0731 nel selettore dei modelli (potrebbe apparire con questo ID) e scrivi qualcosa di breve, ad esempio "Spiega in due frasi cos'è un token." Se arriva una risposta in streaming, la connessione funziona. La richiesta viene addebitata sul tuo saldo.

Se qualcosa non funziona, la guida agli errori di connessione elenca le cause più comuni: un finale di URL sbagliato, uno spazio in più nella chiave, un saldo vuoto o un ID modello con un refuso.

Quale modello scegliere in un'interfaccia chat#

Tutti e tre i modelli condividono un unico saldo, quindi puoi cambiare nel selettore senza ricaricare altro:

• DeepSeek-V4-Flash (release 0731) è una buona scelta predefinita per la chat quotidiana. Consente fino a 32.768 token di output per risposta, quindi le risposte lunghe hanno meno probabilità di essere troncate, e ha una finestra di contesto di 380K.
• GLM-5.3-Flash ha una finestra di contesto di 390K, utile quando incolli documenti lunghi. Le risposte sono limitate a 8.192 token.
• MiniMax-M2.7 è una terza opzione con un contesto di 200K e 8.192 token di output per risposta.

Sui token di output, che di solito costituiscono la parte più lunga di una risposta in chat, tutti e tre hanno un prezzo inferiore al prezzo di riferimento di OpenRouter. Prezzi attuali:

Quanto costa un giorno di chat#

La chat viene fatturata a token, non a messaggio. Come esempio, prendi un giorno con circa 200.000 token di input e 50.000 token di output in totale. La tabella qui sotto è calcolata dai prezzi attuali e confrontata con OpenRouter.

Lo stesso carico di lavoro su MiniMax-M2.7 costa $0.0175, e i suoi prezzi di input e output sono $0.05 e $0.15 per 1M di token.

Perché si adatta a un'interfaccia chat#

• Un unico saldo prepagato per ogni modello nel selettore.
• Prezzi fissi per modello senza ore di punta.
• API compatibile con OpenAI, quindi Open WebUI non richiede plugin.

Quando il saldo si esaurisce, ricaricalo e la connessione continua a funzionare senza alcuna modifica in Open WebUI.

Checklist rapida#

1. Settings → Admin → Connections → Add Connection.
2. URL https://api.cheaptokens.dev/v1, la tua chiave API, ID dei modelli aggiunti manualmente.
3. Verify Connection, poi Save.
4. Scegli un modello in una nuova chat e invia un messaggio.

Pronto a provarlo? Ottieni una chiave API, ricarica il saldo e aggiungi la connessione in un paio di minuti.

Endpoint, ID dei modelli e limiti di ogni modello sono nella documentazione CheapTokens.