Che cos’è OpenRouter?

OpenRouter è una piattaforma che mette a disposizione un unico punto di accesso a centinaia di modelli di intelligenza artificiale provenienti da fornitori come OpenAI, Anthropic, Google, DeepSeek e altri. Grazie a un’interfaccia di programmazione (API) centralizzata, un’applicazione può inviare una domanda a OpenRouter, che a sua volta la inoltra al modello selezionato dall’utente o a quello scelto automaticamente tramite una funzione di instradamento.

Architettura di base

OpenRouter agisce da intermediario software tra l’applicazione che effettua la domanda e i sistemi che eseguono il modello AI. La richiesta arriva a OpenRouter, viene instradata al modello o al provider indicato, e la risposta ritorna nello stesso formato generale, con un’unica chiave di accesso e una contabilità centralizzata. La guida ufficiale “Quickstart” descrive l’endpoint API e i principali metodi di integrazione.

Modello vs. provider

È fondamentale distinguere modello e provider. Il modello è il sistema che genera il testo (es. Claude Sonnet 5.5); il provider è il servizio che lo mette in esecuzione, che può coincidere con il produttore o essere un’infrastruttura autorizzata diversa. OpenRouter può instradare lo stesso modello attraverso provider differenti, influenzando prestazioni, prezzi e politiche di conservazione dei dati.

Funzioni principali e limiti

Le funzioni offerte da OpenRouter, così come le regole di fallback, sono descritte nella documentazione ufficiale. I vantaggi principali includono:

    • Riduzione del costo di sperimentazione: è possibile inviare lo stesso set di richieste a più modelli, confrontare qualità, latenza e consumo di token, e scegliere il più adatto.
    • Integrazione semplificata: l’applicazione chiama un unico endpoint e modifica l’identificativo del modello quando necessario.
    • Meccanismi di fallback: in caso di errore di un provider o di un modello, OpenRouter reindirizza automaticamente la richiesta a un’alternativa configurata.

Queste funzionalità evitano di costruire da zero la logica di instradamento, ma è importante verificare che il passaggio a un altro modello non alteri contenuto, formato o tempi di risposta.

Quando OpenRouter non è la scelta ideale

Un’impresa che utilizza stabilmente un solo modello, ha già un contratto diretto soddisfacente e non necessita di percorsi alternativi può preferire mantenere l’integrazione con il produttore originale. OpenRouter introduce un soggetto aggiuntivo nel flusso tecnico e nella gestione amministrativa; chi tratta dati riservati deve verificare gli accordi, il ruolo dei fornitori di inferenza e le condizioni di trasferimento dei dati.

Primi passi: creazione account e test nella chat

Per iniziare, basta creare un account su OpenRouter e aprire la sezione Chat. Non è necessario sviluppare subito un’applicazione: si sceglie un modello disponibile e si formula una richiesta come in un normale chatbot. Il piano gratuito consente 50 richieste al giorno e include modelli gratuiti con limiti d’uso; i modelli a pagamento richiedono crediti.

Come scegliere il modello giusto

La scelta del modello dipende dal tipo di lavoro (elaborazione di testi, comprensione di immagini, programmazione, ecc.). Nella scheda di ogni modello si controllano:

    • Prezzo per milione di token in ingresso e in uscita
    • Finestra di contesto (numero massimo di token gestibili)
    • Provider disponibili
    • Capacità specifiche (ad esempio supporto per input immagine)

Non basta ordinare per prezzo più basso; un modello che deve leggere documenti illustrati deve accettare immagini, mentre un modello chiamato da un gestionale deve supportare i parametri richiesti dal software.

Test preliminare prima di un’integrazione

Prima di investire in un’integrazione, è consigliabile costruire un piccolo test con 10‑20 richieste rappresentative del lavoro reale, privi di dati personali o segreti commerciali. Per un’attività di sintesi, ad esempio, si può chiedere: «Riassumi questo testo in cinque punti, cita i passaggi che sostengono ogni affermazione e segnala ciò che non si può stabilire dal documento». Si ripetono le prove con gli stessi materiali e criteri di valutazione, annotando errori, omissioni, tempo di risposta e spesa. Il risultato fornisce un’indicazione iniziale, ma non è un campione sufficiente per validare l’uso in produzione.

Generazione della chiave API e configurazione dei limiti

Una volta verificato il test, si accede a Settings → API Keys. La chiave API è la credenziale che autorizza il software a consumare il credito dell’account. Deve essere creata per progetto, conservata in un sistema sicuro per i segreti e mai pubblicata in pagine web, repository o screenshot. È possibile impostare limiti di spesa per chiave e, per i team, definire budget, guardrail e restrizioni su modelli, provider e importi.

Formato della chiamata API

L’API utilizza una richiesta HTTP indirizzata a un endpoint comune. Il payload deve contenere:

    • Credenziale (chiave API)
    • Identificativo del modello (es. openrouter/free per i modelli gratuiti)
    • Messaggi da inviare

Non è obbligatorio usare un SDK proprietario; la documentazione fornisce esempi in Python e TypeScript e la compatibilità con gli SDK OpenAI. Per passare a un modello specifico, basta sostituire il valore di model (es. openai/gpt-5.6-luna), verificandone prima costo e disponibilità. I nomi dei modelli sono identificativi tecnici: una differenza di carattere può generare un errore. L’elenco aggiornato è disponibile nel catalogo o nell’endpoint /models API.

Modello di fatturazione e commissioni

OpenRouter fattura l’uso dei modelli sulla base dei token: si pagano separatamente i token inviati al modello (input) e quelli prodotti nella risposta (output). Un prompt con documenti allegati può costare più di una domanda breve, mentre una risposta lunga pesa soprattutto sulla tariffa di output. I prezzi sono pubblicati