Questa è una traduzione automatica del documento originale in inglese. In caso di discrepanze tra la presente traduzione e la versione originale in inglese, prevarrà la versione inglese. Leggi la versione originale in inglese

AI Provider e Chiavi API

Caiioo si connette a oltre 500 modelli IA attraverso un piccolo set di provider. Utilizzi la tua chiave API — questo significa che paghi direttamente il provider e Caiioo non tocca mai le tue spese.

Provider supportati

Oggi sono disponibili undici provider cloud e locali in Settings > AI Setup > AI Provider:

  • OpenRouter (predefinito) — una singola chiave sblocca oltre 500 modelli, tra cui Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama, DeepSeek, Qwen e altri ancora. Questo è il percorso consigliato per la maggior parte degli utenti: gli strumenti di Caiioo si basano sul registro dei modelli di OpenRouter e tu devi gestire una sola chiave.
  • Google AI — una connessione diretta all'API Gemini con la tua chiave Google AI personale. Google offre una quota gratuita autentica, rappresentando una vera soluzione senza carta di credito per eseguire un modello frontier — con thinking nativo e fino a 2M di contesto. Settings ti guida passo dopo passo per ottenere una chiave gratuita.
  • Anthropic — una connessione diretta all'API Claude con la tua chiave Anthropic, con extended thinking nativo abbinato all'uso di strumenti (tool use). Crea una chiave su console.anthropic.com oppure lascia che sia Caiioo a crearne una dopo aver approvato l'accesso al tuo account Claude. La chiave viene fatturata sul tuo account Anthropic Console; Caiioo non conserva le credenziali di accesso a Claude utilizzate per crearla. Anthropic non consente l'uso di un abbonamento Claude Pro o Max in altre app, pertanto Claude in Caiioo funziona tramite una chiave Console o tramite OpenRouter, non tramite il tuo abbonamento.
  • xAI (Grok) — accesso diretto ai modelli Grok tramite api.x.ai. Connettiti con una chiave API della console di xAI, oppure accedi con il tuo account Grok (abbonamento SuperGrok o X Premium+) — approva l'accesso nel browser e sarai connesso, senza dover copiare alcuna chiave. Nota: xAI abilita l'accesso all'API in base all'account e al livello di abbonamento dal proprio lato; se le chat falliscono con un errore di autorizzazione dopo la connessione, utilizza invece una chiave API di xAI.
  • OpenAI — una connessione diretta ai modelli di OpenAI con la tua chiave API OpenAI personale, oppure accedi con il tuo account ChatGPT e Caiioo funzionerà tramite il tuo abbonamento ChatGPT invece che con una chiave.
  • CometAPI — oltre 500 modelli (GPT, Claude, Gemini, DeepSeek e altri) tramite una sola chiave CometAPI a consumo (pay-as-you-go). Il selettore dei modelli mostra medaglie basate sui livelli di benchmark per il suo catalogo, e l'utilizzo totale di CometAPI viene monitorato in Settings.
  • Poe — modelli di Anthropic, Google, OpenAI, xAI, Meta e altri tramite un'unica chiave API Poe, fatturati in punti del tuo abbonamento Poe anziché in dollari per token. Il saldo residuo dei punti e la spesa effettuata da un thread vengono entrambi mostrati nell'app. Ottieni una chiave su poe.com/api/keys.
  • Ollama — esegue modelli open source localmente sulla tua macchina (http://localhost:11434 per impostazione predefinita). Privato, senza necessità di connessione internet, gratuito. Funziona anche con Ollama Cloud tramite una chiave API facoltativa.
  • vLLM, Unsloth e MLX (Pro) — collega server di inferenza locali o di rete compatibili con OpenAI che eseguono vLLM (http://localhost:8000 per impostazione predefinita), Unsloth (http://localhost:8000 per impostazione predefinita) o MLX (http://localhost:8080 per impostazione predefinita su Apple Silicon), con un bearer token facoltativo. Quando chatti dal telefono o dal browser all'interno di una conversazione ospitata sul tuo desktop, Caiioo elenca ed esegue automaticamente i modelli sul server locale di quel desktop.

Consulta i Termini di utilizzo per le policy.

Per iniziare (due opzioni)

Opzione 1: Usa la chiave preconfigurata gratuita

Forniamo una chiave OpenRouter gratuita che ti consente di provare subito Caiioo. Offre l'accesso a una selezione di modelli gratuiti con limiti di utilizzo: l'ideale per fare dei test.

Per continuare a usarla: apri semplicemente Caiioo e inizia a chattare. Non è richiesta alcuna configurazione. Gli abbonati Pro ricevono un bonus di crediti OpenRouter aggiuntivo di 5 $/mese applicato automaticamente a questa stessa chiave, in aggiunta all'eventuale saldo già presente.

Finché utilizzi la chiave inclusa, il campo della chiave OpenRouter nelle Impostazioni lo indicherà invece di apparire vuoto: vedrai una nota che segnala l'uso della chiave dell'account di Caiioo e il tuo saldo residuo. Le tue chiavi sono archiviate sul tuo dispositivo; con Private Sync attivo, sia la chiave inclusa sia la tua chiave OpenRouter personale vengono trasferite agli altri tuoi dispositivi all'interno del tuo backup crittografato.

Gli strumenti che consumano crediti — generazione di immagini, video e musica, OCR avanzato e ricerca Perplexity AI — richiedono crediti OpenRouter, non solo una chiave. Con la chiave preconfigurata gratuita, questi strumenti segnalano "nessun credito". Hai due possibilità: inserire la tua chiave API di OpenRouter (BYOK) in Impostazioni > Configurazione AI > Provider AI, oppure effettuare l'upgrade del tuo piano Caiioo — un piano a pagamento ricarica ogni mese questa stessa chiave preconfigurata con crediti, rendendo questi strumenti subito operativi.

Opzione 2: Porta la tua chiave personale (BYOK)

Desideri l'accesso completo senza i limiti del piano gratuito? Aggiungi la tua chiave personale.

OpenRouter (consigliato):

  1. Registrati su openrouter.ai e crea una chiave API
  2. Vai su Impostazioni → Configurazione AI → Provider AI
  3. Seleziona OpenRouter e incolla la tua chiave — oppure fai clic su Sign in with OpenRouter per collegare il tuo account senza dover copiare nulla
  4. Tutto qui: la chiave rimane sul tuo dispositivo e non raggiunge mai i server di Caiioo

Google AI (Gemini diretto):

  1. Vai su Impostazioni → Configurazione AI → Provider AI e seleziona Google AI
  2. Segui i passaggi guidati per "ottenere la tua chiave gratuita" (Google AI Studio rilascia chiavi gratuitamente, senza carta di credito)
  3. Incolla la chiave: rimane sul tuo dispositivo e le richieste vanno direttamente a Google

Anthropic (Claude diretto):

  1. Vai su Impostazioni → Configurazione AI → Provider AI e seleziona Anthropic
  2. Fai clic su Manage accanto ad Anthropic credentials
  3. Fai clic su Create a key from your Claude account
  4. Approva l'accesso nel browser, incolla il codice di autorizzazione in Caiioo e fai clic su Connect

Puoi anche fare clic su Add API key e incollare una chiave creata nella Anthropic Console.

Poe:

  1. Vai su Impostazioni → Configurazione AI → Provider AI e seleziona Poe
  2. Crea una chiave su poe.com/api/keys — anche la nota sotto il campo della chiave rimanda a questa pagina
  3. Incolla la chiave in Poe API Key

Il saldo dei tuoi punti apparirà sotto la chiave. I costi delle conversazioni vengono mostrati sia in punti Poe che in dollari.

Ollama, vLLM, Unsloth o MLX (server locali e di rete):

  1. Avvia il server dei modelli locale (Ollama su http://localhost:11434, vLLM o Unsloth su http://localhost:8000, oppure MLX su http://localhost:8080)
  2. Vai su Impostazioni > Configurazione AI > Provider AI
  3. Seleziona Ollama, vLLM, Unsloth o MLX, conferma l'URL del server (e la chiave API/token facoltativa per i server remoti sulla tua rete) e scegli qualsiasi modello gestito dal tuo host

Quando selezioni un modello di chat locale, gli strumenti basati sull'IA che invierebbero i tuoi dati a un provider AI remoto possono richiedere prima la tua approvazione. Consulta Privacy e dati → Strumenti che utilizzano un altro provider AI.

Configurazione del modello che mostra Default Model e Max Steps

One Caiioo Router e controllo dell'impegno

Invece di scegliere tra modalità di routing separate o indovinare quale modello sia adatto a un'attività, apri il selettore del modello nel compositore (o Impostazioni > Configurazione IA > Configurazione modello) per utilizzare Caiioo Router ed Effort:

  • Caiioo Router: seleziona Caiioo Router in cima al selettore del modello per mostrare due dispositivi di scorrimento in tempo reale:
    • Costo ↔ Intelligenza — scorri verso Costo più basso per turni quotidiani rapidi ed economici, Bilanciato per il miglior rapporto qualità-prezzo, o Intelligenza massima per il ragionamento più avanzato.
    • Anti-allucinazione — attribuisci un peso maggiore all'accuratezza dei fatti e al rigore delle citazioni quando la precisione è fondamentale.
    • Man mano che sposti uno dei cursori, l'elenco dei modelli sottostante si filtra e si riordina all'istante, mostrandoti quali modelli corrispondono alle tue preferenze.
  • Controllo dell'impegno (Effort): quando un modello selezionato (o Caiioo Router) supporta l'impegno di ragionamento, appare un controllo Effort direttamente nel selettore del modello. Scegli Automatico (o Disattivato, Basso, Medio, Alto, Massimo a seconda di ciò che il modello supporta). Caiioo Router classifica e seleziona i modelli in base al livello di impegno scelto per la conversazione, anziché assumere un valore predefinito fisso.

Modello per attività rapide

Un modello separato e più economico che Caiioo utilizza automaticamente in background per operazioni come la generazione dei titoli dei thread, la classificazione degli intenti, la scelta dello strumento da richiamare e altre brevi query di supporto — non riceve mai prompt diretti da parte tua. Configuralo in Impostazioni → Configurazione IA → Configurazione modello (un piccolo modello gratuito di OpenRouter o un modello locale di Ollama è più che sufficiente). Se non impostato, il sistema utilizzerà il modello predefinito.

BYOA (Bring Your Own Auth) per gli strumenti — Pro

BYOA è diverso da BYOK. Non è per gli LLM, ma per le connessioni degli strumenti (Google Workspace, Microsoft 365, GitHub, ecc.). Con il piano Pro, Impostazioni → Connettori → Aggiungi → La tua app OAuth ti consente di collegare il tuo client OAuth se la tua organizzazione non include l'ID client predefinito di Caiioo nella whitelist:

  • Usa la tua app Google OAuth — segui la procedura guidata per creare un progetto Google Cloud e incollare ID client e segreto
  • Usa la tua app Microsoft Azure — stessa procedura per le app registrate su Azure
  • Aggiungi provider OAuth personalizzato — flusso OAuth 2.0 generico per qualsiasi provider che lo supporti

Le procedure guidate salvano le credenziali sul tuo dispositivo. Non lo lasciano mai.

Mantieni più account o chiavi per provider

Ogni provider può contenere più di una credenziale — una chiave di lavoro accanto a una personale, o un account connesso insieme a una chiave API — con una sola in uso alla volta. Non dovrai più sovrascrivere una chiave per poi reincollarla in seguito.

Gestiscile in Impostazioni > Connettori: ogni provider corrisponde a una riga di tipo Modello IA, e aprendola vengono visualizzati i relativi account e chiavi. Oppure fai clic su Gestisci accanto al provider in Impostazioni > Configurazione IA > Provider IA. Puoi assegnare un nome a ciascuna credenziale (es. "Lavoro"), quella attiva mostra il badge In uso e per cambiare basta un clic su Usa. Rimuovere una credenziale da Caiioo non revoca nulla presso il provider: il tuo account lì rimane intatto e potrai aggiungerlo di nuovo in seguito.

Sicurezza delle chiavi API

Le tue chiavi API sono memorizzate localmente sul tuo dispositivo. Con la Sincronizzazione privata attiva, le tue chiavi e gli account dei provider connessi vengono crittografati sul dispositivo prima di entrare nel backup di sincronizzazione, per poi essere decrittografati solo sugli altri tuoi dispositivi. I server di Caiioo non ricevono mai credenziali leggibili. Quando effettui una richiesta, il dispositivo che esegue la conversazione invia la propria credenziale attiva direttamente al provider di IA. Vedi Privacy e dati per tutti i dettagli.

Le prestazioni dipendono dal tuo modello

Caiioo gestisce l'orchestrazione — strumenti, contesto, flussi di lavoro in più passaggi. Ma la qualità delle risposte dell'IA dipende dal modello scelto.

Per attività complesse (ricerca, analisi, documenti lunghi): usa un modello di frontiera — Claude Sonnet, classe GPT o Gemini Pro — tutti accessibili tramite la tua chiave OpenRouter. Gestiscono al meglio il ragionamento in più passaggi e l'uso degli strumenti.

Per risposte rapide (domande, riassunti, modifiche semplici): i modelli veloci — Claude Haiku, varianti GPT più piccole o Gemini Flash — sono più economici e più veloci. Perfetti per le attività quotidiane.

Per sperimentare: OpenRouter ti consente di provare oltre 500 modelli con una sola chiave API. Trova ciò che funziona meglio per il tuo flusso di lavoro senza legarti a un unico provider.

Il selettore dei modelli descrive le capacità del provider che serve effettivamente ciascun modello e mostra le medaglie dei benchmark laddove siano disponibili misurazioni. Un modello appena rilasciato o non ancora misurato rimane visibile; semplicemente non presenta ancora medaglie. I costi totali utilizzano le tariffe pubblicate dal provider fornitore; se Caiioo non riesce a stabilire una tariffa, omette il costo invece di fare una stima.

Due medaglie, due domande diverse. Un modello può ricevere una medaglia d'oro, d'argento o di bronzo per una o entrambe le categorie:

  • Best for Caiioo classifica esclusivamente in base alle capacità. Il prezzo non fa parte del calcolo, quindi un modello veloce ed economico non può essere in cima a una colonna chiamata best.
  • Value for Caiioo è dove entra in gioco il prezzo — la migliore qualità che puoi ottenere in rapporto al costo.

Caiioo Router utilizza direttamente queste stesse misurazioni di benchmark: spostando il cursore verso Balanced o Lowest cost si valuta il prezzo insieme alla qualità, mentre spostandolo verso Highest intelligence si dà priorità alle capacità. Ciò che vedi nel selettore è esattamente ciò su cui l'app basa le proprie scelte.

Guarda le misurazioni dietro le medaglie. Model Intelligence (Caiioo Benchmarks, Pro) confronta qualità, throughput, time-to-first-token, precisione nell'uso degli strumenti e prezzi, illustrando la metodologia — da dove proviene ogni numero e quali fattori compongono il punteggio di convenienza. Le classifiche per ciascun tipo di attività vengono pubblicate una volta e lette sia dall'app sia dalla leaderboard su caiioo.ai, quindi ciò che il routing seleziona e ciò che la leaderboard mostra corrispondono perfettamente. La leaderboard aggiunge una suddivisione Best by Use Case se desideri vedere quale modello eccelle per programmazione, ricerca o scrittura, piuttosto che solo complessivamente.

Una nota sul cursore Creativity: i modelli più recenti (come Claude Sonnet 5 e successivi) gestiscono la propria creatività e non accettano l'impostazione della temperatura. Quando ne selezioni uno, il cursore Creativity in Model Configuration viene disabilitato con una breve nota — è il comportamento previsto, non un bug.

Per il lavoro offline / completamente privato: Ollama esegue modelli open source sulla tua macchina. Più lenti dei modelli di frontiera nel cloud, ma nulla lascia il tuo hardware.

Gli strumenti, i livelli di contesto e l'orchestrazione di Caiioo amplificano qualsiasi modello tu scelga. Un buon modello diventa eccellente quando ha a disposizione il contesto e gli strumenti giusti con cui lavorare.

Vedi Anche

This guide is maintained by the Caiioo team using Slate, our built-in editor.