Guida rapida per gli utenti di Cursor

URL di base e autenticazione

Configura il tuo client per puntare a https://api.cursorapikey.com/v1. Il servizio prevede intestazioni di autenticazione standard OpenAI. Genera la tua chiave nella pagina Ottieni chiave API; ti servirà per ogni richiesta. Usa l'ID del modello uncensored per accedere all'unico modello disponibile. Questa configurazione funziona con qualsiasi SDK o agente compatibile con OpenAI come Cursor, Claude Code o endpoint personalizzati di GitHub Copilot.

Prima richiesta

Verifica la connettività con un semplice completamento di chat. L'endpoint supporta corpi di richiesta standard. Se ricevi un codice 200, la configurazione è corretta. Un errore 401 indica una chiave non valida o mancante, mentre un errore 402 significa che il tuo credito prepagato è esaurito.

Copycurl 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 blunt product review of a cheap VPN."}]
  }'

Le richieste superiori a 8 MB o 300 richieste al minuto possono restituire codici di errore specifici. Consulta la sezione sui limiti di richiesta per i dettagli.

Integrazione SDK Python

Usa la libreria ufficiale OpenAI per Python. Imposta l'URL di base e la chiave API nell'inizializzazione del client. L'ID del modello rimane uncensored. Questo approccio funziona per script locali o integrazioni di agenti che richiedono accesso API programmatico. Assicurati che la versione della tua libreria supporti le strutture API OpenAI richieste.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Ricorda che i prompt non vengono utilizzati per l'addestramento. Il contesto del tuo codice rimane privato alla richiesta.

Integrazione SDK Node

Inizializza il client OpenAI Node.js con l'URL di base personalizzato. Passa la chiave API dalle variabili di ambiente. L'ID del modello uncensored è richiesto per tutti i completamenti. Questa configurazione è ideale per agenti basati su Node o funzioni serverless che richiedono assistenza AI costante.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.cursorapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

Verifica le tue credenziali prima di effettuare richieste in blocco per evitare errori 402 non necessari.

Risposte in streaming

Abilita lo streaming impostando stream: true nel corpo della richiesta. L'API restituisce Server-Sent Events (SSE). Questo permette alla tua UI o agente di elaborare i token man mano che vengono generati. Lo streaming riduce la latenza percepita per le risposte di grandi dimensioni. Assicurati che il tuo client gestisca correttamente i chunk parziali.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Ogni frammento contiene contenuto parziale. Aggrega questi frammenti per formare la risposta finale.

Limiti, errori e contesto

La finestra di contesto è di 100.000 token per prompt e completamento combinati. I limiti di richiesta sono 300 richieste al minuto per chiave. Se rigeneri la chiave, quella vecchia viene revocata immediatamente. Un errore 401 indica una chiave non valida. Un errore 402 indica credito insufficiente. Un errore 429 indica superamento del limite di richieste. Il credito non scade mai. Le opzioni di ricarica includono criptovalute (USDT o USDC).