In breve: OpenRouter è un gateway che ti dà accesso a centinaia di modelli AI di produttori diversi con una sola chiave API e un solo credito, usando un'interfaccia compatibile con quella di OpenAI. Non aggiunge un sovrapprezzo sul costo dei token: paghi una commissione quando compri i crediti (5,5% con un minimo di $0,80, oppure 5% in criptovalute) e, se porti le tue chiavi dei provider, hai un ampio margine gratuito. In più gestisce i fallback quando un provider va in errore.
Se lavori con agenti e cambi spesso modello, OpenRouter risolve un problema pratico: non devi aprire un account, una fatturazione e un'integrazione per ogni produttore.
Come funziona
Ti registri, carichi credito e usi una sola chiave. Le richieste vanno a un unico indirizzo compatibile con OpenAI, e scegli il modello scrivendo il suo identificativo nel formato produttore/modello. Cambiare da un modello all'altro significa cambiare una stringa, e funziona con qualsiasi libreria che parla con le API di OpenAI.
const client = new OpenAI({
baseURL: 'https://openrouter.ai/api/v1',
apiKey: process.env.OPENROUTER_API_KEY,
});
const r = await client.chat.completions.create({
model: 'produttore/modello', // dal catalogo di OpenRouter
messages: [{ role: 'user', content: 'Ciao' }],
});
Supporta testo, immagini e PDF, lo streaming e strumenti come la chiamata di funzioni. Il catalogo dei modelli si consulta online oppure via API.
Costi e commissioni
- Prezzo dei token: nessun ricarico sul prezzo del modello, che è quello del provider.
- Commissione sui crediti: 5,5% (minimo $0,80) pagando con Stripe, 5% in criptovalute.
- BYOK (porta la tua chiave): se usi le chiavi dei provider, la commissione non si applica fino a $25.000 al mese di uso a prezzo di listino, poi è il 5% sull'eccedenza. Per i piani Enterprise la soglia è $200.000.
- Modelli gratuiti: ce ne sono, con limiti bassi: 50 richieste al giorno senza aver acquistato crediti, 1.000 al giorno dopo aver acquistato almeno $10.
Instradamento e fallback
Lo stesso modello può essere servito da più provider. OpenRouter passa automaticamente a un altro se il primo va in errore, e ti permette di orientare la scelta con dei suffissi: :nitro per la massima velocità, :floor per il costo più basso, :exacto per l'affidabilità nell'uso degli strumenti. Sono utili soprattutto per gli agenti, dove un errore in mezzo a una sessione lunga costa tempo.
Privacy
Per impostazione predefinita OpenRouter non registra prompt e risposte. Puoi attivare volontariamente il logging in cambio di uno sconto dell'1%. Le richieste vengono instradate solo verso provider compatibili con le tue impostazioni di privacy: per dati sensibili controlla queste impostazioni e le politiche dei singoli provider prima di mandare informazioni riservate.
Quando conviene e quando no
Conviene se:
- vuoi provare molti modelli, per esempio DeepSeek, GLM e GPT-6, senza gestire un account per ognuno;
- costruisci un agente che sceglie il modello per compito, come in OpenClaw o Hermes Agent;
- vuoi un fallback automatico per non fermare il lavoro.
Conviene meno se:
- usi un solo modello in modo intensivo: con la tua chiave diretta eviti un passaggio in più;
- ti servono funzioni specifiche di un produttore che il gateway non replica, oppure il comportamento esatto di un provider (in un mio uso con un agente di coding, un modello servito tramite gateway ha avuto interruzioni per inattività: un passaggio in più può introdurre problemi da diagnosticare);
- hai vincoli rigidi su dove passano i dati.
OpenRouter o Hugging Face?
Sono simili come idea, ma con vocazioni diverse. OpenRouter è un gateway unico con un catalogo molto ampio di modelli commerciali e aperti. Hugging Face è prima di tutto la piattaforma dove vive il mondo open source (modelli, dataset, demo), e il suo servizio di inference è un'aggiunta. Se ti interessano soprattutto i modelli aperti e vuoi scaricarli o farli girare da te, parti da Hugging Face.
Fonti
Risorsa gratuita
Vuoi iniziare con l'AI?
Scarica la guida AI da Zero — PDF gratuito, pratico, senza tecnicismi.