OpenRouter API key: come ottenerla e usare i modelli gratis
Crea un’API key OpenRouter, scopri i limiti dei modelli gratuiti, risolvi gli errori 401, 402 e 429 e usa OpenRouter su iPhone, Android o web.
- Per ottenere un’API key OpenRouter, accedi a openrouter.ai, apri openrouter.ai/keys e crea una chiave: inizia con «sk-or-v1-». Crearla è gratis; i modelli con l’ID che termina in «:free» si usano gratis entro limiti giornalieri, tutti gli altri si pagano con crediti prepagati.
- OpenRouter è un unico account e un’unica chiave per i modelli di molte aziende di IA. Non pubblica una propria app di chat per iPhone o Android, quindi sul telefono serve un’app di chat che accetti una chiave OpenRouter, come Oriveo.
- Al 18 novembre 2026 i modelli gratuiti consentono 20 richieste al minuto e 50 al giorno, oppure 1.000 al giorno se hai acquistato almeno 10 crediti. L’errore 402 significa che hai finito i crediti.

Che cos’è OpenRouter e che cos’è un’API key?
OpenRouter è un servizio che ti dà accesso ai modelli di molte aziende di IA con un solo account. Invece di registrarti presso ogni azienda, aggiungi crediti su OpenRouter una volta sola e scegli i modelli dal suo elenco.
Un’API key (chiave API) è il codice segreto che un’app usa per inviare richieste a nome del tuo account. OpenRouter controlla la chiave, inoltra il messaggio al modello che hai scelto e scala il costo dai tuoi crediti OpenRouter.
OpenRouter è pensato per app e sviluppatori. Non pubblica una propria app di chat per iPhone o Android, ed è per questo che in tanti cercano un’«app OpenRouter». Quello che serve davvero è un’app di chat che accetti una chiave OpenRouter.
Come ottenere un’API key OpenRouter?
Ci vogliono un paio di minuti sul sito di OpenRouter.
- Vai su openrouter.ai e crea un account, oppure accedi.
- Apri la pagina delle chiavi, openrouter.ai/keys, e crea una nuova chiave. Dalle il nome dell’app o del dispositivo su cui la userai.
- Copia la chiave. Le chiavi OpenRouter iniziano con «sk-or-v1-» e sono lunghe 73 caratteri: controlla di averla copiata tutta.
- Se vuoi usare modelli non gratuiti, aggiungi crediti nella pagina Credits.
- Conserva la chiave in un posto sicuro, come un gestore di password. Se finisce in mani sbagliate, eliminala dalla pagina delle chiavi e creane una nuova.
L’API di OpenRouter è gratis?
In parte. Creare un account e una chiave non costa nulla, e OpenRouter offre modelli gratuiti, riconoscibili dall’ID che termina in «:free». Tutto il resto si paga con crediti prepagati. OpenRouter dice anche che i nuovi account ricevono una piccola quantità di crediti gratuiti, ma non dice quanti.
I modelli gratuiti hanno dei limiti. Ecco quelli pubblicati da OpenRouter al 18 novembre 2026:
- Se il saldo scende sotto zero, OpenRouter avverte che anche i modelli gratuiti possono restituire errori.
- Sul sito di OpenRouter vedi quali modelli hanno al momento una versione «:free»: controlla lì prima di contarci.
| Il tuo account | Richieste al minuto ai modelli gratuiti | Richieste al giorno ai modelli gratuiti |
|---|---|---|
| Meno di 10 crediti acquistati in totale | 20 | 50 |
| Almeno 10 crediti acquistati in totale | 20 | 1.000 |
Come funzionano i crediti di OpenRouter?
OpenRouter funziona con crediti prepagati. Acquisti i crediti nella pagina Credits con una carta o con uno degli altri metodi di pagamento elencati lì, e il costo di ogni richiesta viene scalato dai crediti. Al 18 novembre 2026 i termini di OpenRouter fissano un minimo di 5 dollari per acquisto, aggiungono una commissione di pagamento e indicano che i crediti non usati possono scadere 365 giorni dopo l’acquisto. I dettagli aggiornati sono su openrouter.ai/terms.
Ogni modello ha il suo prezzo per token, indicato nella sua pagina su OpenRouter. Non riportiamo i prezzi perché cambiano. Oriveo mostra un costo stimato su ogni risposta; il riferimento definitivo sono le pagine di attività e fatturazione di OpenRouter.
Come usare OpenRouter su iPhone, Android o web?
Visto che non esiste un’app ufficiale di OpenRouter per il telefono, scegli tu un’app client. In Oriveo, OpenRouter è uno dei 15 fornitori integrati e si trova tra gli «Aggregatori», quindi non devi digitare nessun indirizzo.
- Apri «Fornitori»: è una scheda su iPhone e Android e una voce della barra laterale sul web.
- Tocca il pulsante + («Aggiungi fornitore») e scegli OpenRouter. Il filtro «Aggregatori» restringe l’elenco.
- Incolla la chiave sotto «Collega OpenRouter» e tocca «Continua».
- Attendi che Oriveo convalidi la connessione e sincronizzi i modelli: in questo passaggio carica l’elenco dei modelli di OpenRouter.
- Scegli un modello e inizia a chattare. Se non hai crediti, scegline uno con l’ID che termina in «:free».

