Aggiungi ogni modello del catalogo a Chatbox con un unico provider personalizzato.

Risposta rapida: un dialogo nelle impostazioni Model Provider.

Apri Chatbox Settings e passa alla scheda Model Provider. Clicca Add, poi Add Custom Provider. Compila il dialogo con cinque valori: un Name (APIsRouter), API Mode impostato su OpenAI API Compatible, la tua chiave in API Key, https://api.apisrouter.com/v1 in API Host, e lascia API Path sul default /chat/completions che Chatbox compila per un host che termina in /v1.

Poi aggiungi i modelli. Il pulsante Fetch tira la lista modelli dell'endpoint tramite /v1/models così puoi abilitare gli id dal catalogo direttamente, e New ti permette di digitare un id a mano se preferisci un selettore curato e breve. Clicca Check accanto al campo chiave e Chatbox esegue una richiesta live; una conferma verde significa che il provider è collegato. Abbiamo validato questo esatto flusso contro l'attuale app web di Chatbox, e lo stesso dialogo è presente nelle build desktop e mobile.

Come Chatbox parla con un provider personalizzato.

Chatbox (chatboxai su GitHub, circa 41K stelle) è uno dei client di chat AI più installati: app native per Windows, macOS e Linux, build mobile per iOS e Android, e una versione browser su web.chatboxai.app. Viene distribuito con voci proprietarie per i grandi fornitori, ciascuna che vuole la propria chiave, e il dialogo del provider personalizzato è il percorso documentato per tutto il resto.

Un provider personalizzato in modalità OpenAI API Compatible è una semplice descrizione di un endpoint: host, percorso, chiave, e una lista di id di modello. Ogni turno di conversazione diventa una richiesta chat-completions standard contro quell'host, con l'id del modello dal selettore che viaggia come stringa. A Chatbox non importa quale fornitore abbia addestrato il modello dietro un id, ed è esattamente ciò che rende utile qui un gateway multi-fornitore: una voce provider mette claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash e deepseek-v4-flash nello stesso selettore, fatturati attraverso la stessa chiave.

La differenza pratica rispetto ad impilare quattro provider proprietari non è solo meno chiavi. Le impostazioni di Chatbox si sincronizzano per dispositivo, quindi ogni account fornitore che aggiungi è un'altra chiave da incollare sul tuo telefono, il tuo laptop, e la web app. Un provider personalizzato è un incolla per dispositivo, e passare una conversazione da Claude a DeepSeek è un cambio nel selettore piuttosto che un cambio di provider.

Configurazione completa: ogni campo nel dialogo.

Name è solo un'etichetta; APIsRouter mantiene leggibile il selettore. API Mode deve essere OpenAI API Compatible, che dice a Chatbox di parlare chat completions standard; l'altra modalità nel menu a tendina è per endpoint nativi Gemini e non è ciò che vuole un gateway.

API Host e API Path si compongono nell'URL della richiesta, e questa coppia è dove le configurazioni vanno storte. Con l'host impostato su https://api.apisrouter.com/v1, il percorso è /chat/completions, e Chatbox compila esattamente questo quando riconosce un host /v1. La documentazione di Chatbox descrive anche la convenzione host nudo, dove l'host omette /v1 e il percorso ha come default /v1/chat/completions; entrambi si compongono nello stesso URL, quindi scegli una forma e lascia l'altro campo al suo default. Ciò che si rompe è mescolarli, un host /v1 con un percorso /v1/chat/completions, che produce un URL /v1/v1 raddoppiato che dà 404. Le etichette dei campi e il comportamento di autofill cambiano un po' tra le release di Chatbox, quindi fidati dell'URL composto più che della memoria.

Per i modelli, Fetch è il percorso a basso sforzo: Chatbox elenca tutto ciò che serve l'endpoint e tu attivi ciò che vuoi. New è il percorso curato: digita gli id a mano e il selettore resta breve. Ogni riga di modello ha interruttori di capability (vision, tool use); lasciali disattivati a meno che tu non sappia che il modello supporta la capability, dato che un modello non configurato viene trattato come testo semplice e questo è il default sicuro. Finisci con Check, poi inizia una conversazione e scegli un modello sotto il tuo nuovo nome provider.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (autofilled)

Models: Fetch (pull the catalog) or New (type ids)
Then:   Check → green confirmation

Scegliere modelli per un client di chat quotidiano.

