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.

Supported Providers

Sete 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 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 Google Gemini com a sua própria chave do Google AI. O Google oferece uma cota gratuita genuína, portanto, esta é uma maneira real de usar um modelo de fronteira 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.
  • Anthropic — uma conexão direta com a API do Claude com a sua própria chave da Anthropic, com raciocínio estendido nativo junto ao uso de ferramentas. Crie uma chave em console.anthropic.com ou permita que o Caiioo crie uma após você aprovar o acesso à sua conta do Claude. A chave é cobrada na sua conta do Console da Anthropic; o Caiioo não retém o login do Claude usado para criá-la.
  • xAI (Grok) — acesso direto aos modelos Grok via api.x.ai. Conecte-se com uma chave de API do console da xAI ou simplesmente faça login com sua conta do Grok (assinatura SuperGrok ou X Premium+) — aprove o acesso no navegador e você estará conectado, sem precisar copiar chave. Observação: 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 da xAI em vez disso.
  • CometAPI — mais de 500 modelos (GPT, Claude, Gemini, DeepSeek e muito mais) através de uma única chave pay-as-you-go da CometAPI. O seletor de modelos exibe medalhas de nível de benchmark para seu catálogo, e o uso total da CometAPI é rastreado em Configurações.
  • Poe — modelos da Anthropic, Google, OpenAI, xAI, Meta e outros através de uma única chave de API do Poe, cobrados nos pontos da sua assinatura do Poe em vez de dólares por token. O saldo de pontos restante e o gasto de um tópico são exibidos no aplicativo. Obtenha uma chave em poe.com/api/keys.
  • Ollama — executa modelos de código aberto localmente no seu computador. Totalmente privado, sem necessidade de internet, gratuito. Útil para trabalhos 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 (OpenAI, MLX e outros) estão em fase de testes e ainda não estão geralmente disponíveis. 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/mes aplicado automaticamente a esta mesma chave, além de qualquer saldo que já esteja lá.

Enquanto você estiver na chave inclusa, o campo da chave do 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 seu saldo restante. Suas chaves são armazenadas no seu dispositivo; com a Sincronização Privada ativada, tanto a chave inclusa quanto a sua própria chave do OpenRouter vão para os seus outros dispositivos dentro do seu backup criptografado.

Ferramentas que consomem créditos—geração de imagem, vídeo e música, OCR avançado e pesquisa do 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 alternativas: inserir sua própria chave de API do OpenRouter (BYOK) em Configurações > Configuração de IA > Provedor 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: Trazer 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 → Configuração de IA → 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 → Configuração de IA → Provedor de IA e selecione Google AI
  2. Siga os passos guiados 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

Anthropic (Claude direto):

  1. Vá para Configurações → Configuração de IA → Provedor de IA e selecione Anthropic
  2. Clique em Gerenciar ao lado de Credenciais da Anthropic
  3. Em Contas Conectadas, clique em Criar uma chave a partir da sua conta Claude
  4. Aprove o acesso no navegador, cole o código de autorização de volta no Caiioo e clique em Conectar

Você também pode clicar em Adicionar chave de API e colar uma chave que você criou no Console da Anthropic.

Poe:

  1. Vá para Configurações → Configuração de IA → Provedor de IA e selecione Poe
  2. Crie uma chave em poe.com/api/keys — a nota abaixo do campo da chave aponta para lá também
  3. Cole a chave em Chave de API do Poe

Seu saldo de pontos aparece abaixo da chave. Os custos de conversação aparecem tanto em pontos do Poe quanto em dólares.

Ollama (local):

  1. Instale o Ollama a partir de ollama.com e baixe um modelo (ollama pull llama3.2)
  2. Vá para Configurações → Configuração de IA → 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, ferramentas impulsionadas 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 de Modelo mostrando o Modelo Padrão e o Máximo de Passos

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 conversas, classificar 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 IA → 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 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 plano Pro, Configurações → Conta → Autorizações e Permissões de Conta permite que você conecte seu próprio cliente OAuth quando sua organização não inclui o ID de cliente padrão do Caiioo na lista de permissões:

  • Use seu próprio aplicativo Google OAuth — siga as etapas para criar um projeto no Google Cloud e colar o ID do cliente + segredo
  • Use seu próprio aplicativo Microsoft Azure — o mesmo fluxo para aplicativos registrados no Azure
  • Adicionar provedor OAuth personalizado — fluxo genérico do OAuth 2.0 para qualquer provedor que o suporte

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

