PT ▾
Obter chave de API

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

Editor de código isométrico conectado por um cabo luminoso a um cubo de servidor, ilustrando um endpoint de API personalizado

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.

  1. Encontre o campo para uma chave de API do OpenAI e cole sua chave deste site.
  2. Ative a opção para substituir a URL base do OpenAI e insira https://api.cursorapikey.com/v1. Mantenha o /v1 no final e não adicione /chat/completions; o aplicativo cliente anexa o caminho sozinho.
  3. Adicione um modelo personalizado e digite uncensored exatamente, em minúsculas.
  4. 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 temperature para 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

SintomaCausa provávelCorreção
401 ou "chave inválida"Chave colada com um espaço, ou uma chave antigaCopie novamente da página da chave; teste com curl
404 ou "modelo não encontrado"Nome do modelo digitado de forma diferenteUse uncensored, minúsculas, sem sufixo
404 no caminhoURL base inclui /chat/completionsTermine a URL base em /v1
429 com concurrencyMuitas requisições de uma vezAguarde as streams terminarem; uma chave completa permite 8, uma chave de teste 2
429 com rate_limitedMais 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: 5Sobrecarga temporáriaTente 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.

01

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.