Poiché ogni modello abilitato fattura attraverso una chiave, confrontare due id è un cambio nel selettore piuttosto che una decisione di account. Esegui lo stesso tipo di conversazioni su entrambi per qualche giorno, poi leggi la spesa per modello nella console di APIsRouter e mantieni ciò che si è guadagnato il posto.

• Le domande quotidiane e le riscritture rapide sono lavoro a raffica. claude-haiku-4-5-20251001 e gemini-3.5-flash rispondono abbastanza velocemente che l'app sembra istantanea, e portano bene la maggior parte del traffico quotidiano.
• Le bozze lunghe, il ragionamento attento, e le discussioni di codice si guadagnano claude-sonnet-4-6 o gpt-5.5. Tieni abilitato uno per fascia e cambia per conversazione invece che per provider.
• deepseek-v4-flash è la scelta a volume se Chatbox è la tua sidebar sempre aperta; conversazioni piccole costanti si sommano e la fascia veloce mantiene il saldo che si muove lentamente.
• Le conversazioni con input immagine hanno bisogno di un id capace di vision con l'interruttore vision abilitato su quella riga di modello; conferma la capability rispetto alla documentazione del modello prima di attivare l'interruttore.
• Abilita pochi modelli deliberatamente invece di recuperare tutto: ogni toggle è una riga del selettore, e aggiungere un altro id in seguito è una modifica di dieci secondi.

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 Chatbox.

Il percorso raddoppiato è il classico. Un 404 su ogni messaggio significa che API Host e API Path portano entrambi un /v1 o il percorso ripete ciò con cui l'host già termina; apri la voce provider e leggi i due campi come un unico URL.

Un risultato vuoto da Fetch di solito significa che la chiave è sbagliata o mancante, dato che l'elenco dei modelli è esso stesso una richiesta autenticata. Controlla il campo API Key e usa il pulsante Check, che fa emergere direttamente gli errori di autenticazione.

Un modello che dà errore solo in alcune conversazioni è di solito un interruttore di capability: vision abilitato su un modello privo di input immagine, o un flusso dipendente da strumenti che colpisce un modello con gli strumenti disattivati. Ripristina la riga del modello ai default e riabilita le capability una alla volta.

E ricorda che la voce provider vive per installazione. Aggiungere APIsRouter sul tuo desktop non configura il tuo telefono; ripeti il dialogo lì, oppure usa la condivisione di configurazione propria di Chatbox se la tua versione la offre. L'unica cosa che non richiede mai di essere ripetuta è la registrazione fornitore, dato che una chiave copre ogni modello su ogni dispositivo.

Chi instrada Chatbox tramite un gateway.

• Persone che vogliono Claude, GPT, Gemini e DeepSeek in un unico selettore senza mantenere quattro account fornitore e quattro chiavi su tre dispositivi.
• Utenti in regioni dove alcune registrazioni fornitore sono dolorose; l'accesso basato su ricarica senza obbligo di carta rimuove la dipendenza per provider.
• Sviluppatori che già instradano i loro strumenti editor e terminale tramite un gateway e vogliono il loro client di chat sulla stessa chiave e lo stesso log di utilizzo.
• Chi confronta modelli e valuta gli id su conversazioni reali prima di impegnare un progetto su uno; ogni candidato è una riga del selettore, non un account.
• Famiglie e piccoli team che standardizzano su un endpoint, un saldo, e visibilità di utilizzo per chiave invece di abbonamenti sparsi.

Verifica l'endpoint e fai debug del primo messaggio.

Dimostra prima la metà gateway fuori da Chatbox: elenca i modelli con la tua chiave, poi esegui una chat completion contro un id che intendi abilitare. Se entrambi passano, tutto ciò che resta è nel dialogo del provider.

Dentro Chatbox, il pulsante Check è il segnale più veloce. Gli errori di autenticazione sono il campo chiave. Gli errori non-trovato all'invio sono una discrepanza di id, che accade per lo più con voci New digitate a mano; copia gli id dall'output di /v1/models invece che a memoria. I 404 su ogni richiesta sono la composizione host/percorso trattata sopra.

Una volta che i messaggi scorrono, la console di APIsRouter mostra modello per richiesta, conteggi dei token e spesa. Un client di chat genera molte piccole richieste durante il giorno, e il log di utilizzo è dove quell'abitudine diventa un numero per modello, per giorno che puoi davvero leggere.

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":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Domande frequenti