IT ▾
Ottieni la chiave API

cursorapikey.com/Guida

Come usare le chiavi API di Cursor con un endpoint personalizzato

Ecco come usare le impostazioni API di Cursor con il tuo endpoint: incolla una chiave, sovrascrivi l'URL base di OpenAI e aggiungi il nome del modello uncensored. I passaggi seguenti richiedono circa cinque minuti e includono un controllo con curl che puoi eseguire prima.

Aggiornato

Editor di codice isometrico collegato con un cavo luminoso a un cubo server, che illustra un endpoint API personalizzato

Punti chiave

  • Cursor ti permette di sovrascrivere l'URL base e la chiave di OpenAI, così qualsiasi endpoint compatibile con OpenAI può servire le richieste.
  • Usa l'URL base https://api.cursorapikey.com/v1 e il model ID uncensored.
  • Testa la chiave con curl prima di toccare l'editor, così sai da che parte proviene un eventuale errore.
  • Un prompt da 20.000 token con una risposta da 1.000 token costa $0,0035.

Cosa copre questa guida

Le persone che cercano come usare l'API di Cursor intendono solitamente una di due cose. O vogliono chiamare un servizio di Cursor dal codice, o vogliono che l'editor Cursor invii le richieste del modello a un endpoint a loro scelta. Questa guida riguarda il secondo caso. Questo sito è un'API ospitata indipendente che parla il protocollo di completamento chat di OpenAI, quindi Cursor può parlargli allo stesso modo in cui parla a qualsiasi server in stile OpenAI.

Il modello alla base è un singolo modello a pesi aperti, gestito da un provider indipendente e ottimizzato per rispondere senza rifiuti di contenuto per uso adulto lecito. Non è un modello ufficiale di Cursor e non è un router tra fornitori. Gestisce solo testo. Per la programmazione di solito è sufficiente: invii codice e istruzioni, ricevi codice e spiegazioni.

Ti servono tre cose: una chiave API, l'URL base https://api.cursorapikey.com/v1 e il model ID uncensored. Tutto il resto è questione di trovare i campi giusti nell'editor.

Passaggio 1: ottieni una chiave e verificane il funzionamento con curl

Registrati con Google o con email e password, poi apri la pagina delle chiavi API. I nuovi account possono richiedere $0,50 di credito di prova con un solo clic. Non serve una carta e rimane valido per 7 giorni. La chiave di prova è limitata a 2 richieste parallele e 60 richieste al minuto, il che è sufficiente per una prima sessione nell'editor.

Prima di aprire Cursor, conferma che la chiave funzioni. Esegui questo comando in un terminale, con la tua chiave in una variabile d'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."}
    ]
  }'

La prima chiamata elenca il modello. La seconda restituisce un completamento chat normale. Se entrambe hanno successo, qualsiasi errore successivo nell'editor è un problema di impostazioni e non di chiave. Questa separazione fa risparmiare molte supposizioni.

Passaggio 2: imposta l'URL base e la chiave in Cursor

Apri le impostazioni di Cursor e vai alla sezione modelli. I nomi dei menu e il layout cambiano tra le release, quindi tratta le etichette seguenti come una mappa e controlla la documentazione ufficiale di Cursor se qualcosa è cambiato.

  1. Trova il campo per una chiave API OpenAI e incolla la tua chiave presa da questo sito.
  2. Abilita l'opzione per sovrascrivere l'URL base di OpenAI e inserisci https://api.cursorapikey.com/v1. Mantieni /v1 alla fine e non aggiungere /chat/completions; il client aggiunge il percorso da solo.
  3. Aggiungi un modello personalizzato e digita uncensored esattamente, tutto in minuscolo.
  4. Usa il pulsante di verifica o salva se l'editor lo offre, poi seleziona il nuovo modello nel pannello chat.

Invia un messaggio breve come "spiega questa funzione" con un file aperto. Una risposta in streaming significa che il percorso funziona da capo a fondo. Cursor invia la richiesta, l'endpoint trasmette i token indietro tramite SSE e l'editor li renderizza man mano che arrivano.

Due avvertenze. Alcune funzionalità dell'editor, come il completamento inline, possono essere eseguite su modelli controllati da Cursor e potrebbero ignorare la tua chiave, quindi verifica quali funzionalità utilizzano effettivamente il modello personalizzato. E poiché Cursor potrebbe instradare il traffico con chiave personalizzata attraverso i propri server, leggi la sua documentazione attuale se devi sapere esattamente dove viaggia il tuo codice. La guida rapida su questo sito elenca il lato API del contratto.

Testa lo stesso endpoint dal codice

Il modo più semplice per isolare un problema è chiamare l'endpoint con l'SDK ufficiale di OpenAI. Se funziona, l'endpoint è a posto e qualsiasi problema rimanente risiede nella configurazione dell'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="")

La stessa cosa in 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);

Le risposte in streaming includono l'utilizzo alla fine, così puoi registrare esattamente quanti token ha utilizzato una richiesta. Ogni risposta include anche un'intestazione X-Balance-USD con il tuo credito residuo e un X-Request-Id che puoi citare se qualcosa sembra sbagliato.

