Guida rapida per sviluppatori

Prerequisiti: la tua chiave API

Genera la tua chiave immediatamente dopo l'accesso. Visita la pagina Ottieni chiave API e autenticati con Google o una password email. L'interfaccia visualizza la tua chiave univoca istantaneamente senza richiedere il numero di telefono. Conserva questa stringa in modo sicuro poiché autentica tutte le richieste all'URL di base. Ricevi automaticamente un credito di prova di $0,50, che scade in sette giorni se non utilizzato.

Configurazione di Cursor per la compatibilità con OpenAI

Indirizza il tuo client al nostro endpoint specifico per garantire un corretto instradamento. Imposta l'URL base su HTTPS://api.keyapicursor.com/v1 e inietta la tua chiave nell'intestazione authorization. Questa configurazione funziona con qualsiasi SDK compatibile con OpenAI senza modificare il nome del modello. Devi specificare l'identificatore del modello come uncensored per ricevere l'output open-weight.

Invio della tua prima richiesta

Esegui un semplice completamento per verificare la connettività e la latenza. Usa il comando curl riportato di seguito per inviare un prompt di base all'endpoint di completamento chat. La risposta restituisce un oggetto JSON contenente il testo generato. Controlla il campo usage per confermare che il consumo di token corrisponda alle tue aspettative.

Gestione delle risposte in streaming

Esegui lo streaming dei token per una latenza percepita inferiore nelle applicazioni interattive. Il server invia Server-Sent Events contenenti delta parziali fino a quando l'ultimo chunk non include i dati di utilizzo totali. Analizza questi eventi per aggiornare la tua interfaccia utente in tempo reale. Questo metodo funziona in modo identico sui client Python e Node.

Integrazione con SDK Python e Node

Riutilizza le codebase esistenti modificando solo i parametri di base URL e chiave. Lo snippet Python dimostra l'integrazione diretta con la libreria client ufficiale. L'esempio Node segue lo stesso pattern per gli ambienti JavaScript. Entrambi i metodi supportano la modalità JSON e il function calling out of the box.

Comprendere i limiti di velocità e i token

Monitora il volume delle tue richieste per evitare interruzioni del servizio durante un utilizzo intenso. Il sistema impone un limite di 300 richieste al minuto per chiave. Puoi eseguire otto richieste concorrenti contemporaneamente con un limite del corpo di 8 MB. Errori come 401 chiavi non valide o 402 credito insufficiente non consumano il tuo saldo prepagato.

cURL

Copycurl https://api.keyapicursor.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in function parseData"}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapicursor.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.keyapicursor.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);

Streaming

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)