Chave de API do Cursor AI: Onde Colocar uma Chave Personalizada

A resposta curta

Editores da família Cursor precisam de três valores para falar com um provedor personalizado: uma URL base, uma chave de API e um nome de modelo. Para este serviço eles são:

• URL base: https://api.cursoraiapikey.com/v1
• Chave de API: a chave da página da chave de API
• Nome do modelo: uncensored

Abra as configurações do editor e encontre a seção de modelos. O Cursor oferece um campo para uma chave de API OpenAI e uma opção para substituir a URL base OpenAI, mas os rótulos do menu mudam entre versões, então pesquise nas configurações por "URL base" se não os encontrar. Cole a URL e a chave, adicione um modelo personalizado chamado uncensored, então use o botão de verificação se sua versão tiver um.

Este serviço é independente do Cursor. É uma API hospedada separada e não substitui a conta ou plano próprios do editor. Você está apenas apontando o chat do editor para um servidor compatível com OpenAI diferente.

Dois tipos de chaves, dois lugares diferentes

As pessoas usam a mesma palavra para duas coisas não relacionadas, e confundi-las é a razão mais comum de uma configuração falhar.

O login da conta

O editor tem seu próprio login. Isso o identifica ao fornecedor do editor e não tem nada a ver com um provedor de modelo. Você não cola uma chave de provedor na tela de login.

A chave do provedor

Esta é uma string secreta emitida por uma empresa que executa um modelo. Você cola nas configurações de modelo junto com uma URL base, e o editor envia um cabeçalho Authorization: Bearer com cada requisição. Uma chave deste serviço funciona apenas contra a URL base deste serviço, e uma chave de outro provedor não funcionará aqui.

Se você chegou aqui procurando uma maneira de obter a chave própria do editor de graça, esta não é. Se você quer um modelo de texto barato atrás do painel de chat do editor, continue lendo. O mesmo padrão funciona para qualquer editor que aceite um endpoint compatível com OpenAI, e o artigo sobre substituir uma chave Claude cobre o caso paralelo para configurações estilo Anthropic.

Teste o endpoint antes de tocar no editor

Um teste de dois minutos fora do editor mostra se o problema é a chave ou o editor. Crie uma conta, solicite o crédito de teste grátis na página da chave e execute isto:

Copycurl https://api.cursoraiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the word ok."}]
  }'

Você deve receber um corpo JSON com uma matriz choices. Os cabeçalhos de resposta incluem X-Balance-USD, que mostra o que resta no seu crédito. A mesma chamada em Python com o SDK oficial:

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.cursoraiapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the word ok."}],
)
print(reply.choices[0].message.content)

Se ambas as chamadas funcionarem, a chave está boa e qualquer erro posterior vem das configurações do editor.

Passo a passo no editor

1. Entre com Google ou com e-mail e senha, depois solicite o crédito de teste grátis de $0,50 na página chave de API. Não precisa de cartão e é válido por 7 dias.
2. Copie a chave. Trate como uma senha.
3. No editor, abra Configurações e vá para a seção Modelos. Os nomes diferem entre versões, então trate os rótulos nesta lista como um guia.
4. Cole a chave no campo da chave de API da OpenAI.
5. Ative a opção para substituir a URL base OpenAI e insira https://api.cursoraiapikey.com/v1. Mantenha o /v1 e não adicione /chat/completions; o cliente adiciona o resto.
6. Adicione um modelo personalizado com o nome exato uncensored.
7. Selecione esse modelo no painel de chat e envie uma mensagem curta.

Se sua versão empurra uma etapa de verificação e falha enquanto curl funciona, verifique se você não deixou um espaço final na chave e se a URL base não tem um segundo /v1 no final.

O que usará e não usará sua chave

Definir um endpoint personalizado não altera necessariamente todos os recursos. Editores frequentemente executam alguns recursos, como conclusão inline ou aplicação de diff, em modelos que o fornecedor hospeda diretamente, e esses podem ignorar sua chave. Requisições estilo chat e agente são as enviadas para o endpoint que você configura. A documentação do editor é a autoridade para sua versão, então verifique-a antes de planejar em torno de um recurso específico.

Mais duas coisas que valem a pena verificar:

• Caminho da requisição. Dependendo da versão, as requisições podem passar por servidores executados pelo fornecedor do editor antes de alcançar seu endpoint. Se sim, uma URL base no seu próprio computador não funcionará, enquanto uma URL pública como esta sim. Leia as notas de privacidade do editor para ver o que ele armazena.
• Escopo do modelo. Este serviço executa um modelo de pesos abertos, ajustado para responder sem recusas de conteúdo para uso adulto lícito. É apenas texto. Não gera imagens, áudio ou embeddings, então recursos que precisam disso não funcionarão através dele.

A janela de contexto é de 100.000 tokens para prompt mais resposta, o que é suficiente para a maioria do trabalho com arquivo único e para muitas tarefas multi-arquivo. Dump de repositório muito grande não caberá.

Corrigindo erros comuns

Sintoma	Causa provável	Correção
401 não autorizado	Chave errada ou revogada, espaço extra, chave colada no campo errado	Regenerar a chave na página de chaves e cole-a novamente. A chave antiga para de funcionar imediatamente.
404 não encontrado	URL base faltando /v1, ou /v1/v1 duplicado	Use exatamente https://api.cursoraiapikey.com/v1.
Modelo não encontrado	Nome do modelo personalizado digitado diferente	O nome é uncensored, tudo minúsculo.
429 com concurrency	Muitas requisições de uma vez; chaves de teste permitem 2	Aguarde as requisições em execução terminarem ou passe para uma chave completa, que permite 8.
429 com rate_limited	Acima do limite por minuto; 60 no teste, 300 em uma chave completa	Reduza a velocidade; loops de agentes podem gerar picos.
429 com Retry-After: 5	Sobrecarga temporária	Tente novamente após cinco segundos.

Os modos de agente podem disparar várias requisições simultaneamente, e uma resposta em streaming mantém o slot até o fim do streaming. Em uma chave de teste, isso faz com que o limite de concorrência seja atingido facilmente. Isso é normal, não é um defeito da chave.

Quanto custa uma requisição

A cobrança é pagamento por uso a $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, descontados do crédito pré-pago. Requisições falhas ou recusadas não são cobradas. Uma interação típica de chat em um editor envia o arquivo aberto e algum histórico, digamos 20.000 tokens de entrada, e recebe 1.500 tokens de saída:

• Entrada: 20.000 x $0,15 / 1.000.000 = $0,0030
• Saída: 1.500 x $0,50 / 1.000.000 = $0,00075
• Total: $0,00375, um pouco menos de meio centavo

O crédito de teste de $0,50, portanto, cobre cerca de 133 interações desse tamanho. Isso é suficiente para uma tarde de testes reais. Quando você decidir continuar, os recarregamentos variam de $20 a $500 em valores inteiros, com um bônus de 5% a partir de $50, 10% a partir de $100 e 15% a partir de $200, pagos em cripto (USDT na TRC20 ou USDC na Base). O crédito nunca expira. A página de preços tem a tabela completa e a documentação lista todos os parâmetros suportados.

Mais guias

• Preços do Cursor AI vs API: Assinatura ou por Token
• Alternativa à Chave de API do Claude para Uso Sem Censura