Cursor

Use o Override OpenAI Base URL do Cursor para rodar modelos GPT do catálogo da OneProvider no Ask e no Agent.

Cursor, editor de código com IA

O que funciona

As requisições do Ask e do Agent para os IDs de modelo GPT que você adicionar passam pela OneProvider, inclusive as requisições ApplyPatch em streaming. O Cursor envia essas requisições dos próprios servidores, então só o endpoint público funciona; o Cursor continua controlando o runtime do agente e os recursos hospedados especializados.

Limitação do cliente

Exige um plano pago do Cursor (Pro ou superior): desde janeiro de 2026 o Cursor ignora as suas próprias chaves no plano Free. O override é global — enquanto ele estiver ligado, todo modelo, exceto os da Anthropic e do Google (inclusive os modelos GPT, Composer e Grok do próprio Cursor), é enviado para a OneProvider; por isso, desligue-o para voltar a usar os modelos do Cursor. Os IDs nativos da Anthropic/Claude e do Google nunca usam o override, e o autocompletar com Tab e os recursos hospedados pelo Cursor mantêm o roteamento normal.

Configuração

1. Atualize o Cursor e prepare uma chave dedicada

   Use a versão estável mais recente do Cursor, em um plano Pro ou superior. Crie uma chave dedicada da OneProvider, limite os modelos e os gastos dela e recarregue o saldo antes de verificar.

2. Ative a OpenAI API Key

   Abra Cursor Settings → Models → API Keys (Configurações do Cursor → Modelos → Chaves de API), cole a chave dedicada da OneProvider em OpenAI API Key e ligue o interruptor dela — colar só a chave não ativa.

   OpenAI API Key: sk-your-key-here

3. Substitua a base URL da OpenAI

   Ligue o Override OpenAI Base URL (Substituir a base URL da OpenAI) e informe exatamente https://api.oneprovider.dev/v1 — com /v1 e sem /chat/completions; o Cursor acrescenta o caminho sozinho. O Cursor exige um ID de modelo OpenAI compatível; escolha no catálogo de modelos o ID de um modelo de texto GPT (um modelo de imagem não funciona no chat).

   Override OpenAI Base URL: https://api.oneprovider.dev/v1

4. Salve e selecione um modelo compatível

   Salve a chave da OpenAI e a base URL. Adicione o ID de modelo compatível que você escolheu como modelo personalizado, se ele não estiver na lista, e faça uma nova requisição no Ask ou no Agent. IDs de modelo Claude e Google não passam por este override. Desative o override quando quiser voltar ao roteamento OpenAI normal do Cursor.

Verificar a conexão

Confirme a requisição no seu Dashboard

A requisição deve mostrar gpt-6.1-terra, o endpoint compatível com a OpenAI, o consumo de tokens e o valor debitado. Se o Cursor mostrar um erro:

"does not work with your current plan or api key" → plano Free, ou o interruptor da OpenAI API Key está desligado
"Model name is not valid" → ligue o interruptor da OpenAI API Key e inicie um novo chat
404 / "Invalid URL" → a base URL deve ser exatamente https://api.oneprovider.dev/v1
401 → chave da OneProvider errada, revogada ou sem saldo
"model … is not available" → o ID do modelo não está no catálogo da OneProvider
Os modelos do próprio Cursor falham → desligue o Override OpenAI Base URL enquanto os usa

Dados da conexão

Protocolo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Segurança da chave

O Cursor monta as requisições pelo próprio serviço, então não restrinja a chave ao IP da sua estação de trabalho. Prefira uma chave dedicada com controles de modelo, de requisições, de gastos, de validade e de escopo.

Qual modelo escolher

O override só carrega IDs de modelo no estilo OpenAI, então escolha um modelo de texto GPT. gpt-6.1-terra é o padrão equilibrado para Ask e Agent. gpt-6.1-sol é o nível de ponta para tarefas difíceis com vários arquivos, e gpt-5.6-luna é o nível de baixo custo para perguntas rápidas. Adicione o ID que você escolheu como modelo personalizado, exatamente como está no catálogo . IDs Claude nunca passam por este override: para usar o Claude, rode o Claude Code ao lado do Cursor.

Erros comuns e soluções

“Model name is not valid”

O interruptor da OpenAI API Key está desligado ou o modelo foi adicionado antes de ligá-lo. Ligue o interruptor, salve e inicie um novo chat.

“Does not work with your current plan or api key”

Você está no plano Free ou o interruptor está desligado. No Free, o Cursor ignora as suas próprias chaves; é preciso Pro ou superior.

404 ou “Invalid URL”

Informe exatamente https://api.oneprovider.dev/v1: com /v1 e sem /chat/completions. O Cursor acrescenta o caminho.

401

A chave está errada, foi revogada ou o saldo está zerado. Cole a chave inteira, sem espaços, e recarregue o saldo do painel.

Os modelos do próprio Cursor falham com o override ligado

O override é global: todo modelo que não seja da Anthropic nem do Google vai para a OneProvider. Desligue o Override OpenAI Base URL para voltar a usar os modelos do Cursor.

As requisições não aparecem no meu Dashboard

O modelo usado é um Claude ou um do Google, ou o override está desligado. Escolha o ID GPT que você adicionou e faça uma nova requisição no Ask ou no Agent.

Perguntas frequentes

O autocompletar com Tab é afetado?

Não. O Tab e os recursos hospedados pelo Cursor mantêm o roteamento normal.

Posso restringir a chave ao meu IP?

Não. O Cursor envia as requisições dos próprios servidores, então uma lista de IPs permitidos as bloquearia. Use limites de modelo, de requisições e de gastos.

Posso usar modelos Claude no Cursor pela OneProvider?

Não por este override. Para o Claude, use o Claude Code ou o Cline .

Como volto ao normal?

Desligue o Override OpenAI Base URL. As suas outras configurações continuam.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .