Cursor com uma API key para todos os modelos
Cole a chave da RelaySwitch no campo OpenAI API Key do Cursor, faça o override da Base URL para https://api.relayswitch.io/v1 e adicione os ids dos modelos que quer usar. Todo modelo de chat dessa chave pode entrar no seletor de modelos, e os modos Agent e Ask funcionam.
01Como funciona, e onde fica a configuração
O Cursor envia requisições no formato OpenAI, e todo modelo de chat da lista de modelos responde a esse formato. Assim, uma chave cobre Claude, GPT, Gemini e DeepSeek no mesmo seletor de modelos, cada um com seu preço por token atual, cobrado do saldo pré-pago.
A configuração fica em Cursor Settings (Cmd/Ctrl + ,), na seção Models. Os campos da chave e da Base URL ficam abaixo da lista de modelos.
02Passo a passo em Cursor Settings
- Ative OpenAI API Key e cole a chave completa do console.
- Ative Override OpenAI Base URL e preencha https://api.relayswitch.io/v1, com
/v1no final. - Clique em Save. Versões mais antigas do Cursor chamam esse botão de Verify.
- Em Models, adicione um a um os ids que quer usar, exatamente como aparecem na lista de modelos; ids de Claude também servem. Depois escolha um deles no painel de chat.
OpenAI API Key: sk-relay-...Override OpenAI Base URL: https://api.relayswitch.io/v1Models: gpt-6.1-sol03Para que serve cada campo
| OpenAI API Key | A credencial que o Cursor envia em cada requisição. Cole a chave completa do console. |
| Override OpenAI Base URL | Envia essas requisições para https://api.relayswitch.io/v1, e não para a OpenAI. |
| Models | A lista oferecida pelo seletor de modelos. Adicione cada id que quer usar exatamente como está na lista de modelos, e não o nome de exibição. |
04Como escolher o modelo para o Cursor
Uma requisição do Agent leva a conversa, os arquivos lidos pelo Cursor e os resultados das ferramentas, então os tokens de entrada são a maior parte da conta. Modelos com preço de entrada baixo dão o menor custo por requisição. A tabela a seguir traz os principais modelos em USD por milhão de tokens; a página de cada modelo lista os preços de entrada, entrada em cache e saída.
| Modelo | Desenvolvedor | Entrada | Saída | Contexto |
|---|---|---|---|---|
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| DeepSeek V4.1 Flash 1017deepseek-v4.1-flash-1017 | DeepSeek | $0.2425 | $1.164 | 1,048,576 |
| GLM 5.3 Flashglm-5.3-flash | Z.ai | $0.0873 | $0.1455 | 1,000,000 |
| GPT-6 Lunagpt-6-luna | OpenAI | $0.0625 | $0.20 | 1,050,000 |
| Qwen3.8 Maxqwen3.8-max | Qwen | $0.80 | $2.40 | 991,000 |
| Minimax M3.1 Flashminimax-m3.1-flash | MiniMax | $0.105 | $0.42 | 1,000,000 |
| Gemini 3.8 Flashgemini-3.8-flash | $0.4925 | $2.25 | 1,048,576 | |
| Grok 4.7grok-4.7 | xAI | $0.60 | $1.80 | 500,000 |
| Kimi K3kimi-k3 | Moonshot AI | $0.90 | $4.50 | 1,048,576 |
USD por milhão de tokens
05Modo Agent e modelos GPT
Com o override da Base URL ativo, o modo Agent do Cursor envia um corpo de requisição no formato da Responses API para o caminho Chat Completions nos modelos GPT. O Cursor registra isso como known issue no fórum dele.
O gateway lê esse corpo como a requisição Chat Completions pretendida e responde no formato Chat Completions, com ou sem streaming. Os ids de GPT funcionam nos modos Agent e Ask pelo mesmo preço. Se você prefere um agente no terminal, veja a página Codex e a página Claude Code.
06Como verificar a conexão
Envie uma requisição igual à que o Cursor envia, da mesma máquina. Depois envie uma mensagem no Cursor com um dos seus ids selecionado; a requisição aparece na página Usage do console, com tokens e custo.
curl https://api.relayswitch.io/v1/chat/completions \ -H "Authorization: Bearer sk-relay-..." \ -H "content-type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Reply with ok"}]}'07Cobrança, cache e erros mais comuns
A criação da chave e a definição de orçamento por chave estão na página Claude API key. O que é preciso saber sobre a cobrança, e depois os quatro erros mais frequentes:
- As requisições são cobradas por token, pelo preço do modelo, do seu saldo pré-pago.
- Quando a resposta informa tokens de entrada em cache, eles são cobrados pelo preço de entrada em cache do modelo, e não pelo preço de entrada. Uma conversa longa que repete o mesmo prefixo sai mais barata por turno do que uma conversa nova.
- Nos planos Teams e Enterprise do Cursor, o Cursor conta as requisições feitas com chave própria no uso do plano e acrescenta a sua própria taxa por token. Essa taxa é cobrada pelo Cursor, não aqui. Segundo a documentação de API keys do Cursor, os planos individuais não entram nessa conta.
401 invalid_api_key | A chave está errada ou foi revogada. Copie de novo do console. |
404 model_not_found | O id no seletor de modelos não existe na lista de modelos. Procure erro de digitação, ou um nome de exibição escrito no lugar do id. |
402 insufficient_balance | Recarregue no console; a chave volta a funcionar na hora. |
| Falha no Verify | A causa mais comum é a Base URL sem /v1. Execute o curl da seção anterior na mesma máquina. |
Perguntas frequentes
- A Base URL no Cursor precisa de /v1?
- Sim. Preencha Override OpenAI Base URL com https://api.relayswitch.io/v1, e o Cursor acrescenta /chat/completions ao final. A causa mais comum de falha no Verify é o /v1 esquecido.
- Os modelos Claude funcionam no Cursor AI com esta chave?
- Sim. Todo modelo de chat da lista de modelos responde ao formato OpenAI que o Cursor envia, então ids de Claude, GPT, Gemini e DeepSeek podem ser adicionados ao mesmo seletor de modelos com uma única chave.
- O modo Agent funciona com API key própria?
- Sim, os modos Agent e Ask funcionam. Nos modelos GPT, o modo Agent envia um corpo no formato Responses para o caminho Chat Completions; o gateway o lê como requisição Chat Completions e responde nesse formato, pelo mesmo preço.
- É preciso ativar o streaming?
- Não. O Cursor usa streaming por padrão e não tem botão para isso. Todos os modelos suportam streaming.
- O Cursor cobra alguma taxa extra por usar chave própria?
- Segundo a documentação de API keys do Cursor, nos planos Teams e Enterprise as requisições com chave própria contam no uso do Cursor e pagam uma taxa por token do Cursor, cobrada pelo Cursor. Os planos individuais não entram nessa conta. Aqui as requisições são cobradas por token, pelo preço do modelo, do saldo pré-pago.
- Como recarregar o saldo para usar no Cursor?
- Recarregue no console com cartão, incluindo Apple Pay e Google Pay, ou USDT, USDC, BTC, ETH, SOL, a partir de $10. O saldo é registrado em dólares americanos, não expira, e não há assinatura.
Todos os modelos no seletor do Cursor
Uma chave, saldo pré-pago, pagamento com cartão ou cripto.