Adicione todo modelo do catálogo ao Chatbox com um provider personalizado.

Resposta rápida: um diálogo nas configurações de Model Provider.

Abra as Settings do Chatbox e mude para a aba Model Provider. Clique em Add, depois Add Custom Provider. Preencha o diálogo com cinco valores: um Name (APIsRouter), API Mode definido como OpenAI API Compatible, sua chave em API Key, https://api.apisrouter.com/v1 em API Host, e deixe API Path no padrão /chat/completions que o Chatbox preenche para um host terminando em /v1. Depois adicione modelos. O botão Fetch puxa a lista de modelos do endpoint por /v1/models para que você habilite ids do catálogo diretamente, e New deixa você digitar um id manualmente se preferir um seletor curto e curado. Clique em Check ao lado do campo de chave e o Chatbox roda uma requisição ao vivo; uma confirmação verde significa que o provider está conectado. Validamos esse fluxo exato contra o app web atual do Chatbox, e o mesmo diálogo vem nos builds de desktop e mobile.

Como o Chatbox fala com um provider personalizado.

O Chatbox (chatboxai no GitHub, cerca de 41 mil estrelas) é um dos clientes de chat de IA mais instalados: apps nativos para Windows, macOS e Linux, builds mobile para iOS e Android, e uma versão de navegador em web.chatboxai.app. Ele vem com entradas de primeira parte para os grandes fornecedores, cada uma querendo sua própria chave, e o diálogo de provider personalizado é o caminho documentado para todo o resto. Um provider personalizado no modo OpenAI API Compatible é uma descrição simples de um endpoint: host, caminho, chave, e uma lista de ids de modelo. Todo turno de conversa vira uma requisição padrão de chat-completions contra esse host, com o id de modelo do seletor viajando como uma string. O Chatbox não se importa com qual fornecedor treinou o modelo por trás de um id, o que é exatamente o que torna um gateway multi-fornecedor útil aqui: uma entrada de provider coloca claude-sonnet-4-6, gpt-5.5, gemini-3.5-flash, e deepseek-v4-flash no mesmo seletor, cobrados pela mesma chave. A diferença prática de empilhar quatro providers de primeira parte não é só menos chaves. As configurações do Chatbox sincronizam por dispositivo, então toda conta de fornecedor que você adiciona é mais uma chave para colar no seu celular, no seu laptop, e no app web. Um provider personalizado é uma colagem por dispositivo, e trocar uma conversa de Claude para DeepSeek é uma mudança de seletor em vez de uma mudança de provider.

Configuração completa: cada campo do diálogo.

Name é só um rótulo; APIsRouter mantém o seletor legível. API Mode precisa ser OpenAI API Compatible, o que diz ao Chatbox para falar chat completions padrão; o outro modo no menu suspenso é para endpoints nativos do Gemini e não é o que um gateway quer. API Host e API Path se compõem na URL de requisição, e esse par é onde as configurações dão errado. Com o host definido como https://api.apisrouter.com/v1, o caminho é /chat/completions, e o Chatbox preenche exatamente isso quando reconhece um host /v1. A documentação do Chatbox também descreve a convenção de host puro, onde o host omite /v1 e o caminho usa /v1/chat/completions por padrão; ambos se compõem na mesma URL, então escolha um formato e deixe o outro campo no padrão. O que quebra é misturar os dois, um host /v1 com um caminho /v1/chat/completions, o que produz uma URL /v1/v1 duplicada que dá 404. Os rótulos de campo e o comportamento de autopreenchimento mudam um pouco entre versões do Chatbox, então confie na URL composta em vez da memória. Para modelos, Fetch é o caminho de baixo esforço: o Chatbox lista tudo que o endpoint serve e você liga o que quer. New é o caminho curado: digite ids manualmente e o seletor fica curto. Cada linha de modelo tem interruptores de capacidade (visão, uso de ferramenta); deixe-os desligados a menos que você saiba que o modelo suporta a capacidade, já que um modelo não configurado é tratado como texto simples e esse é o padrão seguro. Termine com Check, depois inicie uma conversa e escolha um modelo sob o nome do seu novo provider.

Name:      APIsRouter
API Mode:  OpenAI API Compatible
API Key:   sk-YOUR-APISROUTER-KEY
API Host:  https://api.apisrouter.com/v1
API Path:  /chat/completions   (preenchido automaticamente)

