Esta é uma tradução automática do documento original em inglês. Em caso de conflito entre esta tradução e a versão original em inglês, a versão em inglês prevalecerá. Ler a versão original em inglês

Provedores de IA e Chaves de API

O Caiioo se conecta a mais de 500 modelos de IA através de um pequeno conjunto de provedores. Você traz sua própria chave de API — isso significa que você paga ao provedor diretamente, e o Caiioo nunca toca nos seus gastos.

Provedores Suportados

Dois provedores estão geralmente disponíveis hoje:

  • OpenRouter (padrão) — uma única chave desbloqueia mais de 500 modelos, incluindo Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama e mais. Este é o caminho recomendado para a maioria dos usuários — as ferramentas do Caiioo esperam o registro de modelos do OpenRouter, e você gerencia apenas uma chave.
  • Ollama — executa modelos de código aberto localmente na sua máquina. Totalmente privado, sem necessidade de internet, GRATIS. Útil para trabalho offline ou quando você deseja controle absoluto sobre a inferência.

Conexões diretas com Anthropic, Google Gemini, OpenAI, Poe e MLX estão planejadas, mas ainda não estão geralmente disponíveis. Por enquanto, use esses modelos através da sua chave OpenRouter — é para isso que o OpenRouter serve.

Consulte os Termos de Uso para políticas.

Começar (Duas Opções)

Opção 1: Use a Chave Provisionada Gratuita

Nós fornecemos uma chave gratuita do OpenRouter que permite que você experimente o Caiioo imediatamente. Ela tem acesso a modelos gratuitos selecionados com limites de uso — perfeita para testar as funcionalidades.

Para continuar usando: basta abrir o Caiioo e começar a conversar. Nenhuma configuração é necessária. Assinantes Pro recebem um bônus adicional de $5/mês em créditos do OpenRouter aplicado automaticamente a esta mesma chave, além de qualquer saldo que já esteja lá.

Ferramentas que consomem créditos—geração de imagem, vídeo e música, OCR avançado e busca Perplexity AI—precisam de créditos do OpenRouter, não apenas de uma chave. Na chave provisionada gratuita, essas ferramentas reportam "sem créditos". Você tem dois caminhos a seguir: insira sua própria chave de API do OpenRouter (BYOK) em Settings > AI Providers, ou faça o upgrade do seu plano Caiioo—um plano pago recarrega esta mesma chave provisionada com créditos todos os meses, para que essas ferramentas simplesmente funcionem.

Opção 2: Traga Sua Própria Chave (BYOK)

Quer acesso total sem os limites do nível gratuito? Adicione sua própria chave.

OpenRouter (recomendado):

  1. Cadastre-se em openrouter.ai e crie uma chave de API
  2. Vá em Settings → AI Provider
  3. Selecione OpenRouter e cole sua chave
  4. Pronto — a chave permanece no seu dispositivo e nunca chega aos servidores do Caiioo

Ollama (local):

  1. Instale o Ollama em ollama.com e baixe um modelo (ollama pull llama3.2)
  2. Vá em Settings → AI Provider
  3. Selecione Ollama e confirme a URL do servidor (padrão http://localhost:11434)
  4. Escolha qualquer modelo que você tenha instalado localmente

Quando você escolhe um modelo de chat local, as ferramentas movidas a AI que enviariam seus dados para um provedor de AI remoto solicitam sua aprovação primeiro. Veja Privacy & Data → Remote AI Providers.

Model Configuration showing Default Model and Max Steps

Modelo de Tarefas Rápidas (Quick Tasks Model)

Um modelo separado e mais barato que o Caiioo usa automaticamente em segundo plano para coisas como gerar títulos de conversas, classificar intenções, escolher qual ferramenta chamar e outras pequenas consultas auxiliares — você nunca interage com ele diretamente. Configure-o em Settings → Model Config (um modelo gratuito pequeno do OpenRouter ou um modelo local do Ollama é suficiente). Se não for configurado, o sistema utiliza seu modelo padrão como alternativa.

BYOA (Traga Sua Própria Autenticação) para Ferramentas — Pro

BYOA é diferente de BYOK. Não é para LLMs — é para conexões de ferramentas (Google Workspace, Microsoft 365, GitHub, etc.). No Pro, Configurações → OAuth Personalizado permite que você conecte seu próprio cliente OAuth quando sua organização não permite o ID de cliente padrão do Caiioo:

  • Assistente Google Workspace — passo a passo para criar um projeto no Google Cloud e colar o ID do cliente + segredo
  • Assistente Microsoft 365 — mesmo fluxo para aplicativos registrados no Azure
  • Adicionar Provedor Personalizado — fluxo genérico OAuth 2.0 para qualquer provedor que o suporte

Os assistentes gravam as credenciais diretamente no Cofre de Credenciais. Elas nunca saem do seu dispositivo.

Segurança da Chave API

Suas chaves API são armazenadas localmente no seu dispositivo. Elas nunca são enviadas para os servidores do caiioo. Quando você faz uma solicitação, sua chave vai diretamente para o provedor de IA. Consulte Privacidade e Dados para a história completa.

O Desempenho Depende do Seu Modelo

O Caiioo cuida da orquestração — ferramentas, contexto, fluxos de trabalho de várias etapas. Mas a qualidade das respostas da IA depende de qual modelo você escolhe.

Para tarefas complexas (pesquisa, análise, documentos longos): use um modelo de ponta — Claude Sonnet, classe GPT ou Gemini Pro — todos acessíveis através da sua chave OpenRouter. Eles lidam melhor com raciocínio de várias etapas e uso de ferramentas.

Para respostas rápidas (perguntas, resumos, edições simples): modelos rápidos — Claude Haiku, variantes menores de GPT ou Gemini Flash — são mais baratos e rápidos. Perfeitos para tarefas do dia a dia.

Para experimentar: O OpenRouter permite testar mais de 500 modelos com uma única chave de API. Encontre o que funciona melhor para o seu fluxo de trabalho sem se comprometer com um único provedor.

Para trabalho offline / totalmente privado: O Ollama executa modelos de código aberto na sua máquina. Mais lento que os modelos de ponta na nuvem, mas nada sai do seu hardware.

As ferramentas, camadas de contexto e orquestração do Caiioo amplificam qualquer modelo que você escolher. Um bom modelo torna-se excelente quando tem o contexto e as ferramentas certas para trabalhar.

Veja Também

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