Início / Guias / Use o Cursor com uma API LLM gratuita

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 CursorCom sua própria chaveFonte
Chat com um modelo padrão no estilo OpenAISim. 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 TabNã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 ComposerNã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 localhostNã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.

Nota: se você quer um agente de editor gratuito sem regras de plano, use Cline, Roo Code ou Kilo Code no VS Code. Eles se conectam diretamente a 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 | bash

Copie 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-cursor

Este 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.

Segurança: uma URL pública permite que qualquer pessoa com sua chave unificada use suas cotas gratuitas. Nunca compartilhe a chave. Se seu túnel não puder enviar um cabeçalho 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

  1. Abra Cursor Settings.
  2. Abra Models.
  3. Localize o campo da chave de API da OpenAI. Cole sua chave unificada do FreeLLMAPI. Clique em Save.
  4. Ative a substituição da URL base da OpenAI. O guia do FreeLLMAPI chama esta opção de Override OpenAI Base URL.
  5. Informe seu endereço público com /v1 no final, por exemplo https://<your-tunnel-host>/v1.
  6. 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.

Importante: a substituição vale para tudo enquanto estiver ativa. Desative-a antes de voltar aos provedores integrados do Cursor.

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.

Modelos gratuitos para o chat do Cursor: tool calling e 128K+ de contexto
ModeloGratuito emContextoLimites gratuitos (melhor oferta)FerramentasVisão
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
SimNão
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
SimSim
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSimSim
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSimNão
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSimSim
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/dia
250,000 tokens/min
~3M
SimSim
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSimSim
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/dia
50 req/day account-wide (1,000 after a $10 purchase)
SimSim
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/dia
Shared rate limit
SimNão
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/dia
70,000 tokens/min
~6M
SimSim

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:fast para perguntas curtas e auto:smart para perguntas difíceis de código.
  • Comece um novo chat para cada tarefa. Um histórico menor envia menos tokens.

Solução de problemas

ProblemaCausaCorreção
O Cursor não consegue se conectar a http://localhost:3001/v1O Cursor envia as requisições dos seus servidores, não do seu computadorUse um endereço HTTPS público para o gateway
Nenhuma opção de chave própriaSeu plano do Cursor não inclui chaves de API própriasConfira 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 FreeLLMAPICopie a chave unificada de novo na página Keys
O completar com Tab não usa o gatewayO Cursor sempre usa os próprios modelos para o TabSem 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 limiteAdicione chaves de mais provedores ou aguarde as esperas
Os modelos integrados deixam de funcionarA substituição da URL base continua ativaDesative a substituição
Use todos estes modelos com uma única chave. FreeLLMAPI é um roteador de código aberto e de hospedagem própria. Ele coloca todas estas camadas gratuitas atrás de um único endpoint compatível com OpenAI e passa para o próximo provedor quando um deles está com limite de requisições. Ver o catálogo ou colocar em produçã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

Fontes

Todos os guias · Ver todos os modelos gratuitos