Fai girare LobeChat su un endpoint personalizzato compatibile OpenAI.

Risposta rapida: un provider personalizzato, un endpoint, una chiave.

Apri le impostazioni di LobeChat e vai alla sezione AI service provider (etichettata AI Service Provider o Language Model a seconda della release). Dato che il modulo di gestione provider è arrivato nella v1.44, puoi creare un provider personalizzato invece di appoggiarti alla voce OpenAI integrata: aggiungi un provider, dagli un id e un nome visualizzato (apisrouter / APIsRouter), scegli il tipo SDK OpenAI, poi compila la API key e l'endpoint proxy URL con https://api.apisrouter.com/v1. Nella lista dei modelli del provider, usa l'azione fetch-models per tirare ogni id servito dall'endpoint tramite /v1/models, abilita quelli che vuoi, ed esegui il controllo di connettività integrato. Da quel momento, qualsiasi assistente o conversazione può selezionare quegli id dal selettore di modelli. Il progetto ora risiede su lobehub/lobehub su GitHub (il nome del repo lobe-chat reindirizza lì), e le etichette dei menu cambiano tra le release, quindi tratta il flusso, voce provider, tipo SDK, URL, chiave, fetch, come la parte stabile piuttosto che la formulazione esatta.

Provider ID:    apisrouter
Provider Name:  APIsRouter
SDK Type:       OpenAI
API Key:        sk-YOUR-APISROUTER-KEY
API Proxy URL:  https://api.apisrouter.com/v1

Model List → Fetch models → enable ids → check

Come LobeChat instrada le richieste verso un provider.

LobeChat (circa 80K stelle su GitHub, ora sotto il nome LobeHub) è uno dei framework di chat open source più diffusi: un client web curato, assistenti con i propri prompt e modelli, un sistema di plugin, e funzionalità di knowledge base, distribuibile in una sessione browser o self-hosted con un database. Ogni voce provider descrive dove vanno le richieste e quale dialetto SDK parlare. Un provider personalizzato sul tipo SDK OpenAI invia richieste chat-completions standard al tuo proxy URL con l'id del modello come semplice stringa, che è esattamente la forma che si aspetta un gateway multi-fornitore. Una voce quindi porta l'intero catalogo: gli assistenti possono fissare claude-sonnet-4-6 per lavoro accurato mentre le conversazioni rapide fanno girare gemini-3.5-flash, senza un secondo account da nessuna parte. L'URL dell'endpoint ha una sfumatura documentata che vale la pena citare: se l'URL abbia bisogno di un suffisso /v1 dipende dal servizio dietro di esso. LobeChat aggiunge percorsi di route come /chat/completions alla base che gli dai, quindi per APIsRouter il valore corretto è https://api.apisrouter.com/v1. Il sintomo documentato di un suffisso mancante è il modello che restituisce una risposta vuota al test; se vedi questo, aggiungi /v1 e riprova.

Self-hosting: il percorso via variabile d'ambiente.

Se distribuisci LobeChat tu stesso, lo stesso instradamento può essere spedito nel container invece di essere cliccato nella UI. La coppia classica sovrascrive il provider OpenAI integrato: OPENAI_API_KEY prende la chiave gateway e OPENAI_PROXY_URL prende https://api.apisrouter.com/v1. Ogni utente di quel deployment eredita poi l'endpoint senza toccare le impostazioni. La visibilità dei modelli è controllata con la sintassi model-list: OPENAI_MODEL_LIST accetta +id per aggiungere, -id per nascondere, e id=Nome Visualizzato per rietichettare, con voci separate da virgola. Iniziare il valore con -all svuota la lista integrata così che compaiano solo i tuoi id espliciti, che è la forma pulita per un deployment curato. Le build server più recenti documentano anche una famiglia CUSTOM_PROVIDER_* (count, id, name, type, base URL, keys) per dichiarare provider personalizzati completi al momento del deploy, corrispondente a ciò che fa il modulo UI. Controlla il riferimento attuale delle variabili d'ambiente per la tua versione prima di affidartici, dato che questa superficie è più recente della coppia OPENAI_* ed è ancora in evoluzione.

OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-pro

Scegliere modelli per gli assistenti.

Poiché tutti gli assistenti fatturano attraverso una chiave, il confronto tra modelli è una modifica alle impostazioni dell'assistente. Fissa due candidati su due assistenti duplicati, esegui i tuoi prompt reali per una settimana, e leggi la spesa per modello nella console di APIsRouter accanto alla qualità di risposta che hai osservato.