Mantenha Várias Contas ou Chaves por Provedor

Cada provedor pode conter mais de uma credencial — uma chave de trabalho junto com uma pessoal, ou uma conta conectada junto com uma chave de API — com uma delas em uso por vez. Chega de sobrescrever uma chave e colá-la de volta mais tarde.

Gerencie-as em Configurações > Conta > Autorizações e Permissões de Conta, em Contas de Provedor de IA (com as guias Contas Conectadas e Chaves de API) — ou clique em Gerenciar ao lado do provedor em Configurações > Configuração de IA > Provedor de IA. Você pode nomear cada credencial (por exemplo, "Trabalho"), a ativa possui um selo Em uso, e a troca é feita com um clique em Usar. Remover uma credencial do Caiioo não revoga nada no provedor — sua conta lá permanece intacta e você pode adicioná-la novamente mais tarde.

Segurança de Chaves de API

Suas chaves de API são armazenadas localmente no seu dispositivo. Com a Sincronização Privada ativada, suas chaves e contas de provedor conectadas são criptografadas no dispositivo antes de entrarem no seu backup de sincronização, sendo então descriptografadas apenas nos seus outros dispositivos. Os servidores do Caiioo nunca recebem credenciais legíveis. Quando você faz uma solicitação, o dispositivo que executa a conversa envia sua própria credencial ativa diretamente para o provedor de IA. Veja 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 em múltiplas etapas. Mas a qualidade das respostas da IA depende do modelo que você escolher.

Para tarefas complexas (pesquisa, análise, documentos longos): use um modelo de ponta — Claude Sonnet, classe GPT ou Gemini Pro — todos acessíveis por meio da sua chave do OpenRouter. Eles lidam melhor com raciocínio em múltiplas etapas e uso de ferramentas.

Para respostas rápidas (dúvidas, resumos, edições simples): modelos rápidos — Claude Haiku, variantes menores do GPT ou Gemini Flash — são mais baratos e mais 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. Descubra o que funciona melhor para o seu fluxo de trabalho sem se comprometer com um único provedor.

O seletor de modelos descreve as capacidades do provedor que efetivamente fornece cada modelo e exibe medalhas de benchmark onde houver medições disponíveis. Um modelo recém-lançado ou ainda não avaliado permanece visível; ele apenas não possui medalhas ainda. Os custos totais utilizam as tarifas publicadas pelo provedor de serviço; se o Caiioo não conseguir determinar uma tarifa, ele omite o custo em vez de fazer uma estimativa.

Duas medalhas, duas questões diferentes. Um modelo pode receber uma medalha de ouro, prata ou bronze em uma ou em ambas as categorias:

  • Melhor para o Caiioo avalia apenas a capacidade. O preço não faz parte disso, portanto um modelo rápido e barato não pode liderar uma coluna chamada melhor.
  • Custo-benefício para o Caiioo é onde o preço entra — a melhor qualidade que você pode obter pelo que custa.

O roteamento automático segue a mesma divisão: o Value Router pondera o custo, os outros roteadores não. O que você vê no seletor é o critério que o aplicativo realmente usa para escolher.

Veja as medições por trás das medalhas. O Model Intelligence (Caiioo Benchmarks, Pro) compara qualidade, throughput, tempo até o primeiro token, precisão no uso de ferramentas e preços, e detalha a metodologia — de onde vem cada número e o que entra no cálculo da pontuação de custo-benefício. As classificações para cada tipo de tarefa são publicadas uma única vez e consultadas tanto pelo aplicativo quanto pelo leaderboard em caiioo.ai, de modo que a escolha do roteamento e o que é exibido no leaderboard são exatamente a mesma coisa. O leaderboard inclui um detalhamento por Melhor por Caso de Uso se você quiser ver qual modelo lidera em programação, pesquisa ou escrita, em vez de apenas no geral.

Uma observação sobre o controle deslizante de Criatividade: os modelos mais recentes (como o Claude Sonnet 5 e posteriores) gerenciam a própria criatividade e não aceitam uma configuração de temperatura. Quando você seleciona um deles, o controle deslizante de Criatividade em Configuração do Modelo é desativado com uma breve observação — isso é o esperado, não um bug.

Para trabalhos offline / totalmente privados: 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.