Use o Cursor com uma API LLM gratuita
O Cursor pode enviar requisições de chat para a sua própria chave de API da OpenAI. Este guia mostra como conectar essa chave a modelos gratuitos pelo FreeLLMAPI. Ele também informa os limites. O Cursor envia cada requisição pelos seus próprios servidores, e o Tab sempre usa os modelos do Cursor.
O código, os nomes dos modelos e os rótulos do catálogo ao vivo são exibidos em inglês.
O que funciona e o que não funciona
Leia esta seção antes de começar. O suporte do Cursor a chaves próprias é mais restrito que o da maioria dos outros editores.
| Recurso do Cursor | Com sua própria chave | Fonte |
|---|---|---|
| Chat com um modelo padrão no estilo OpenAI | Sim. O Cursor documenta chaves próprias da OpenAI para modelos de chat padrão, sem raciocínio. | Página de ajuda sobre chaves de API do Cursor |
| Completar com Tab | Não. O Cursor diz que o Tab continua usando os modelos integrados do Cursor. | Página de ajuda sobre chaves de API do Cursor |
| Modo Agent e Composer | Não confirmado. A documentação do Cursor cita apenas modelos de chat. Teste no seu plano antes de depender disso. | Não documentado |
| Requisições de localhost | Não. O Cursor envia todas as requisições pelos seus servidores para montar o prompt, então o localhost do seu computador não faz parte do caminho. | Página de ajuda sobre chaves de API do Cursor |
Os planos também são importantes. A página de preços do Cursor lista modelos de terceiros e chaves de API próprias nos planos Premium, Super e Ultra. Ela diz que o plano Plus não tem chaves de API próprias. Para o plano Free, a página lista os modelos de terceiros como não disponíveis. Confira a página de preços do seu plano antes de continuar.
localhost. Leia Cline, Roo Code e Kilo Code com uma API gratuita.Etapa 1: instale o FreeLLMAPI e torne-o acessível
O FreeLLMAPI é de código aberto e roda no seu computador com Docker. Instale-o e depois adicione pelo menos duas chaves gratuitas de provedores na página Keys.
Instale no macOS ou no Linux
curl -fsSL https://freellmapi.co/install.sh | bashCopie sua chave unificada da página Keys. Depois, dê ao gateway um endereço HTTPS público, porque os servidores do Cursor não conseguem acessar seu localhost. Use um túnel HTTPS confiável ou um servidor que você controle. O guia do FreeLLMAPI para o Cursor exibe estes passos:
Imprima o guia do Cursor
npx freellmapi setup-cursorEste comando não grava nenhum arquivo. O Cursor não tem arquivo de configuração para esta opção, então você informa os valores nas configurações do Cursor.
Authorization, crie um token de URL revogável separadamente em Keys, Agents. Revogue-o quando parar.Etapa 2: defina a chave e a URL base no Cursor
- Abra Cursor Settings.
- Abra Models.
- Localize o campo da chave de API da OpenAI. Cole sua chave unificada do FreeLLMAPI. Clique em Save.
- Ative a substituição da URL base da OpenAI. O guia do FreeLLMAPI chama esta opção de Override OpenAI Base URL.
- Informe seu endereço público com
/v1no final, por exemplohttps://<your-tunnel-host>/v1. - Selecione um modelo no seletor de modelos e envie uma mensagem curta no chat.
A documentação de privacidade do Cursor menciona a substituição da URL base compatível com OpenAI. O Cursor não documenta os passos exatos. Os rótulos na sua versão podem ser diferentes.
Para confirmar que as requisições chegam ao gateway, abra o log de requisições do painel. Cada resposta também tem um cabeçalho X-Routed-Via que mostra o provedor e o modelo que responderam.
Etapa 3: escolha os modelos
Use o id de modelo auto para deixar o roteador escolher um modelo gratuito para cada requisição. Você também pode usar um id do catálogo de GET /v1/models. O chat do Cursor envia contexto de arquivos com cada mensagem, então use modelos com uma janela de contexto grande. A tabela mostra os modelos gratuitos com tool calling e pelo menos 128K de contexto hoje.
| Modelo | Gratuito em | Contexto | Limites gratuitos (melhor oferta) | Ferramentas | Visão |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Sim | Não |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Sim | Sim |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Sim | Sim |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Sim | Não |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/dia 250,000 tokens/min ~3M | Sim | Sim |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Sim | Sim |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/dia 50 req/day account-wide (1,000 after a $10 purchase) | Sim | Sim |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/dia Shared rate limit | Sim | Não |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/dia 70,000 tokens/min ~6M | Sim | Sim |
Mostrando 10 de 109 modelos gratuitos correspondentes. Ver todos os modelos.
Dados ao vivo do catálogo FreeLLMAPI (versão 2026.11.19, verificado em 2026-11-19). Os limites gratuitos mudam com frequência. O catálogo é verificado todos os dias.
O Cursor documenta chaves próprias da OpenAI para modelos de chat sem raciocínio. Modelos de raciocínio podem falhar com a substituição. Se um modelo falhar, use auto ou outro modelo da tabela.
Limites de taxa e failover
Cada nível gratuito tem limites por minuto e por dia. O FreeLLMAPI conta o uso de cada chave. Quando um provedor envia um erro 429, o roteador envia a requisição ao próximo modelo da sua cadeia de fallback. O chat continua, e você não precisa mudar nenhuma configuração no Cursor.
- Adicione chaves de quatro ou mais provedores. Mais provedores dão mais requisições por dia.
- Use
auto:fastpara perguntas curtas eauto:smartpara perguntas difíceis de código. - Comece um novo chat para cada tarefa. Um histórico menor envia menos tokens.
Solução de problemas
| Problema | Causa | Correção |
|---|---|---|
O Cursor não consegue se conectar a http://localhost:3001/v1 | O Cursor envia as requisições dos seus servidores, não do seu computador | Use um endereço HTTPS público para o gateway |
| Nenhuma opção de chave própria | Seu plano do Cursor não inclui chaves de API próprias | Confira a tabela de planos na página de preços do Cursor |
401 "Invalid API key" | A chave no Cursor não é sua chave unificada do FreeLLMAPI | Copie a chave unificada de novo na página Keys |
| O completar com Tab não usa o gateway | O Cursor sempre usa os próprios modelos para o Tab | Sem correção. Use o Continue no VS Code para completar código gratuitamente |
| "Todos os modelos com limite de taxa após N tentativas" | Todas as chaves da cadeia atingiram o limite | Adicione chaves de mais provedores ou aguarde as esperas |
| Os modelos integrados deixam de funcionar | A substituição da URL base continua ativa | Desative a substituição |
Perguntas frequentes
Posso usar o Cursor de graça com minha própria chave de API?
A página de preços do Cursor lista chaves de API próprias nos planos Premium, Super e Ultra, e diz que o plano Plus não tem chaves próprias. Em um plano com chaves próprias, o FreeLLMAPI fornece modelos gratuitos para o chat, então a inferência custa US$ 0.
Por que o Cursor não se conecta a localhost?
O Cursor envia todas as requisições pelos seus próprios servidores para montar o prompt. Esses servidores não conseguem acessar o localhost do seu computador, então o gateway precisa de um endereço HTTPS público.
O completar com Tab do Cursor funciona com uma API personalizada?
Não. A documentação do Cursor diz que chaves de API personalizadas funcionam somente com modelos de chat, e o completar com Tab continua usando os modelos integrados do Cursor.
Qual modelo gratuito é o melhor para o Cursor?
Use auto, ou um modelo com tool calling e pelo menos 128K de contexto da tabela desta página. O Cursor envia contexto de arquivos com cada mensagem, então uma janela de contexto grande é importante.
Meu código é enviado ao Cursor quando eu uso minha própria chave?
Sim. O Cursor diz que as requisições passam pelos seus servidores para a montagem final do prompt. A Zero Data Retention não se aplica quando você usa suas próprias chaves.
Guias relacionados
- Modelos de IA gratuitos no VS Code
- Cline, Roo Code e Kilo Code com uma API gratuita
- Continue com uma API gratuita de LLM
- Melhores APIs gratuitas de modelos para código
- URLs base de APIs gratuitas compatíveis com OpenAI
Fontes
- Cursor help: API keys (verificado em 20 November 2026)
- Cursor docs: models and pricing (verificado em 20 November 2026)
- Cursor docs: privacy and data governance (verificado em 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (verificado em 20 November 2026)
- FreeLLMAPI CLI generators (verificado em 20 November 2026)