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

Sette provider sono attualmente disponibili in via generale:

  • OpenRouter (predefinito) — una singola chiave sblocca oltre 500 modelli, inclusi Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama e altri. Questa è la via consigliata per la maggior parte degli utenti: gli strumenti di Caiioo si aspettano il registro dei modelli di OpenRouter e devi gestire una sola chiave.
  • Google AI — una connessione diretta all'API Gemini con la tua chiave Google AI personale. Google offre una vera quota gratuita, quindi questo è un modo reale per eseguire un modello di frontiera senza carta di credito, con pensiero nativo e fino a 2M di contesto. Le Impostazioni ti guideranno nell'ottenimento di una chiave gratuita.
  • Anthropic — una connessione diretta all'API Claude con la tua chiave Anthropic personale, con pensiero esteso nativo insieme all'uso degli strumenti. Crea una chiave su console.anthropic.com, o lascia che Caiioo ne crei 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.
  • xAI (Grok) — accesso diretto ai modelli Grok tramite api.x.ai. Connettiti con una chiave API della console xAI, o semplicemente accedi con il tuo account Grok (abbonamento SuperGrok o X Premium+) — approva l'accesso nel browser e sarai connesso, senza chiavi da copiare. Nota: xAI abilita l'accesso API per account e livello di abbonamento dal loro lato; se le chat falliscono con un errore di autorizzazione dopo la connessione, usa invece una chiave API xAI.
  • CometAPI — oltre 500 modelli (GPT, Claude, Gemini, DeepSeek e altri) tramite un'unica chiave CometAPI a consumo. Il selettore di modelli mostra medaglie basate su benchmark per il suo catalogo e l'utilizzo totale di CometAPI viene tracciato nelle Impostazioni.
  • Poe — modelli di Anthropic, Google, OpenAI, xAI, Meta e altri tramite un'unica chiave API Poe, fatturata con i punti del tuo abbonamento Poe anziché in dollari per token. Il saldo dei punti rimanenti e la spesa di una conversazione vengono entrambi visualizzati nell'app. Ottieni una chiave su poe.com/api/keys.
  • Ollama — esegue modelli open source localmente sulla tua macchina. Totalmente privato, nessuna connessione Internet richiesta, gratuito. Utile per il lavoro offline o quando desideri il controllo assoluto sull'inferenza. (Anche Ollama Cloud funziona con una chiave API opzionale.)

Le connessioni dirette ad altri provider (OpenAI, MLX e altri) sono in fase di test e non sono ancora generalmente disponibili. Per ora, usa quei modelli tramite la tua chiave OpenRouter: è a questo che serve OpenRouter.

Consulta i Termini di utilizzo per le relative politiche.

Inizia (Due Opzioni)

Opzione 1: Usa la Chiave Fornita Gratuitamente

Forniremo una chiave OpenRouter gratuita che ti consente di provare subito Caiioo. Ha accesso a modelli gratuiti selezionati con limiti di utilizzo, perfetti per fare dei test.

Per continuare a usarla: basta aprire Caiioo e iniziare a chattare. Non è richiesta alcuna configurazione. Gli abbonati Pro ricevono un bonus di credito OpenRouter aggiuntivo di $5/mese applicato automaticamente a questa stessa chiave, in cima a qualsiasi saldo sia già presente.

Mentre utilizzi la chiave inclusa, il campo della chiave OpenRouter nelle Impostazioni lo indica invece di sembrare vuoto: vedrai una nota che indica che stai usando la chiave dell'account di Caiioo e il tuo saldo residuo. Le tue chiavi sono memorizzate sul tuo dispositivo; con la Sincronizzazione Privata attiva, sia la chiave inclusa che la tua chiave OpenRouter viaggiano verso gli 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. Sulla chiave gratuita fornita questi strumenti segnalano "nessun credito". Hai due modi per procedere: inserire la tua chiave API OpenRouter (BYOK) in Impostazioni > Configurazione IA > Provider IA, oppure aggiornare il tuo piano Caiioo — un piano a pagamento ricarica questa stessa chiave fornita con crediti ogni mese, così questi strumenti funzionano semplicemente.

Opzione 2: Porta la Tua Chiave (BYOK)

Vuoi l'accesso completo senza i limiti del livello gratuito? Aggiungi la tua chiave.

OpenRouter (consigliato):

  1. Registrati su openrouter.ai e crea una chiave API
  2. Vai su Impostazioni → Configurazione IA → Provider IA
  3. Seleziona OpenRouter e incolla la tua chiave — oppure clicca su Accedi con OpenRouter per connettere il tuo account senza copiare nulla
  4. Fatto: la chiave rimane sul tuo dispositivo e non raggiunge mai i server di Caiioo

Google AI (Gemini diretto):

  1. Vai su Impostazioni → Configurazione IA → Provider IA e seleziona Google AI
  2. Segui i passaggi guidati "ottieni 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 IA → Provider IA e seleziona Anthropic
  2. Clicca su Gestisci accanto a Credenziali Anthropic
  3. Sotto Account Connessi, clicca su Crea una chiave dal tuo account Claude
  4. Approva l'accesso nel browser, incolla il codice di autorizzazione di nuovo in Caiioo e clicca su Connetti