Models: Fetch (puxa o catálogo) ou New (digite ids)
Depois: Check → confirmação verde

Escolhendo modelos para um cliente de chat diário.

Como todo modelo habilitado é cobrado por uma chave, comparar dois ids é uma troca de seletor em vez de uma decisão de conta. Rode o mesmo tipo de conversa nos dois por alguns dias, depois leia o gasto por modelo no console da APIsRouter e mantenha o que ganhou seu lugar.

• Perguntas do dia a dia e reescritas rápidas são trabalho em rajada. claude-haiku-4-5-20251001 e gemini-3.5-flash respondem rápido o suficiente para que o app pareça instantâneo, e carregam bem a maior parte do tráfego diário.
• Rascunhos longos, raciocínio cuidadoso, e discussões de código merecem claude-sonnet-4-6 ou gpt-5.5. Mantenha um de cada tier habilitado e troque por conversa em vez de por provider.
• deepseek-v4-flash é a escolha de volume se o Chatbox é sua barra lateral sempre aberta; conversas pequenas e constantes se acumulam e o tier rápido mantém o saldo se movendo devagar.
• Conversas com entrada de imagem precisam de um id capaz de visão com o interruptor de visão habilitado nessa linha de modelo; confirme a capacidade na documentação do modelo antes de ligar o interruptor.
• Habilite poucos modelos deliberadamente em vez de buscar tudo: cada toggle é uma linha do seletor, e adicionar outro id depois é uma edição de dez segundos.

Pague pelo uso · abaixo do preço oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modos de falha específicos do Chatbox.

O caminho duplicado é o clássico. Um 404 em toda mensagem significa que API Host e API Path carregam um /v1 os dois ou o caminho repete o que o host já termina; abra a entrada do provider e leia os dois campos como uma URL só. Um resultado vazio de Fetch geralmente significa que a chave está errada ou ausente, já que a listagem de modelo é ela mesma uma requisição autenticada. Verifique o campo API Key e use o botão Check, que expõe erros de autenticação diretamente. Um modelo que dá erro só em algumas conversas geralmente é um interruptor de capacidade: visão habilitada em um modelo sem entrada de imagem, ou um fluxo dependente de ferramenta batendo em um modelo com ferramentas desligadas. Reset a linha de modelo para os padrões e reabilite capacidades uma de cada vez. E lembre-se que a entrada de provider vive por instalação. Adicionar a APIsRouter no seu desktop não configura seu celular; repita o diálogo lá, ou use o compartilhamento de configuração do próprio Chatbox se sua versão oferecer isso. A única coisa que nunca precisa ser repetida são os cadastros de fornecedor, já que uma chave cobre todo modelo em todo dispositivo.

Quem roteia o Chatbox por um gateway.

• Pessoas que querem Claude, GPT, Gemini e DeepSeek em um seletor sem manter quatro contas de fornecedor e quatro chaves em três dispositivos.
• Usuários em regiões onde alguns cadastros de fornecedor são dolorosos; o acesso baseado em recarga sem exigência de cartão remove a dependência por provedor.
• Desenvolvedores que já roteiam seu editor e ferramentas de terminal por um gateway e querem seu cliente de chat na mesma chave e no mesmo log de uso.
• Compradores de modelo que comparam ids em conversas reais antes de comprometer um projeto com um só; cada candidato é uma linha do seletor, não uma conta.
• Famílias e times pequenos padronizando em um endpoint, um saldo, e visibilidade de uso por chave em vez de assinaturas espalhadas.

Verifique o endpoint e depure a primeira mensagem.

Prove a metade do gateway fora do Chatbox primeiro: liste os modelos com sua chave, depois rode uma chat completion contra um id que você planeja habilitar. Se os dois passarem, tudo que resta está no diálogo do provider. Dentro do Chatbox, o botão Check é o sinal mais rápido. Erros de autenticação são o campo de chave. Erros de não encontrado ao enviar são uma incompatibilidade de id, que acontece principalmente com entradas New digitadas à mão; copie ids da saída de /v1/models em vez de memória. 404s em toda requisição são a composição de host/caminho coberta acima. Assim que as mensagens fluem, o console da APIsRouter mostra modelo, contagens de token e gasto por requisição. Um cliente de chat gera muitas pequenas requisições ao longo do dia, e o log de uso é onde esse hábito vira um número por modelo, por dia que você consegue realmente ler.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Perguntas frequentes