Dove finisce la mia chiave OpenRouter?
Su iPhone e Android le richieste vanno direttamente dal tuo dispositivo al fornitore, e la chiave è conservata nell’archivio sicuro del telefono (Keychain su iPhone, Keystore su Android). Nell’app web le richieste passano da un inoltro in tempo reale sul server di Oriveo: la chiave viene usata solo per quella richiesta e non viene salvata come dato dell’account, e le chat BYOK non vengono conservate come registri delle conversazioni. Le chiavi non vengono caricate dalla sincronizzazione cloud. Per usare OpenRouter su un secondo dispositivo, incolla la chiave anche lì, oppure crea una chiave apposta.
Paghi OpenRouter direttamente, ai suoi prezzi. Oriveo non aggiunge alcun ricarico.
Perché la mia API key OpenRouter non funziona?
La pagina degli errori di OpenRouter (openrouter.ai/docs/api-reference/errors) spiega il significato di ogni codice. Questi sono i più comuni, al 18 novembre 2026:
- In Oriveo il 402 compare come «Quota del fornitore raggiunta», e il 429 come «Limite di richieste raggiunto» sul web o «Limite di richieste del fornitore raggiunto» su iPhone e Android.
- Un modello non compare nell’elenco: sincronizza di nuovo l’elenco dei modelli e controlla che OpenRouter lo offra ancora.
| Errore | Che cosa significa | Che cosa fare |
|---|---|---|
| 401 Invalid credentials | La chiave è sbagliata, disattivata o eliminata | Copia di nuovo la chiave completa, oppure creane una nuova |
| 401 «this is not an OpenRouter API key» | Hai incollato la chiave di un altro fornitore | Usa una chiave di openrouter.ai/keys: inizia con sk-or-v1- |
| 402 insufficient credits | L’account o questa chiave hanno finito i crediti | Aggiungi crediti o alza il limite della chiave; aspettare non serve |
| 403 Forbidden | Bloccato da permessi, moderazione, un guardrail o un limite di budget | Controlla le impostazioni e i limiti della chiave, oppure modifica il messaggio |
| 429 rate limited | Troppe richieste, per OpenRouter o per il fornitore del modello | Aspetta e riprova; con i modelli gratuiti, controlla i limiti indicati sopra |
| 502 o 503 | Il modello o i suoi fornitori non sono disponibili in questo momento | Riprova più tardi o scegli un altro modello |
OpenRouter o una chiave per ogni fornitore?
OpenRouter è comodo quando vuoi molti modelli con una sola chiave e un solo saldo. Una chiave presa direttamente da un fornitore come OpenAI o Anthropic fa per te quando vuoi l’account e la fatturazione di quel fornitore. Oriveo le accetta entrambe, quindi puoi tenere OpenRouter accanto alle chiavi dirette e cambiare modello, uno alla volta, nella stessa conversazione.
Domande frequenti
OpenRouter è gratis?
Dove ottengo la mia API key OpenRouter?
Esiste un’app OpenRouter per iPhone o Android?
Che cosa significa l’errore 402 di OpenRouter?
Perché la mia API key OpenRouter non funziona?
Com’è fatta un’API key OpenRouter?
Letture correlate
Usa la tua chiave OpenRouter sul telefono
Apri l’app web o scarica Oriveo per iPhone o Android, incolla la tua chiave OpenRouter e passa da un modello all’altro con un costo stimato su ogni risposta.
Non hai ancora una chiave API? Con Oriveo Free puoi iniziare senza.