Puoi anche cliccare su Aggiungi chiave API e incollare una chiave creata nella Console Anthropic.

Poe:

  1. Vai su Impostazioni → Configurazione IA → Provider IA e seleziona Poe
  2. Crea una chiave su poe.com/api/keys — la nota sotto il campo della chiave punta anche lì
  3. Incolla la chiave in Chiave API Poe

Il tuo saldo punti appare sotto la chiave. I costi delle conversazioni appaiono sia in punti Poe che in dollari.

Ollama (locale):

  1. Installa Ollama da ollama.com e scarica un modello (ollama pull llama3.2)
  2. Vai su Impostazioni → Configurazione IA → Provider IA
  3. Seleziona Ollama e conferma l'URL del server (predefinito http://localhost:11434)
  4. Scegli qualsiasi modello che hai installato localmente

Quando scegli un modello di chat locale, gli strumenti basati sull'IA che invierebbero i tuoi dati a un provider IA remoto richiedono prima la tua approvazione. Vedi Privacy e Dati → Provider IA Remoti.

Configurazione del modello che mostra il Modello Predefinito e i Passaggi Massimi

Modello per Attività Rapide

Un modello separato e più economico che Caiioo usa automaticamente in background per cose come la generazione di titoli delle conversazioni, la classificazione dell'intento, la scelta dello strumento da richiamare e altre brevi query di supporto — non lo solleciti mai direttamente. Configuralo in Impostazioni → Configurazione IA → Configurazione Modello (un piccolo modello gratuito di OpenRouter o un modello Ollama locale sono più che sufficienti). Se non è impostato, il sistema torna al tuo modello predefinito.

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

BYOA è diverso da BYOK. Non è per gli LLM, ma per le connessioni agli strumenti (Google Workspace, Microsoft 365, GitHub, ecc.). Nel piano Pro, Impostazioni → Account → Autorizzazioni e permessi dell'account ti consente di collegare il tuo client OAuth quando la tua organizzazione non inserisce nella whitelist l'ID client predefinito di Caiioo:

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

Le procedure guidate scrivono le credenziali direttamente nel Vault delle credenziali. Non lasciano mai il tuo dispositivo.

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 con accesso accanto a una chiave API), con una di esse in uso alla volta. Niente più sovrascritture di chiavi da incollare nuovamente in seguito.

Gestiscile in Impostazioni > Account > Autorizzazioni e permessi dell'account, sotto Account provider IA (con le schede Account connessi e Chiavi API), oppure fai clic su Gestisci accanto al provider in Impostazioni > Configurazione IA > Provider IA. Puoi assegnare un nome a ciascuna credenziale (ad es. "Lavoro"), quella attiva riporta il badge In uso e per passare da una all'altra basta un clic su Usa. La rimozione di 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. Tuttavia, la qualità delle risposte dell'IA dipende dal modello che scegli.

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 multi-step e l'uso degli strumenti.

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

Per sperimentare: OpenRouter ti consente di provare oltre 500 modelli con un'unica chiave API. Trova ciò che funziona meglio per il tuo flusso di lavoro senza vincolarti a un singolo provider.

Il selettore dei modelli descrive le capacità del provider che serve effettivamente ciascun modello e mostra le medaglie dei benchmark dove sono 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 che fornisce il servizio; se Caiioo non riesce a stabilire una tariffa, omette il costo invece di fare una stima.

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

  • Best for Caiioo classifica unicamente in base alle capacità. Il prezzo non ne fa parte, quindi un modello economico e veloce non può essere al primo posto in una colonna denominata "best".
  • Value for Caiioo è dove entra in gioco il prezzo: la migliore qualità possibile in rapporto al costo.

L'instradamento automatico segue la stessa distinzione: il Value Router tiene conto del costo, gli altri router no. Ciò che vedi nel selettore è esattamente ciò su cui si basa l'applicazione per scegliere.

Scopri le misurazioni dietro le medaglie. Model Intelligence (Caiioo Benchmarks, Pro) confronta qualità, throughput, time-to-first-token, accuratezza degli strumenti e prezzi, spiegando in dettaglio la metodologia — da dove proviene ciascun dato e quali elementi incidono sul punteggio di convenienza. Le classifiche per ciascun tipo di attività vengono pubblicate una sola volta e lette sia dall'app sia dalla classifica su caiioo.ai, quindi ciò che l'instradamento sceglie corrisponde esattamente a ciò che mostra la classifica. La classifica aggiunge un dettaglio Best by Use Case se desideri vedere quale modello è in testa per programmazione, ricerca o scrittura, piuttosto che solo a livello generale.

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

Per il lavoro offline / completamente privato: Ollama esegue modelli open source sul tuo computer. Più lento dei modelli di frontiera sul cloud, ma nessun dato lascia il tuo hardware.

Gli strumenti, i livelli di contesto e l'orchestrazione di Caiioo potenziano qualsiasi modello tu scelga. Un buon modello diventa eccezionale quando dispone del contesto e degli strumenti giusti con cui lavorare.

Vedi Anche

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