Guía de inicio rápido para desarrolladores

Prerrequisitos: tu clave API

Genera tu clave inmediatamente después de iniciar sesión. Visita la página Obtener clave de API y autentícate con Google o una contraseña de correo electrónico. La interfaz muestra tu clave única al instante sin necesidad de número de teléfono. Mantén esta cadena segura porque autentica todas las solicitudes a la URL base. Recibes automáticamente $0.50 de crédito de prueba, que expira en siete días si no se usa.

Configurando Cursor para compatibilidad con OpenAI

Apunta tu cliente a nuestro punto de conexión específico para asegurar el enrutamiento correcto. Establece la URL base en HTTPS://api.keyapicursor.com/v1 e inyecta tu clave en el encabezado de autorización. Esta configuración funciona con cualquier SDK compatible con OpenAI sin modificar el nombre del modelo. Debes especificar el identificador del modelo como uncensored para recibir la salida de peso abierto.

Enviar tu primera solicitud

Ejecuta una finalización básica para verificar la conectividad y la latencia. Usa el comando curl a continuación para enviar un prompt básico al endpoint de finalizaciones de chat. La respuesta devuelve un objeto JSON que contiene el texto generado. Verifica el campo de uso para confirmar que el consumo de tokens coincide con tus expectativas.

Gestión de respuestas en streaming

Transmite tokens para una menor latencia percibida en aplicaciones interactivas. El servidor envía Eventos Enviados por Servidor que contienen deltas parciales hasta que el último fragmento incluye los datos de uso total. Analiza estos eventos para actualizar tu interfaz de usuario en tiempo real. Este método funciona de manera idéntica en clientes de Python y Node.

Integración con SDK de Python y Node

Reutiliza bases de código existentes ajustando únicamente los parámetros de URL base y clave. El fragmento de Python demuestra la integración directa con la biblioteca oficial de clientes. El ejemplo de Node sigue el mismo patrón para entornos JavaScript. Ambos métodos soportan el modo JSON y la llamada a funciones de serie.

Comprender los límites de velocidad y los tokens

Monitora el volumen de tus solicitudes para evitar interrupciones del servicio durante un uso intensivo. El sistema aplica un límite de 300 solicitudes por minuto por clave. Puedes ejecutar ocho solicitudes concurrentes simultáneamente con un límite de cuerpo de 8 MB. Errores como 401 claves inválidas o 402 crédito insuficiente no consumen tu saldo prepagado.

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);

Transmisión

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)