• Gli assistenti sono fissaggi di modello per ruolo. Un assistente di scrittura su claude-sonnet-4-6, un assistente per risposte rapide su claude-haiku-4-5-20251001, e un assistente di ricerca su gpt-5.5 coesistono tutti dietro una voce provider.
• gemini-3.5-flash è la scelta di reattività per il modello di conversazione predefinito; la maggior parte dei turni in un framework di chat sono brevi e i modelli veloci mantengono la UI reattiva all'istante.
• deepseek-v4-pro si guadagna uno slot per conversazioni multilingue lunghe e riassunti pesanti, dove il suo comportamento a contesto lungo per token speso è l'attrattiva.
• Le conversazioni vision hanno bisogno di un id capace di vision con la capability abilitata nella config del modello del provider; LobeChat espone toggle di capability per modello nel modulo provider.
• Abilita deliberatamente un selettore a due livelli, un id veloce e un id di frontiera, e aggiungine altri solo quando un assistente reale ne ha bisogno; ogni modello abilitato è una riga che gli utenti scorrono.

Pagamento a consumo · sotto i prezzi ufficiali

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modalità di errore specifiche di LobeChat.

Una risposta vuota al controllo di connettività è la firma documentata di un problema di suffisso della base URL. Aggiungi o rimuovi il /v1 (per APIsRouter deve essere presente) e riprova prima di fare debug più a fondo. Modelli mancanti dal selettore di un assistente di solito significa che sono stati recuperati ma non abilitati nella lista modelli del provider, o il toggle del provider stesso è disattivato. Entrambi risiedono nella stessa schermata delle impostazioni dell'azione fetch. Sui deployment self-hosted, ricorda la precedenza: le variabili d'ambiente configurano i default lato server, mentre gli utenti possono comunque inserire le proprie impostazioni provider lato client a seconda dell'autenticazione e dei feature flag del tuo deployment. Se un deployment ignora il tuo OPENAI_PROXY_URL, conferma che il container si sia effettivamente riavviato con il nuovo ambiente e che la sessione client non lo stia sovrascrivendo localmente. La deriva di versione è reale qui: l'albero delle impostazioni è stato riorganizzato più di una volta (Language Model, poi AI Service Provider, con il modulo provider arrivato nella v1.44), e gli screenshot dei tutorial più vecchi non corrisponderanno ai menu attuali. I campi stessi, id, name, tipo SDK, URL, chiave, sono rimasti stabili.

Chi instrada LobeChat tramite un gateway.

• Self-hoster che fanno girare LobeChat per un team e vogliono un endpoint nel container e un log di utilizzo per tutti, invece di chiavi fornitore per utente.
• Utenti avanzati degli assistenti che fissano fornitori diversi per ruolo, Claude per la scrittura, GPT per l'analisi, DeepSeek per il volume, senza mantenere account per ciascuno.
• Utenti che vogliono modelli che la lista provider integrata non porta, abilitati recuperando il catalogo del gateway invece di attendere le release a monte.
• Sviluppatori senza accesso alla fatturazione di un dato fornitore. L'accesso basato su ricarica senza obbligo di carta rimuove la dipendenza dalla registrazione per provider.
• Persone che già instradano il loro editor, launcher, o strumenti CLI tramite un gateway e vogliono il loro framework di chat sulla stessa chiave.

Verifica l'endpoint e fai debug della prima conversazione.

Esegui prima curl sull'elenco dei modelli e tieni l'output aperto; è l'ortografia autorevole per ogni id che abiliti, sia via fetch sia a mano. Poi esegui una chat completion contro l'id che intendi rendere predefinito. Dentro LobeChat, lavora sul controllo di connettività prima delle conversazioni reali. I fallimenti di autenticazione puntano al campo chiave. Una risposta vuota punta al suffisso /v1. Errori non-trovato su un modello specifico significano che l'id abilitato non corrisponde all'elenco, cosa che accade per lo più dopo aver modificato a mano nomi visualizzati e id insieme. Una volta che le conversazioni scorrono, la console di APIsRouter mostra modello per richiesta, conteggi dei token e spesa. Un framework di chat con assistenti genera traffico su diversi modelli contemporaneamente, e la vista di utilizzo per chiave è dove l'abitudine di ciascun assistente diventa un costo che puoi vedere per modello, per giorno.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemini-3.5-flash",
       "messages":[{"role":"user","content":"ping"}]}'

Domande frequenti