cursorapikey.com/Guia
Como usar chaves de API do Cursor com um endpoint personalizado
Veja como usar as configurações de API do Cursor com seu próprio endpoint: cole uma chave, substitua a URL base do OpenAI e adicione o nome do modelo uncensored. Os passos abaixo levam cerca de cinco minutos e incluem uma verificação com curl que você pode executar primeiro.
Atualizado

Pontos principais
- O Cursor permite que você substitua a URL base e a chave do OpenAI, para que qualquer endpoint compatível com OpenAI possa servir as requisições.
- Use a URL base https://api.cursorapikey.com/v1 e o ID do modelo
uncensored. - Teste a chave com curl antes de mexer no editor, para saber de qual lado vem a falha.
- Um prompt de 20.000 tokens com uma resposta de 1.000 tokens custa $0,0035.
O que este guia cobre
Pessoas que buscam como usar a API do Cursor geralmente querem uma de duas coisas. Ou querem chamar algum serviço do Cursor a partir do código, ou querem que o editor Cursor envie suas requisições de modelo para um endpoint que eles escolham. Este guia trata do segundo caso. Este site é uma API hospedada independente que fala o protocolo de conclusão de chat do OpenAI, então o Cursor pode falar com ele da mesma forma que fala com qualquer servidor estilo OpenAI.
O modelo por trás disso é um único modelo de pesos abertos, executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto lícito. Não é um modelo oficial do Cursor, nem um roteador entre fornecedores. Ele lida apenas com texto. Para programação, isso geralmente é suficiente: você envia código e instruções, recebe código e explicações de volta.
Você precisa de três coisas: uma chave de API, a URL base https://api.cursorapikey.com/v1 e o ID do modelo uncensored. O resto é questão de encontrar os campos certos no editor.
Passo 1: obter uma chave e verificar com curl
Faça login com Google ou com e-mail e senha, depois acesse a página da chave de API. Contas novas podem solicitar $0,50 de crédito de teste com um clique. Não precisa de cartão e é válido por 7 dias. A chave de teste é limitada a 2 requisições simultâneas e 60 requisições por minuto, o que é suficiente para uma primeira sessão no editor.
Antes de abrir o Cursor, confirme se a chave funciona. Execute isto em um terminal, com sua chave em uma variável de ambiente:
export API_KEY="paste-your-key-here"
curl https://api.cursorapikey.com/v1/models \
-H "Authorization: Bearer $API_KEY"
curl https://api.cursorapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Write a Python function that reverses a linked list."}
]
}'
A primeira chamada lista o modelo. A segunda retorna uma conclusão de chat normal. Se ambas tiverem sucesso, qualquer falha posterior no editor é um problema de configuração e não de chave. Essa separação economiza muitas suposições.
Passo 2: definir a URL base e a chave no Cursor
Abra as configurações do Cursor e vá para a seção de modelos. Os nomes do menu e o layout mudam entre versões, então trate os rótulos abaixo como um mapa e verifique a própria documentação do Cursor se algo mudou.
- Encontre o campo para uma chave de API do OpenAI e cole sua chave deste site.
- Ative a opção para substituir a URL base do OpenAI e insira
https://api.cursorapikey.com/v1. Mantenha o/v1no final e não adicione/chat/completions; o aplicativo cliente anexa o caminho sozinho. - Adicione um modelo personalizado e digite
uncensoredexatamente, em minúsculas. - Use o botão de verificar ou salvar se o editor oferecer, então selecione o novo modelo no painel de chat.
Envie uma mensagem curta como "explique esta função" com um arquivo aberto. Uma resposta em streaming significa que a rota funciona de ponta a ponta. O Cursor envia a requisição, o endpoint transmite tokens de volta via SSE e o editor os renderiza conforme chegam.
Duas precauções. Alguns recursos do editor, como autocompletar inline com Tab, podem ser executados em modelos controlados pelo Cursor e podem ignorar sua chave, então verifique quais recursos realmente usam o modelo personalizado. E como o Cursor pode rotear o tráfego de chave personalizada através de seus próprios servidores, leia sua documentação atual se precisar saber exatamente onde seu código viaja. O quickstart neste site lista o lado da API do contrato.
Teste o mesmo endpoint a partir do código
A maneira mais fácil de isolar um problema é chamar o endpoint com o SDK oficial do OpenAI. Se isso funcionar, o endpoint está OK e qualquer problema restante está na configuração do editor.
from openai import OpenAI
client = OpenAI(
api_key="paste-your-key-here",
base_url="https://api.cursorapikey.com/v1",
)
stream = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a terse senior engineer."},
{"role": "user", "content": "Refactor this loop into a list comprehension: out = []\nfor x in xs:\n if x > 0:\n out.append(x * 2)"},
],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
A mesma coisa em Node:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.API_KEY,
baseURL: "https://api.cursorapikey.com/v1",
});
const res = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a regex that matches ISO 8601 dates." }],
});
console.log(res.choices[0].message.content);
As respostas em streaming incluem o uso no final, então você pode registrar exatamente quantos tokens uma requisição usou. Cada resposta também carrega um cabeçalho X-Balance-USD com seu crédito restante e um X-Request-Id que você pode citar se algo parecer errado.
O que funciona em um fluxo de trabalho de programação
A API suporta streaming, modo JSON e chamada de funções (tools, tool_choice, tool_calls em streaming e resultados enviados de volta como role: "tool"). Configurações de amostragem como temperature, top_p, stop, seed e as penalidades são passadas. A janela de contexto é de 100.000 tokens, compartilhada entre o prompt e a conclusão, e max_tokens é opcional.
Esses 100.000 tokens são um orçamento generoso para código. Um arquivo-fonte de algumas centenas de linhas tem alguns milhares de tokens, então você pode incluir vários arquivos além de uma instrução longa e ainda deixar espaço para a resposta. O corpo máximo da requisição é 8 MB, o que você não atingirá com texto.
Alguns hábitos que tornam um modelo personalizado agradável em um editor:
- Mantenha um valor baixo de
temperaturepara edições de código. Valores em torno de 0,2 dão saída mais estável; aumente apenas para brainstorming. - Anexe apenas os arquivos que importam. Cada token que você envia é cobrado como entrada e toda a conversa é reenviada em cada turno.
- Peça diffs ou a função alterada, não o arquivo inteiro, quando o arquivo for longo. Tokens de saída custam mais que tokens de entrada.
- Use o modelo para tarefas onde recusas atrapalham, como escrever provas de conceito de exploração para seu próprio laboratório, analisar amostras de malware que você está autorizado a estudar ou gerar dados de teste que imitam conteúdo real desagradável. Tudo deve ser lícito.
A única limitação rígida que vale a pena repetir: sem conteúdo sexual envolvendo menores de idade, sob qualquer enquadramento.
Corrigindo os erros comuns
| Sintoma | Causa provável | Correção |
|---|---|---|
| 401 ou "chave inválida" | Chave colada com um espaço, ou uma chave antiga | Copie novamente da página da chave; teste com curl |
| 404 ou "modelo não encontrado" | Nome do modelo digitado de forma diferente | Use uncensored, minúsculas, sem sufixo |
| 404 no caminho | URL base inclui /chat/completions | Termine a URL base em /v1 |
429 com concurrency | Muitas requisições de uma vez | Aguarde as streams terminarem; uma chave completa permite 8, uma chave de teste 2 |
429 com rate_limited | Mais de 300 requisições por minuto (60 na versão trial) | Diminua o ritmo ou tente novamente após uma pausa |
429 com Retry-After: 5 | Sobrecarga temporária | Tente novamente após cinco segundos |
Uma requisição em streaming mantém seu slot de concorrência até que a stream termine. Se você iniciar vários chats no Cursor e deixá-los gerando, você pode atingir o limite de concorrência em uma chave de teste rapidamente. Requisições falhas ou recusadas não são cobradas, então tentar novamente não custa nada extra.
Quanto custa uma sessão de programação
A precificação é $0,15 por 1M tokens de entrada e $0,50 por 1M tokens de saída, pagos com crédito pré-pago sem assinatura. Uma requisição típica do editor tem um prompt grande (seus arquivos) e uma resposta curta. Considere 20.000 tokens de entrada e 1.000 tokens de saída:
- Entrada: 20.000 x $0,15 / 1.000.000 = $0,0030
- Saída: 1.000 x $0,50 / 1.000.000 = $0,0005
- Total: $0,0035 por requisição
A 100 requisições em um dia útil, isso custa $0,35. O crédito de teste de $0,50 cobre aproximadamente 140 dessas requisições. Após o período de teste, você pode recarregar qualquer valor inteiro de $20 a $500, com bônus de +5% a partir de $50, +10% a partir de $100 e +15% a partir de $200. Pague com cripto (USDT na TRC20, USDC na Base). O crédito nunca expira, então um recarregamento usado com calma não é desperdiçado. A página de preços tem a tabela completa, e a página sobre a alternativa ao Cursor e Copilot explica onde isso se encaixa ao lado de editores por assinatura.
Os prompts não são usados para treinamento.
Mais guias
Perguntas e respostas
Isso funciona com o agente do Cursor e a chamada de funções?
A API suporta chamada de funções com ferramentas, tool_choice e tool_calls em streaming. Se uma funcionalidade específica do Cursor usa seu modelo personalizado depende do editor, então teste cada recurso após a configuração.
Qual nome de modelo eu insiro?
Insira uncensored, em letras minúsculas. É o único ID de modelo, e GET /v1/models o lista.
Esta é a API oficial do Cursor?
Não. É uma API independente compatível com OpenAI por trás de um único modelo de pesos abertos. O Cursor simplesmente permite que você aponte as configurações do OpenAI para um endpoint diferente.
Preciso de cartão para testar?
Não. O crédito de teste de $0,50 é resgatado com um clique na página da chave de API após o cadastro, não precisa de cartão e é válido por 7 dias.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.