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

Onze provedores em nuvem e locais estão disponíveis hoje em Settings > AI Setup > AI Provider:

  • OpenRouter (padrão) — uma única chave desbloqueia mais de 500 modelos, incluindo Anthropic Claude, Google Gemini, OpenAI GPT, Mistral, Groq, Llama, DeepSeek, Qwen 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 Gemini API usando sua própria chave do Google AI. O Google oferece uma cota gratuita genuína, tornando esta uma forma real de executar um modelo de ponta sem cartão de crédito — com raciocínio nativo e até 2M de contexto. O menu Settings orienta você na obtenção de uma chave gratuita.
  • Anthropic — uma conexão direta com a Claude API usando sua própria chave da Anthropic, com raciocínio estendido nativo junto ao uso de ferramentas. Crie uma chave em console.anthropic.com ou deixe o Caiioo criar uma após você aprovar o acesso à sua conta Claude. A cobrança da chave é feita na sua conta do Anthropic Console; o Caiioo não armazena as credenciais de login do Claude usadas para criá-la. A Anthropic não permite que uma assinatura Claude Pro ou Max seja usada em outros aplicativos, portanto, o Claude no Caiioo funciona por meio de uma chave do Console ou via OpenRouter, e não através da sua assinatura.
  • xAI (Grok) — acesso direto aos modelos Grok via api.x.ai. Conecte-se com uma chave de API do console da xAI ou faça login com sua conta Grok (assinatura SuperGrok ou X Premium+) — aprove o acesso no navegador e você estará conectado, sem necessidade de copiar chaves. 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.
  • OpenAI — uma conexão direta com os modelos da OpenAI usando sua própria chave de API da OpenAI, ou faça login com sua conta ChatGPT para que o Caiioo funcione com sua assinatura do ChatGPT em vez de uma chave.
  • CometAPI — mais de 500 modelos (GPT, Claude, Gemini, DeepSeek e mais) através de uma única chave CometAPI pré-paga (pay-as-you-go). O seletor de modelos exibe medalhas de nível de benchmark para seu catálogo, e o uso total da CometAPI é monitorado em Settings.
  • Poe — modelos da Anthropic, Google, OpenAI, xAI, Meta e outros através de uma única chave de API Poe, cobrados em pontos da sua assinatura Poe em vez de valores por token em dólares. Seu saldo de pontos restante e o quanto uma conversa consumiu são exibidos no aplicativo. Obtenha uma chave em poe.com/api/keys.
  • Ollama — executa modelos de código aberto localmente em sua máquina (http://localhost:11434 por padrão). Privado, sem necessidade de internet, gratuito. O Ollama Cloud também funciona com uma chave de API opcional.
  • vLLM, Unsloth e MLX (Pro) — conecte servidores de inferência locais ou em rede compatíveis com a OpenAI executando vLLM (http://localhost:8000 por padrão), Unsloth (http://localhost:8000 por padrão) ou MLX (http://localhost:8080 por padrão no Apple Silicon), com um bearer token opcional. Ao conversar pelo celular ou navegador em uma conversa hospedada no seu desktop, o Caiioo lista e executa os modelos no servidor local desse desktop automaticamente.

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

Primeiros Passos (Duas Opções)

Opção 1: Usar a Chave Provisionada Gratuita

Fornecemos uma chave gratuita do OpenRouter que permite testar o Caiioo imediatamente. Ela oferece acesso a modelos gratuitos selecionados com limites de uso — perfeita para experimentar.

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 essa mesma chave, além de qualquer saldo já existente.

Enquanto você estiver usando a chave inclusa, o campo da chave do OpenRouter em Configurações indicará isso em vez de parecer vazio — você verá uma observação informando que está usando a chave da conta do Caiioo e seu saldo restante. Suas chaves ficam armazenadas no seu dispositivo; com o Private Sync ativado, tanto a chave inclusa quanto a sua própria chave do OpenRouter são transferidas para 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 busca via Perplexity AI—precisam de créditos do OpenRouter, e não apenas de uma chave. Na chave provisionada gratuita, essas ferramentas informam "sem créditos". Você tem duas opções para prosseguir: 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 essa mesma chave provisionada com créditos a cada mês, para que essas ferramentas simplesmente funcionem.

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

Quer acesso total sem os limites do plano 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 Sign in with OpenRouter para conectar sua conta sem precisar copiar nada
  4. Pronto — 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 as etapas orientadas para "obter sua chave gratuita" (o Google AI Studio emite chaves gratuitamente, sem necessidade de 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 Manage ao lado de Anthropic credentials
  3. Clique em Create a key from your Claude account
  4. Aprove o acesso no navegador, cole o código de autorização de volta no Caiioo e clique em Connect

Você também pode clicar em Add API key e colar uma chave criada no Anthropic Console.

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 observação abaixo do campo da chave também indica esse link
  3. Cole a chave em Poe API Key

Seu saldo de pontos aparecerá abaixo da chave. Os custos da conversa são exibidos tanto em pontos do Poe quanto em dólares.

Ollama, vLLM, Unsloth ou MLX (servidores locais e de rede):

  1. Inicie seu servidor de modelo local (Ollama em http://localhost:11434, vLLM ou Unsloth em http://localhost:8000, ou MLX em http://localhost:8080)
  2. Vá para Configurações > Configuração de IA > Provedor de IA
  3. Selecione Ollama, vLLM, Unsloth ou MLX, confirme a URL do servidor (e a chave/token de API opcional para servidores remotos na sua rede) e escolha qualquer modelo disponibilizado pelo seu host

Ao escolher um modelo de chat local, ferramentas baseadas em IA que enviariam seus dados para um provedor de IA remoto podem solicitar sua aprovação primeiro. Consulte Privacidade e Dados → Ferramentas que Usam Outro Provedor de IA.

Configuração do modelo mostrando o Modelo Padrão e o Limite de Etapas

Um Caiioo Router e controle de Effort

Em vez de escolher entre diferentes modos de roteador ou tentar adivinhar qual modelo se adapta a uma tarefa, abra o seletor de modelos no compositor (ou Configurações > Configuração de IA > Configuração de modelo) para usar o Caiioo Router e o Effort:

  • Caiioo Router: Selecione o Caiioo Router no topo do seletor de modelos para exibir dois controles deslizantes interativos:
    • Custo ↔ Inteligência — deslize em direção a Menor custo para interações diárias rápidas e econômicas, Equilibrado para o melhor custo-benefício ou Maior inteligência para raciocínio de ponta.
    • Antialucinação — priorize a fundamentação factual e o rigor nas citações quando a precisão for indispensável.
    • Ao mover qualquer um dos controles, a lista de modelos abaixo filtra e reorganiza a ordem em tempo real para que você veja quais modelos atendem às suas preferências.
  • Controle de Effort: Quando um modelo selecionado (ou o Caiioo Router) oferece suporte ao esforço de raciocínio, um controle de Effort aparece diretamente no seletor de modelos. Escolha Automático (ou Desativado, Baixo, Médio, Alto, Máximo, dependendo do que o modelo suporta). O Caiioo Router classifica e seleciona modelos no nível de esforço definido para a conversa, em vez de assumir um padrão fixo.

Modelo para tarefas rápidas

Um modelo separado e mais econômico que o Caiioo utiliza automaticamente em segundo plano para itens como criação de títulos de conversas, classificação de intenções, escolha de qual ferramenta acionar e outras consultas auxiliares rápidas — você nunca interage com ele diretamente. Configure-o em Configurações → Configuração de IA → Configuração de modelo (um modelo gratuito pequeno do OpenRouter ou um modelo local do Ollama é mais do que suficiente). Caso não esteja definido, o sistema utiliza o seu modelo padrão como alternativa.

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

O BYOA é diferente do BYOK. Não serve para LLMs — serve para ligações de ferramentas (Google Workspace, Microsoft 365, GitHub, etc.). No Pro, Configurações → Conectores → Adicionar → Sua própria aplicação OAuth permite integrar o seu próprio cliente OAuth quando a sua organização não autoriza o ID de cliente predefinido do Caiioo:

  • Usar a Sua Própria Aplicação Google OAuth — passo a passo para criar um projeto no Google Cloud e colar o ID de cliente + segredo
  • Usar a Sua Própria Aplicação Microsoft Azure — mesmo fluxo para aplicações registadas no Azure
  • Adicionar Fornecedor OAuth Personalizado — fluxo OAuth 2.0 genérico para qualquer fornecedor compatível

Os assistentes guardam as credenciais no seu dispositivo. Elas nunca saem dele.

Manter Várias Contas ou Chaves por Fornecedor

Cada fornecedor pode guardar mais do que uma credencial — uma chave de trabalho juntamente com uma pessoal, ou uma conta com sessão iniciada juntamente com uma chave de API — com uma delas em utilização de cada vez. Acabou-se o substituir uma chave e ter de a colar novamente mais tarde.

Faça a gestão em Configurações > Conectores: cada fornecedor é uma linha do tipo Modelo de IA, e ao abri-la são listadas as suas contas e chaves. Ou clique em Gerir junto ao fornecedor em Configurações > Configuração de IA > Fornecedor de IA. Pode dar um nome a cada credencial (por ex., "Trabalho"), a que estiver ativa exibe a etiqueta Em utilização, e mudar requer apenas um clique em Utilizar. Remover uma credencial do Caiioo não revoga nada no fornecedor — a sua conta aí permanece intacta e 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 lida com a orquestração — ferramentas, contexto, fluxos de trabalho em 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 por meio da sua chave OpenRouter. Eles lidam melhor com raciocínio em várias etapas e uso de ferramentas.

Para respostas rápidas (perguntas, 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 que você teste 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 realmente 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 continua visível; ele apenas não possui medalhas ainda. Os custos totais utilizam as tarifas publicadas pelo provedor do serviço; se o Caiioo não conseguir estabelecer uma tarifa, ele omite o custo em vez de estimar.

Duas medalhas, duas perguntas diferentes. Um modelo pode receber uma medalha de ouro, prata ou bronze para uma delas ou para ambas:

  • Best for Caiioo classifica apenas com base na capacidade. O preço não entra na conta, portanto um modelo rápido e barato não pode liderar uma coluna chamada melhor.
  • Value for Caiioo é onde o preço entra — a melhor qualidade que você pode obter pelo que custa.

O Caiioo Router utiliza essas mesmas medições de benchmark diretamente: deslizar em direção a Balanced ou Lowest cost pondera o preço juntamente com a qualidade, enquanto deslizar em direção a Highest intelligence prioriza a capacidade. 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, time-to-first-token, precisão de ferramentas e preços, e detalha a metodologia — de onde vem cada número e o que compõe a pontuação de valor. As classificações para cada tipo de tarefa são publicadas uma vez e lidas tanto pelo aplicativo quanto pelo ranking em caiioo.ai, de modo que o que o roteamento escolhe e o que o ranking mostra são a mesma coisa. O ranking adiciona um detalhamento por Best by Use Case 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 sua própria criatividade e não aceitam uma configuração de temperatura. Quando você seleciona um deles, o controle deslizante de Criatividade em Model Configuration é desativado com uma breve nota — isso é o esperado, não um bug.

Para trabalho offline / totalmente privado: O Ollama executa modelos open-source na sua máquina. Mais lento do que 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.