Cosa funziona in un flusso di lavoro di programmazione

L'API supporta lo streaming, la modalità JSON e la chiamata di funzioni (tools, tool_choice, tool_calls in streaming e risultati inviati come role: "tool"). Le impostazioni di campionamento come temperature, top_p, stop, seed e le penalità vengono trasmesse. La finestra di contesto è di 100.000 token, condivisa tra il prompt e il completamento, e max_tokens è opzionale.

Quei 100.000 token sono un budget generoso per il codice. Un file sorgente di poche centinaia di righe è qualche migliaio di token, quindi puoi includere diversi file più una lunga istruzione e lasciare comunque spazio per la risposta. Il corpo della richiesta massimo è 8 MB, che non raggiungerai con il testo.

Alcune abitudini che rendono piacevole un modello personalizzato in un editor:

  • Mantieni una temperature bassa per le modifiche al codice. Valori intorno a 0,2 danno output più stabili; aumentala solo per il brainstorming.
  • Allega solo i file che contano. Ogni token che invii viene fatturato come input e l'intera conversazione viene rispedita ad ogni turno.
  • Chiedi i diff o la funzione modificata, non l'intero file, quando il file è lungo. I token di output costano più dei token di input.
  • Usa il modello per attività in cui i rifiuti si mettono in mezzo, come scrivere proof-of-concept di exploit per il tuo laboratorio, analizzare campioni di malware che sei autorizzato a studiare o generare dati di test che imitano contenuti reali sgradevoli. Tutto deve essere lecito.

L'unico limite rigido da ripetere: nessun contenuto sessuale che coinvolga minorenni, sotto nessuna forma.

Risoluzione degli errori comuni

SintomoCausa probabileSoluzione
401 o "chiave non valida"Chiave incollata con uno spazio, o una chiave vecchiaRicopia dalla pagina della chiave; testa con curl
404 o "modello non trovato"Nome del modello digitato in modo diversoUsa uncensored, tutto in minuscolo, senza suffisso
404 sul percorsoL'URL base include /chat/completionsTermina l'URL base con /v1
429 con concurrencyTroppe richieste contemporaneamenteAttendi che gli stream terminino; una chiave completa consente 8, una chiave di prova 2
429 con rate_limitedPiù di 300 richieste al minuto (60 in prova)Rallenta o riprova dopo una pausa
429 con Retry-After: 5Sovraccarico temporaneoRiprova dopo cinque secondi

Una richiesta in streaming mantiene il suo slot di concorrenza fino alla fine dello stream. Se avvii diverse chat in Cursor e le lasci generare, puoi raggiungere rapidamente il limite di concorrenza con una chiave di prova. Le richieste fallite o rifiutate non vengono addebitate, quindi riprovare non costa nulla in più.

Quanto costa una sessione di programmazione

I prezzi sono $0,15 per 1M di token di input e $0,50 per 1M di token di output, pagati dal credito prepagato senza abbonamento. Una tipica richiesta dell'editor ha un grande prompt (i tuoi file) e una risposta breve. Prendi 20.000 token di input e 1.000 token di output:

  • Input: 20.000 x $0,15 / 1.000.000 = $0,0030
  • Output: 1.000 x $0,50 / 1.000.000 = $0,0005
  • Totale: $0,0035 per richiesta

A 100 richieste in una giornata lavorativa il costo è di $0,35. Il credito di prova da $0,50 copre circa 140 di queste richieste. Dopo la prova puoi ricaricare qualsiasi importo intero da $20 a $500, con un bonus del +5% da $50, +10% da $100 e +15% da $200. Paga con cripto (USDT su TRC20, USDC su Base). Il credito non scade mai, quindi una ricarica usata lentamente non va sprecata. La pagina prezzi contiene la tabella completa, e la pagina sull'alternativa a Cursor e Copilot spiega dove questo si inserisce rispetto agli editor in abbonamento.

I prompt non vengono usati per l'addestramento.

01

Domande e risposte

Funziona con l'agente Cursor e la chiamata di funzioni?

L'API supporta la chiamata di funzioni con tools, tool_choice e tool_calls in streaming. Se una determinata funzionalità di Cursor utilizza il tuo modello personalizzato dipende dall'editor, quindi testa ogni funzionalità dopo la configurazione.

Quale nome del modello devo inserire?

Inserisci uncensored, tutto in minuscolo. È l'unico ID del modello e GET /v1/models lo elenca.

È questa l'API ufficiale di Cursor?

No. È un'API indipendente compatibile con OpenAI davanti a un singolo modello a pesi aperti. Cursor si limita a consentirti di puntare le sue impostazioni OpenAI a un endpoint diverso.

Ho bisogno di una carta per provarlo?

No. Il credito di prova da $0,50 si richiede con un clic nella pagina della chiave API dopo l'accesso, non richiede una carta ed è valido per 7 giorni.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica l'URL base. È tutta la configurazione.