Pular para o conteúdo
Cadastre-se grátis
Configuração de plataformas de aplicações de IA

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

CampoValor
Tipo de provedorOpenAI (compatível com OpenAI)
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai (API Host)
ModeloUm Model ID atual do catálogo de modelos

Pré-requisitos

Cadastre-se e obtenha uma BetterToken API Key

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

ErroO que verificar
401 / UnauthorizedVerifique a BetterToken API Key e remova espaços no início ou no fim.
404Verifique se API Host é https://bettertoken.ai e se a prévia da URL termina em /v1/chat/completions apenas uma vez.
model not foundCopie um Model ID atual do catálogo de modelos.
Lista de modelos vaziaAdicione 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.