Guía de integración con Cursor: API compatible con OpenAI

URL Base y Autenticación

Cursor utiliza tu clave API para enrutar las solicitudes a nuestro punto de conexión alojado. Reemplaza la URL base estándar de OpenAI con nuestro dominio específico para habilitar la generación sin censura sin modificar el código de tu cliente. Recibes una clave activa por cuenta, la cual puedes generar al instante mediante inicio de sesión con Google o correo electrónico.

Configura tu variable de entorno o la configuración de tu IDE para apuntar a HTTPS://api.cursoropenaiapikey.com/v1. El identificador del modelo es simplemente "uncensored". Esta configuración asegura que cada solicitud omita los filtros de contenido predeterminados mientras mantiene la compatibilidad total con las integraciones existentes.

La URL base es HTTPS://api.cursoropenaiapikey.com/v1. Pasa tu clave en el encabezado Authorization como un token Bearer. Este método funciona con cualquier cliente compatible con SDK de OpenAI.

• URL Base: HTTPS://api.cursoropenaiapikey.com/v1
• ID del Modelo: uncensored
• Autenticación: token Bearer en el encabezado

Realizando tu primera solicitud

Envía una solicitud estándar de finalización de chat para verificar la conectividad y la facturación. Nuestro punto de conexión acepta la misma estructura JSON que OpenAI, garantizando compatibilidad inmediata con tus scripts existentes. La respuesta devuelve el texto generado junto con métricas de uso de tokens.

Utiliza el siguiente comando cURL para probar el endpoint. Reemplaza YOUR_API_KEY con la clave generada desde tu panel. La solicitud incluye un prompt de sistema simple para demostrar la capacidad sin censura.

Copycurl https://api.cursoropenaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the current weather in Berlin"}]
  }'

Las respuestas exitosas incluyen conteos de tokens para entrada y salida. Los errores como 401 indican una clave no válida, mientras que 402 señala crédito insuficiente. Verifica el saldo de tu cuenta si la solicitud falla.

Integración del SDK de Python

Utiliza la biblioteca oficial de Python de OpenAI con una URL base personalizada para interactuar con nuestra API. Este enfoque te permite aprovechar las bases de código existentes sin reescribir la lógica del cliente. Establece la URL base y la clave de API antes de inicializar el cliente.

Inicializa el cliente con tus credenciales y la URL base correcta. Luego llama a chat.completions.create con el ID del modelo "uncensored". El objeto de respuesta proporciona acceso al contenido generado y a las estadísticas de uso.

Copyfrom openai import OpenAI

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

Este método garantiza la compatibilidad con los flujos de trabajo estándar de Python. Puedes pasar parámetros adicionales como temperatura o secuencias de parada para controlar la generación. El SDK maneja la serialización y el análisis de respuestas automáticamente.

Integración del SDK de Node.js

Integra el paquete OpenAI de Node.js para enviar solicitudes desde tus aplicaciones JavaScript o TypeScript. Configura el cliente con nuestra URL base para habilitar la generación sin censura. Esta configuración funciona perfectamente con proyectos Node existentes.

Crea una nueva instancia del cliente de OpenAI con tu clave de API y la URL base correcta. Luego invoca el método chat.completions.create. La respuesta proporciona el texto generado y los datos de uso de tokens.

Copyimport OpenAI from "openai";

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

Esta integración admite todos los parámetros estándar. Puedes ajustar la temperatura, top_p y otros ajustes para afinar la salida. El SDK gestiona las solicitudes de red y el análisis de respuestas de manera eficiente.

Respuestas en streaming

Habilita el streaming para recibir tokens a medida que se generan. Esto reduce la latencia percibida para flujos de trabajo de codificación y aplicaciones interactivas. La API envía Server-Sent Events (SSE) con cada token.

Establece el parámetro stream a true en tu solicitud. La respuesta incluirá múltiples fragmentos. Las métricas de uso de tokens se incluyen en el último fragmento para evitar discrepancias en la facturación. Este método es ideal para interfaces de usuario en tiempo real.

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)

Maneja los eventos del flujo en el código del cliente. Agrega el contenido del token a medida que llega. El último fragmento contiene el uso total de tokens para una facturación precisa. Este enfoque garantiza una entrega de baja latencia sin sacrificar la precisión.

Límites de velocidad y ventana de contexto

Nuestra API impone límites estrictos de velocidad para garantizar un rendimiento constante. Cada clave admite 300 solicitudes por minuto y 8 solicitudes concurrentes. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Exceder estos límites devuelve un error 429.

La ventana de contexto es de 100.000 tokens para la combinación de prompt y completion. La salida máxima por solicitud es de 16.000 tokens. Si no se establece max_tokens, el valor predeterminado es de 2.048 tokens. Planifica tus prompts en consecuencia para evitar truncamientos.

• Límite de Tasa: 300 solicitudes/minuto
• Solicitudes concurrentes: 8
• Ventana de contexto: 100.000 tokens
• Salida máxima: 16,000 tokens