Configurar a BetterToken no Cherry Studio: provedor personalizado, API Host e modelos
Adicione a BetterToken ao Cherry Studio como provedor personalizado compatível com OpenAI ou Anthropic, adicione Model IDs, verifique a conexão e corrija erros comuns.
Para conectar o Cherry Studio à BetterToken, adicione um provedor personalizado, informe sua BetterToken API Key e o API Host e, em seguida, adicione um Model ID atual do catálogo de modelos.
Configurações principais
| Campo | Valor |
|---|---|
| Tipo de provedor | OpenAI (compatível com OpenAI) |
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai (API Host) |
| Modelo | Um Model ID atual do catálogo de modelos |
Pré-requisitos
- A versão atual do Cherry Studio instalada
- Uma BetterToken API Key: cadastre-se e obtenha uma
- Um Model ID do catálogo de modelos
Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.
Instalação
Baixe o Cherry Studio para o seu sistema no site oficial ou em GitHub Releases, instale e abra. Nenhum plugin extra é necessário.
Configuração manual
Toda a configuração é feita nas configurações do Cherry Studio. Não é preciso editar nenhum arquivo de configuração.
Adicionar um provedor personalizado
Abra Settings → Model Provider, clique em Add, digite um nome como BetterToken e escolha o tipo de provedor OpenAI.
Informar a API Key e o API Host
- API Key → sua BetterToken API Key
- API Host →
https://bettertoken.ai
O Cherry Studio acrescenta o caminho da requisição sozinho. Confira a prévia da URL abaixo do campo: ela deve ser https://bettertoken.ai/v1/chat/completions. Não cole uma URL completa com /chat/completions em API Host.
Adicionar modelos
Clique em Manage para buscar a lista de modelos, ou em Add para digitar um Model ID manualmente, por exemplo claude-sonnet-5-5, gpt-6-sol ou deepseek-flash.
Verificar a conexão
Clique em Check, selecione um dos modelos adicionados e aguarde a mensagem de sucesso. Depois ative o provedor.
Usar o protocolo Anthropic
Para modelos Claude, você pode adicionar um segundo provedor personalizado do tipo Anthropic com API Host https://bettertoken.ai. O Cherry Studio passa a enviar as requisições para /v1/messages. Use esse provedor apenas para modelos Claude. Para todos os outros modelos, use o tipo de provedor OpenAI.
Verificar a conexão
Inicie uma nova conversa, escolha um modelo da BetterToken no seletor e envie Responda com uma só palavra: OK. Uma resposta normal indica que a configuração funciona.
Trocar de modelo
Escolha outro modelo da BetterToken no seletor de modelo da conversa. Se o modelo ainda não estiver na lista, abra o provedor BetterToken, clique em Add e informe o Model ID exato do catálogo de modelos.
Erros comuns
| Erro | O que verificar |
|---|---|
401 / Unauthorized | Verifique a BetterToken API Key e remova espaços no início ou no fim. |
404 | Verifique se API Host é https://bettertoken.ai e se a prévia da URL termina em /v1/chat/completions apenas uma vez. |
model not found | Copie um Model ID atual do catálogo de modelos. |
| Lista de modelos vazia | Adicione o Model ID manualmente com Add. |
Configuração avançada
Guias relacionados
Detalhes técnicos
Protocolo e endpoint
O tipo de provedor OpenAI envia as requisições para https://bettertoken.ai/v1/chat/completions e o tipo Anthropic para https://bettertoken.ai/v1/messages. Nos dois casos, informe apenas https://bettertoken.ai em API Host.

