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

Cinco provedores estão disponíveis em geral hoje:

  • OpenRouter (padrão) — uma única chave desbloqueia mais de 500 modelos, incluindo Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama e muito 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.
  • Google AI — uma conexão direta com a API do Gemini usando sua própria chave do Google AI. O Google oferece uma cota gratuita genuína, sendo uma forma real de usar um modelo de ponta sem precisar de cartão de crédito — com raciocínio nativo e até 2M de contexto. As Configurações guiam você na obtenção de uma chave gratuita.
  • xAI (Grok) — acesso direto aos modelos Grok via api.x.ai. Conecte-se com uma chave de API do console xAI ou simplesmente faça login com sua conta Grok (assinatura SuperGrok ou X Premium+) — autorize o acesso no navegador e você estará conectado, sem precisar copiar chaves. Nota: a xAI habilita o acesso à API por conta e nível de assinatura do lado deles; se as conversas falharem com um erro de permissão após a conexão, use uma chave de API do xAI em vez disso.
  • CometAPI — mais de 500 modelos (GPT, Claude, Gemini, DeepSeek e mais) através de uma única chave pré-paga do CometAPI. O seletor de modelos exibe medalhas de nível de benchmark para seu catálogo, e o uso total do CometAPI é rastreado nas Configurações.
  • Ollama — executa modelos de código aberto localmente no seu computador. Totalmente privado, sem necessidade de internet e gratuito. Útil para trabalho offline ou quando você deseja controle absoluto sobre a inferência. (O Ollama Cloud também funciona com uma chave de API opcional.)

Conexões diretas com outros provedores (Anthropic, OpenAI, Poe, MLX e mais) estão em fase de testes e ainda não estão disponíveis em geral. Por enquanto, use esses modelos através da sua chave do OpenRouter — é para isso que o OpenRouter serve.

Consulte os Termos de Uso para ver as políticas.

Começar (Duas Opções)

Opção 1: Usar a Chave Provisionada Gratuita

Fornecemos uma chave OpenRouter gratuita que permite testar o Caiioo imediatamente. Ela tem acesso a modelos gratuitos selecionados com limites de uso — perfeito para testar as coisas.

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

Enquanto você estiver na chave incluída, o campo da chave OpenRouter nas Configurações indicará isso em vez de parecer vazio — você verá uma nota informando que está usando a chave de conta do Caiioo e o seu saldo remanescente. A chave incluída permanece no dispositivo em que você a configurou; sua própria chave OpenRouter também é armazenada por dispositivo e só aparece em outros dispositivos depois que você ativa a Sincronização Privada.

Ferramentas que consomem créditos—geração de imagem, vídeo e música, OCR avançado e pesquisa com Perplexity AI—precisam de créditos do OpenRouter, não apenas de uma chave. Na chave provisionada gratuita, essas ferramentas informam "sem créditos". Você tem duas opções: inserir sua própria chave de API do OpenRouter (BYOK) em Configurações > Provedores de IA, ou fazer upgrade do seu plano do Caiioo—um plano pago recarrega esta mesma chave provisionada com créditos todos os meses, para que essas ferramentas funcionem perfeitamente.

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á para Configurações → Provedor de IA
  3. Selecione OpenRouter e cole sua chave — ou clique em Entrar com o OpenRouter para conectar sua conta sem precisar copiar nada
  4. É isso — a chave permanece no seu dispositivo e nunca chega aos servidores do Caiioo

Google AI (Gemini direto):

  1. Vá para Configurações → Provedor de IA e selecione Google AI
  2. Siga as etapas guiadas de "obter sua chave gratuita" (o Google AI Studio emite chaves gratuitamente, sem cartão de crédito)
  3. Cole a chave — ela permanece no seu dispositivo e as solicitações vão direto para o Google

Ollama (local):

  1. Instale o Ollama em ollama.com e baixe um modelo (ollama pull llama3.2)
  2. Vá para Configurações → Provedor de IA
  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 alimentadas por IA que enviariam seus dados para um provedor de IA remoto solicitam sua aprovação primeiro. Consulte Privacidade e Dados → Provedores de IA Remotos.

Configuração do Modelo mostrando o Modelo Padrão e o Máximo de Etapas

Modelo de Tarefas Rápidas

Um modelo separado e mais barato que o Caiioo usa automaticamente em segundo plano para coisas como gerar títulos de tópicos, classificar a intenção, escolher qual ferramenta chamar e outras consultas auxiliares curtas — você nunca faz prompts diretamente nele. Configure-o em Configurações → Configuração de Modelo (um pequeno modelo gratuito do OpenRouter ou um modelo Ollama local é mais do que suficiente). Se não for definido, o sistema recorre ao seu modelo padrão.

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

O BYOA é diferente do BYOK. Não é para LLMs — é para ligações de ferramentas (Google Workspace, Microsoft 365, GitHub, etc.). No nível Pro, Definições → Conta → Autorizações e Permissões da Conta permite-lhe ligar o seu próprio cliente OAuth quando a sua organização não inclui o ID de cliente padrão do Caiioo na lista de permissões:

  • Utilize a Sua Própria Aplicação Google OAuth — siga os passos para criar um projeto no Google Cloud e colar o ID de cliente + segredo
  • Utilize a Sua Própria Aplicação Microsoft Azure — o mesmo fluxo para aplicações registadas no Azure
  • Adicionar Fornecedor OAuth Personalizado — fluxo OAuth 2.0 genérico para qualquer fornecedor que o suporte

Os assistentes escrevem as credenciais diretamente no Cofre de Credenciais. 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 lida com a orquestração — ferramentas, contexto, fluxos de trabalho de vários passos. Mas a qualidade das respostas da IA depende do modelo que escolher.

Para tarefas complexas (pesquisa, análise, documentos longos): utilize um modelo de fronteira — Claude Sonnet, classe GPT ou Gemini Pro — todos acessíveis através da sua chave do OpenRouter. Lidam melhor com raciocínio de vários passos e utilização de ferramentas.

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

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

Uma nota sobre o controle deslizante de Criatividade: os modelos mais recentes (como o Claude Sonnet 5 e posterior) gerem a sua própria criatividade e não aceitam uma configuração de temperatura. Quando seleciona um, o controle deslizante de Criatividade na Configuração do Modelo é desativado com uma breve nota — isso é esperado, não é um erro.

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

As ferramentas, camadas de contexto e orquestração do Caiioo amplificam qualquer modelo que 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.