Chatbox: use Claude e GPT com um provedor de API próprio

O Chatbox (Chatbox AI) é um cliente de chat para Windows, macOS, Linux, iOS, Android e web. Além do próprio serviço pago, o Chatbox AI, ele permite usar sua própria chave de API com vários provedores, inclusive qualquer serviço no formato OpenAI ou Claude API por meio de um provedor personalizado.

A APIVAI se conecta exatamente assim. Uma chave da APIVAI dá acesso a modelos Claude e GPT, com cobrança por token abaixo dos preços oficiais a partir de um saldo que você mesmo recarrega, sem assinatura. A mesma chave funciona no computador e no celular, então você configura o Chatbox uma vez em cada aparelho e acompanha todo o consumo em um único Painel.

Ao adicionar um provedor personalizado, o Chatbox pede um API Mode. Dois modos servem para a APIVAI:

Escolha OpenAI API Compatible se quiser Claude e GPT no mesmo provedor; é a configuração mais simples. Adicione também um provedor Claude API Compatible se você usa principalmente Claude: o Chatbox só mostra os controles de raciocínio (thinking) para um modelo Claude quando ele é acessado no estilo Claude API. A mesma chave funciona nos dois. O Chatbox também oferece OpenAI Responses API Compatible; você não precisa dele neste guia.

Atenção à regra do /v1, diferente da de muitas outras ferramentas: no modo Claude do Chatbox, o API Host precisa incluir /v1, porque o Chatbox só acrescenta /messages. Abaixo dos campos, o Chatbox mostra uma Preview da URL final. No modo OpenAI ela deve ser https://api.apivai.com/v1/chat/completions e no modo Claude https://api.apivai.com/v1/messages.

1. Cadastre-se em apivai.com com seu e-mail.
2. Recarregue o saldo a partir de $10 com cartão, cripto, Alipay ou WeChat Pay. Não há teste grátis; você paga só pelo que usar.
3. Abra o Painel, crie uma chave e copie. Você pode definir um limite de orçamento para ela, o que é útil em um app de celular.

1. Abra Settings → Model Provider. No celular, toque antes no menu do canto superior esquerdo para abrir a barra lateral.
2. Clique em Add e selecione Add Custom Provider.
3. Digite APIVAI em Name, escolha OpenAI API Compatible em API Mode e confirme com Add.
4. Preencha as configurações do provedor:

Confira se a linha Preview mostra https://api.apivai.com/v1/chat/completions, com /v1 uma única vez.

Em Models, clique em Fetch para carregar os modelos que sua chave pode usar, ou em New para adicionar um manualmente:

Adicione uma entrada por modelo. Os IDs mudam com o tempo, então copie-os de Fetch, de GET https://api.apivai.com/v1/models ou da página de preços, e não de guias antigos.

Clique em Check para testar a chave e o endereço, escolha o novo modelo no seletor de uma conversa e envie uma mensagem.

Repita o passo 2 com Name APIVAI Claude e API Mode Claude API Compatible. Use a mesma API Key e o API Host https://api.apivai.com/v1; deixe API Path vazio. A Preview deve mostrar https://api.apivai.com/v1/messages. Adicione aqui apenas modelos Claude, como claude-sonnet-4-6 ou claude-opus-5-5. A página Claude API proxy explica o formato Anthropic.

Preços por 1M de tokens em 2026-10-07. Todos os modelos estão na página de preços.

Para a maioria, o Claude Sonnet 4.6 é um bom padrão. Troque para Claude Haiku 4.5 ou GPT-6 Luna em tarefas curtas e rápidas, e para Claude Opus 5.5 só quando a pergunta realmente exigir.

Você paga só pelos tokens. Cada mensagem reenvia a conversa até ali, então em conversas longas cada turno custa mais. O raciocínio (thinking) vem ativado por padrão e seus tokens são cobrados como saída.

• Chat do dia a dia: considere cerca de 2.500 tokens de entrada (sua mensagem mais o histórico recente) e 700 de saída por turno, 30 turnos por dia durante 30 dias (900 turnos). Com o Claude Sonnet 4.6 são $5.63 por mês, contra $16.20 no preço oficial. Com o Claude Haiku 4.5 o mesmo mês custa $1.88, e com o GPT-6 Luna $0.0808.
• Perguntas difíceis: 10 perguntas ao Claude Opus 5.5 com cerca de 8.000 tokens de entrada e 2.000 de saída cada custam $0.25 ($0.72 no preço oficial).

Comece uma conversa nova quando o assunto mudar e limite quantas mensagens anteriores o Chatbox envia, se sua versão permitir isso nas configurações da conversa. O Painel mostra cada requisição com tokens e custo. Para uma comparação completa, veja Preços da API do Claude comparados.

O chat funciona totalmente pela APIVAI, mas uma base de conhecimento precisa de um Embedding Model para indexar seus arquivos, e a APIVAI não oferece embeddings. Configure um provedor de embeddings separado para a base de conhecimento; o modelo que responde pode continuar sendo Claude ou GPT da APIVAI. Geração de imagens também não está disponível na APIVAI.

• 401 ou "invalid API key": a chave foi copiada com espaço ou quebra de linha, foi excluída ou esgotou o orçamento. Copie de novo no Painel e confira o saldo.
• 404: olhe a linha Preview. No modo OpenAI ela deve ser https://api.apivai.com/v1/chat/completions; um host sem /v1 junto com um API Path, ou /v1 duplicado, gera 404. No modo Claude deve ser https://api.apivai.com/v1/messages; aqui https://api.apivai.com sem /v1 gera 404.
• Modelo não encontrado: o Model ID precisa ser exato, por exemplo claude-sonnet-4-6. Modelos GPT falham em um provedor Claude API Compatible; adicione-os ao provedor OpenAI.
• Respostas vazias ou cortadas: tokens de raciocínio contam no limite de saída. Aumente Max Output Tokens na entrada do modelo ou nas configurações da conversa para 4096 ou mais.
• Erros de conexão ou streaming interrompido: ative Improve Network Compatibility nas configurações do provedor e tente de novo.
• 429: o limite padrão é de 60 requisições por minuto por chave; aguarde um pouco ou peça ao suporte um limite maior.

A documentação traz todos os endpoints e códigos de erro.

Sim, nos dois modos: https://api.apivai.com/v1. O Chatbox acrescenta depois /chat/completions (do API Path) ou /messages. Confira na linha Preview.

Não. Um provedor personalizado usa sua própria chave, e a APIVAI cobra por token a partir de um saldo pré-pago. Os planos pagos do Chatbox são um serviço à parte.

Sim. Adicione o mesmo provedor personalizado no app do Chatbox para celular. Uma chave funciona em todos os aparelhos; defina um limite de orçamento se quiser um teto de gastos.

Sim. Uma chave da APIVAI vale para todos os modelos da página de preços, no formato OpenAI e no formato Claude. Ela também funciona no Cherry Studio e em outras ferramentas compatíveis com OpenAI.

Não. O conteúdo de requisições e respostas não é registrado; só ficam dados de uso como modelo, tokens e custo, para a cobrança.

Crie uma conta, recarregue a partir de $10 e cole sua chave no Chatbox.