Cursor

Cursor: API OpenAI própria, Base URL, API Key e modelos

Conecte o Cursor com BetterToken API Key, Override OpenAI Base URL e um ID de modelo GPT. Resolva erros 401 e de modelo não encontrado.

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

Campo	Função
API Key	Credencial de autenticação
Base URL	Endpoint compatível com OpenAI, geralmente uma URL com `/v1`
ID de modelo	Identificador de modelo reconhecido pelo provedor
Modelo personalizado	Modelo adicionado ou selecionado manualmente no Cursor

Etapas recomendadas

Crie uma API Key no painel do provedor.
Adicione a API Key nas configurações de modelos do Cursor.
Insira a Base URL do provedor em Override OpenAI Base URL.
Adicione ou selecione um ID de modelo aceito pelo provedor.
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.
Copie o Model ID exato da model plaza.
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

Use https://bettertoken.ai no Claude Code e https://bettertoken.ai/v1 no Codex CLI e em ferramentas OpenAI-compatible. Escolha o endereço de acordo com o protocolo do cliente. Copie o Model ID exato da model plaza.

Não use a URL https://bettertoken.ai do Claude Code na configuração compatível com OpenAI do Cursor.