Cómo usar la clave de API de GitHub Copilot con la API de Cursor

Comprensión de la compatibilidad de claves de API

Cuando los desarrolladores se refieren a una github copilot api key, generalmente se refieren a un token generado dentro del ecosistema de Microsoft GitHub. Esta clave autentica las peticiones a los servidores de Microsoft, que ejecutan modelos como GPT-4o o variantes especializadas optimizadas para código. Aunque estos modelos son potentes, vienen con filtros de contenido específicos y límites de peticiones vinculados a tu cuenta de Microsoft.

En contraste, la API de Cursor opera como un servicio independiente. No depende de la infraestructura de Microsoft. En su lugar, sirve un único modelo de lenguaje grande de pesos abiertos optimizado para contextos de codificación. Este modelo está diseñado para responder sin rechazos de contenido para uso adulto lícito, lo que lo convierte en una alternativa distinta para desarrolladores que encuentran restrictivos los filtros estándar.

Entender esta distinción es crucial. Tu clave de API de GitHub Copilot existente no funcionará con el endpoint de la API de Cursor. Necesitas una clave separada generada desde tu cuenta en cursorapikey.com. Sin embargo, el protocolo subyacente sigue siendo el mismo, lo que significa que tu código no necesita cambiar significativamente.

Configuración de tu entorno

Para usar la API de Cursor, primero necesitas generar una clave. Regístrate en la página Get API key con solo un correo electrónico y una contraseña. No se necesita tarjeta de crédito para el crédito de prueba inicial. Una vez registrado, tu clave se muestra inmediatamente. Guarda esta clave de forma segura en tus variables de entorno, típicamente como OPENAI_API_KEY o una variable personalizada según los requisitos de tu agente.

La mayoría de los agentes de codificación, incluido Cursor y herramientas similares, dependen del estándar del SDK de OpenAI. Esto significa que no necesitas una biblioteca personalizada. Simplemente necesitas apuntar tu SDK a la URL base correcta. La URL base para la API de Cursor es https://api.cursorapikey.com/v1. Este endpoint es totalmente compatible con OpenAI, admitiendo las mismas estructuras de petición que ya conoces.

Asegúrate de que tu entorno esté configurado para enviar peticiones a esta nueva URL base. El ID de modelo que debes especificar en tus peticiones es uncensored. Esto le dice a la API qué modelo específico invocar. Es un modelo de pesos abiertos ejecutado en nuestros propios servidores GPU, distinto de GPT, Claude o Gemini.

Cambio de URLs base

Cambiar de una clave de API de github copilot a la API de Cursor implica principalmente cambiar la URL base en la configuración de tu cliente. Si estás usando los SDK oficiales de Python o Node.js de OpenAI, este es un cambio de una línea. Por ejemplo, en Python, inicializarías el cliente con la nueva URL base y tu nueva clave de API.

Este cambio redirige tus peticiones desde los servidores de Microsoft a nuestra infraestructura. Los beneficios incluyen acceso a una ventana de contexto de 100,000 tokens y un modelo ajustado para menos rechazos. Puedes verificar la conexión comprobando el endpoint /v1/models, que debería devolver los modelos disponibles, incluyendo uncensored.

Contrapartida: Aunque la sintaxis es idéntica, ahora pagas por token en lugar de a través de una suscripción de Microsoft. Nuestro precio es transparente: $0.25 por 1M de tokens de entrada y $1.00 por 1M de tokens de salida. No hay tarifas mensuales, solo crédito de pago por uso que no caduca. Este modelo es ideal para cargas de trabajo variables donde no quieres comprometerte con un costo mensual por asiento.

Prueba de tu conexión

Antes de integrar la API en tu flujo de trabajo principal, es esencial verificar que tu entorno pueda comunicarse con la API de Cursor. Puedes hacer esto con un comando cURL simple o un script corto. Esta prueba asegura que tu clave es válida y que la URL base es correcta.

Ejemplo de petición cURL:

Envía una petición POST a https://api.cursorapikey.com/v1/chat/completions con el modelo establecido en uncensored. Incluye un prompt simple en el array de mensajes. Una respuesta exitosa devolverá una completación en el campo choices[0].message.content.

