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

Due 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 gestisci una sola chiave.
  • Ollama — esegue modelli open-source localmente sulla tua macchina. Completamente privato, nessuna connessione internet richiesta, GRATIS. Utile per il lavoro offline o quando desideri il controllo assoluto sull'inferenza.

Le connessioni dirette ad Anthropic, Google Gemini, OpenAI, Poe e MLX sono pianificate ma non ancora generalmente disponibili. Per ora, usa questi modelli tramite la tua chiave OpenRouter — OpenRouter serve proprio a questo.

Consulta i Termini d'Uso per le policy.

Inizia (Due Opzioni)

Opzione 1: Usa la Chiave Preconfigurata Gratuita

Forniamo una chiave OpenRouter gratuita che ti permette di provare Caiioo immediatamente. Ha accesso a una selezione di modelli gratuiti con limiti di utilizzo — ideale per testare le funzionalità.

Per continuare a usarla: apri Caiioo e inizia a chattare. Nessuna configurazione necessaria. Gli abbonati Pro ricevono un bonus aggiuntivo di $5/mese in crediti OpenRouter applicato automaticamente a questa stessa chiave, in aggiunta a qualsiasi saldo già presente.

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 preconfigurata gratuita, questi strumenti riporteranno "nessun credito". Hai due modi per procedere: inserire la tua chiave API OpenRouter (BYOK) in Settings > AI Providers, oppure effettuare l'upgrade del tuo piano Caiioo—un piano a pagamento ricarica questa stessa chiave preconfigurata con crediti ogni mese, rendendo questi strumenti subito operativi.

Opzione 2: Bring Your Own Key (BYOK)

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

OpenRouter (raccomandato):

  1. Registrati su openrouter.ai e crea una chiave API
  2. Vai su Settings → AI Provider
  3. Seleziona OpenRouter e incolla la tua chiave
  4. Fatto — la chiave rimane sul tuo dispositivo e non raggiunge mai i server di Caiioo

Ollama (locale):

  1. Installa Ollama da ollama.com e scarica un modello (ollama pull llama3.2)
  2. Vai su Settings → AI Provider
  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 su AI che invierebbero i tuoi dati a un fornitore AI remoto richiederanno prima la tua approvazione. Consulta Privacy & Data → Remote AI Providers.

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

Modello per Quick Tasks

Un modello separato ed economico che Caiioo utilizza automaticamente in background per operazioni come la generazione dei titoli delle discussioni, la classificazione dell'intento, la scelta dello strumento da richiamare e altre brevi query di supporto — non lo interroghi mai direttamente. Configuralo in Settings → Model Config (un piccolo modello gratuito di OpenRouter o un modello locale di Ollama è più che sufficiente). Se non impostato, il sistema utilizzerà il tuo modello predefinito.

BYOA (Usa la Tua Autenticazione) per gli Strumenti — Pro

Il BYOA è diverso dal BYOK. Non è per i modelli linguistici (LLM) — è per le connessioni agli strumenti (Google Workspace, Microsoft 365, GitHub, ecc.). Nel piano Pro, Impostazioni → OAuth Personalizzato ti consente di inserire il tuo client OAuth quando la tua organizzazione non autorizza il client ID predefinito di Caiioo:

  • Procedura guidata Google Workspace — guida alla creazione di un progetto Google Cloud e all'inserimento di client ID + secret
  • Procedura guidata Microsoft 365 — stesso flusso per app registrate su Azure
  • Aggiungi Provider 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, workflow multi-step. Ma la qualità delle risposte dell'IA dipende dal modello scelto.

Per task complessi (ricerca, analisi, documenti lunghi): usa un modello di punta — Claude Sonnet, classe GPT o Gemini Pro — tutti accessibili tramite la tua chiave OpenRouter. Gestiscono meglio il ragionamento multi-step e l'uso degli strumenti.

Per risposte rapide (domande, riassunti, modifiche semplici): i modelli veloci — Claude Haiku, varianti minori di GPT o Gemini Flash — sono più economici e rapidi. Perfetti per i task quotidiani.

Per sperimentare: OpenRouter ti permette 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 singolo provider.

Per lavoro offline / totalmente privato: Ollama esegue modelli open-source sulla tua macchina. Più lento dei modelli cloud di punta, 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 giusto contesto e gli strumenti adatti con cui lavorare.

Vedi Anche

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