Skip to main content

​
Resposta curta

Para conectar a BetterToken como uma API OpenAI personalizada no Cursor, insira uma BetterToken API Key, ative Override OpenAI Base URL e defina o valor como https://bettertoken.ai/v1. Depois, adicione um ID de modelo GPT atual da model plaza. A API Key, a Base URL e o ID de modelo devem pertencer ao mesmo provedor. A Base URL pública da BetterToken é https://bettertoken.ai/v1.

​
Quando isso é importante

  • Você quer usar no Cursor um provedor de terceiros compatível com OpenAI
  • Você precisa definir Override OpenAI Base URL
  • Você está adicionando um modelo personalizado
  • Você recebe erros de modelo não encontrado ou de autenticação
  • Você quer que Cursor, Codex e outras ferramentas compartilhem uma camada de roteamento de modelos

​
Significado dos campos

​
Etapas recomendadas

  1. Crie uma API Key no painel do provedor.
  2. Adicione a API Key nas configurações de modelos do Cursor.
  3. Insira a Base URL do provedor em Override OpenAI Base URL.
  4. Adicione ou selecione um ID de modelo aceito pelo provedor.
  5. Salve e teste com uma solicitação simples.

​
Solução de problemas

​
401 Unauthorized

Confirme que a BetterToken API Key foi copiada sem espaços extras e que o Cursor usa https://bettertoken.ai/v1. Não combine a API Key de um provedor com a Base URL de outro. Se a chave foi regenerada ou revogada, substitua-a no Cursor e teste novamente.

​
Model Not Found ou 404

Use o Model ID exato exibido na BetterToken Model Plaza, não o nome mostrado na interface. Confirme que o modelo está disponível pelo endpoint compatível com OpenAI e que a Base URL termina em /v1.

​
Corrigir o acesso proibido a redes privadas

O Cursor pode rejeitar localhost, 127.0.0.1, endereços de LAN privada ou outros endpoints não públicos. Com a BetterToken, mantenha a Base URL HTTPS pública https://bettertoken.ai/v1. Para um proxy local, siga as restrições atuais de rede local do Cursor.

​
Erros comuns

  • 401 Unauthorized: use uma BetterToken API Key ativa e remova espaços extras.
  • 404 Not Found: use https://bettertoken.ai/v1 como Base URL, não um caminho completo de solicitação.
  • Usar uma API Key de um provedor e a Base URL de outro.
  • Colocar o nome de um modelo Claude em uma configuração compatível com OpenAI.
  • Usar o nome exibido na interface em vez do ID de modelo da API.
  • Achar que as Cursor Rules afetam a autenticação da API.
  • Esquecer que uma substituição global pode afetar outros modelos OpenAI.

​
Sobre a BetterToken

O Cursor e ferramentas externas semelhantes geralmente usam uma configuração compatível com OpenAI. A Base URL da BetterToken é https://bettertoken.ai/v1, e os IDs de modelo vêm do provedor GPT na model plaza. Não use a URL https://bettertoken.ai do Claude Code na configuração compatível com OpenAI do Cursor.

​
Documentos relacionados

​
Referências