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

Cinque provider sono generalmente disponibili oggi:

  • OpenRouter (predefinito) — una singola chiave sblocca oltre 500 modelli tra cui Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama e altri. Questo è il percorso consigliato 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. Google offre una vera quota gratuita, quindi questo è un modo reale per eseguire un modello di frontiera senza carta di credito, con ragionamento nativo e fino a 2M di contesto. Le Impostazioni ti guidano nell'ottenere una chiave gratuita.
  • 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 di xAI.
  • CometAPI — oltre 500 modelli (GPT, Claude, Gemini, DeepSeek e altri) tramite un'unica chiave CometAPI a consumo. Il selettore dei modelli mostra medaglie di livello benchmark per il suo catalogo e l'utilizzo totale di CometAPI viene tracciato nelle Impostazioni.
  • Ollama — esegue modelli open source localmente sul tuo computer. Completamente privato, nessuna connessione internet richiesta, gratuito. Utile per il lavoro offline o quando desideri il controllo assoluto sull'inferenza. (Ollama Cloud funziona anche con una chiave API opzionale).

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

Vedi i Termini d'uso per le politiche.

Inizia (Due Opzioni)

Opzione 1: Usa la Chiave Gratuita Fornita

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

Per continuare a usarla: apri semplicemente Caiioo e inizia a chattare. Nessuna configurazione necessaria. Gli abbonati Pro ricevono un bonus di credito OpenRouter di $5/mese aggiuntivo 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 anziché sembrare vuoto: vedrai una nota che specifica che stai utilizzando la chiave dell'account di Caiioo e il tuo saldo rimanente. La chiave inclusa rimane sul dispositivo su cui l'hai configurata; anche la tua chiave OpenRouter personale viene memorizzata per singolo dispositivo e appare sugli altri dispositivi solo dopo aver attivato la Sincronizzazione Privata.

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 gratuita fornita, questi strumenti segnalano "nessun credito". Hai due strade: inserire la tua chiave API OpenRouter (BYOK) in Impostazioni > Provider di IA, oppure effettuare l'upgrade del tuo piano Caiioo — un piano a pagamento ricarica questa stessa chiave fornita con crediti ogni mese, così questi strumenti funzionano immediatamente.

Opzione 2: Usa la tua Chiave (BYOK)

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

OpenRouter (consigliato):

  1. Registrati su openrouter.ai e crea una chiave API
  2. Vai su Impostazioni → Provider di IA
  3. Seleziona OpenRouter e incolla la tua chiave — oppure fai clic 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 → Provider di 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

Ollama (locale):

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

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

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

Modello per Attività Rapide

Un modello separato ed economico che Caiioo utilizza automaticamente in background per attività 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 Modello (un piccolo modello gratuito di OpenRouter o un modello Ollama locale sono più che sufficienti). Se non viene impostato, il sistema ripiega sul 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 integrare il tuo client OAuth quando la tua organizzazione non inserisce l'ID client predefinito di Caiioo nella whitelist:

  • Usa la tua app Google OAuth: segui la procedura 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 in 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.

Sicurezza delle chiavi API

Le tue chiavi API sono memorizzate localmente sul tuo dispositivo. Non vengono mai inviate ai server di caiioo. Quando effettui una richiesta, la tua chiave va direttamente al provider IA. Consulta Privacy e dati per la storia completa.

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, di 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 più piccole di GPT o Gemini Flash) sono più economici e rapidi. Perfetti per le attività quotidiane.

Per la sperimentazione: OpenRouter ti consente di provare oltre 500 modelli con una sola chiave API. Trova quello che funziona meglio per il tuo flusso di lavoro senza vincolarti a un singolo provider.

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

Per il lavoro offline/completamente privato: Ollama esegue modelli open source sulla tua macchina. Più lento rispetto ai 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 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.