Si recibes un error 401, tu clave de API es incorrecta. Si obtienes un error 429, has excedido el límite de peticiones de 300 peticiones por minuto por clave. Puedes regenerar tu clave en cualquier momento para invalidar la antigua. Esta prueba confirma que la funcionalidad básica de texto de entrada y texto de salida está funcionando como se espera.

Manejo de respuestas en streaming

Para agentes de codificación, las respuestas en streaming son críticas para proporcionar una experiencia de usuario fluida. La API de Cursor admite Server-Sent Events (SSE) para streaming. Esto te permite recibir tokens a medida que se generan, en lugar de esperar a la respuesta completa.

Al usar el SDK de OpenAI, puedes habilitar el streaming estableciendo el parámetro stream en true. El SDK emitirá fragmentos de datos a medida que lleguen. Esto es particularmente útil para generaciones de código largas, donde deseas mostrar el progreso al usuario o enviar tokens a un editor en vivo.

Ten en cuenta que el streaming no cambia el modelo subyacente ni sus capacidades. Es puramente un mecanismo de entrega. El modelo uncensored seguirá respetando la ventana de contexto de 100.000 tokens y la misma estructura de precios. El streaming es una función del lado del cliente que mejora la latencia percibida sin afectar el comportamiento del modelo.

Integración de llamadas a funciones

Los asistentes modernos de codificación de IA dependen en gran medida de las llamadas a funciones para interactuar con el mundo exterior, como ejecutar comandos de shell o acceder a archivos. La API de Cursor admite esto mediante el formato estándar compatible con OpenAI.

Puedes definir herramientas en tu petición usando el parámetro tools. El modelo responderá con un arreglo tool_calls si determina que se debe usar una herramienta. Tu aplicación debe luego ejecutar la herramienta y enviar los resultados de vuelta a la API en un mensaje posterior.

Este proceso es idéntico a cómo usarías una github copilot api key con los modelos de Microsoft. La ventaja aquí es la consistencia. Si tienes código existente para llamadas a herramientas, es probable que puedas reutilizarlo con ajustes mínimos. Asegúrate solo de que las definiciones de tus herramientas coincidan con el esquema esperado para el modelo uncensored.

Monitoreo de uso

Dado que pagas por token, monitorear tu uso es importante para evitar costos inesperados. La API de Cursor proporciona un panel donde puedes ver tu saldo de crédito y el historial de uso. Puedes ver cuántos tokens has consumido y cuánto crédito queda.

Límites clave a vigilar:

• Límite de peticiones: 300 peticiones por minuto por clave.
• Tamaño del cuerpo de la petición: Máximo 8 MB por petición.
• Ventana de contexto: 100,000 tokens en total (entrada + salida).

Si excedes el límite de peticiones, recibirás un error 429. Puedes monitorizar tu uso en tiempo real para asegurarte de que te mantienes dentro de estos límites. Además, puedes regenerar tu clave de API si sospechas que ha sido comprometida, lo que invalida inmediatamente la clave antigua.

Solución de problemas comunes

Incluso con una API robusta, pueden surgir problemas. Aquí hay algunos problemas comunes y sus soluciones.

401 No autorizado: Verifica tu clave de API. Asegúrate de que se haya copiado correctamente y no tenga espacios al principio o al final. Si regeneraste tu clave, asegúrate de estar usando la nueva.

429 Demasiadas peticiones: Has excedido el límite de 300 peticiones por minuto. Implementa retroceso exponencial en tu cliente o reduce la frecuencia de tus peticiones.

400 Solicitud incorrecta: Esto generalmente indica una carga útil JSON mal formada o campos requeridos faltantes. Asegúrate de que tu array messages esté formateado correctamente e incluya los campos role y content. Además, verifica que el nombre del modelo sea exactamente uncensored.

Bloqueo de contenido: Aunque el modelo es sin censura, bloquea contenido sexual que involucre menores. Si tu petición es bloqueada, puede ser debido a este límite estricto específico.