¿Qué es la API de Codex?
El término codex api se refiere generalmente a la interfaz utilizada por modelos de IA entrenados específicamente para la generación y comprensión de código. Popularizado originalmente por OpenAI, este concepto ha evolucionado hasta convertirse en un estándar más amplio donde varios proveedores ofrecen endpoints compatibles con OpenAI. Para los agentes de programación, esto significa una estructura POST /v1/chat/completions consistente que maneja interacciones de texto de entrada y texto de salida.
Nuestro servicio proporciona un modelo de lenguaje grande dedicado y sin censura optimizado para contextos de programación. A diferencia de los reenviadores proxy que agregan múltiples proveedores, ejecutamos un único modelo de pesos abiertos en nuestros servidores GPU. Esto garantiza un endpoint de modelo único y estable con una ventana de contexto de 100.000 tokens, lo cual es crítico para manejar codebases grandes sin perder el contexto.
La API no admite embeddings, generación de imágenes, audio o video, ni ofrece ajuste fino. Es estrictamente un motor de finalización basado en texto diseñado para integrarse directamente en agentes de programación como Cursor o Claude Code.
¿Por qué usar un modelo sin censura?
Los modelos de programación estándar a menudo aplican filtros de contenido que pueden interferir con las tareas técnicas. Por ejemplo, un modelo podría rechazar generar código para una vulnerabilidad de seguridad o bloquear la sintaxis de un lenguaje de programación específico si se asemeja a una obra con derechos de autor, incluso cuando el caso de uso es legal y técnico. Un modelo sin censura elimina estos rechazos arbitrarios, permitiendo que el agente se centre puramente en la calidad y la lógica del código.
Nuestro modelo está ajustado para responder sin rechazos de contenido para uso adulto lícito. Esto es especialmente útil para agentes de IA de programación que necesitan procesar fragmentos de código diversos, documentación o proyectos de programación creativa sin encontrar un error 403 Forbidden debido a la política de contenido.
Existe un límite de contenido estricto que siempre se aplica: no hay contenido sexual que involucre a menores. Las solicitudes de ese tipo se bloquean. Para todos los demás temas adultos, ficticios o de investigación de seguridad legales, el modelo proporcionará una respuesta directa. Esta estabilidad reduce la necesidad de lógica de reintento en el flujo de trabajo de tu agente, ahorrando tokens y tiempo.
Configuración de Cursor IDE
Cursor IDE es un editor de código popular impulsado por IA que depende de endpoints de LLM externos. Para usar nuestra API sin censura como tu agente de programación principal, necesitas actualizar la URL base en tu configuración.
Ve a la configuración de Cursor y busca la sección de configuración de API. Cambia la URL base a https://api.getcodexapi.com/v1. Ingresa tu clave de API desde la página Obtener clave de API. El ID de modelo que debes seleccionar es uncensored.
Esta configuración asegura que todas las sugerencias de código y las ediciones sean procesadas por nuestro modelo dedicado. Dado que Cursor utiliza el formato compatible con OpenAI, no se requiere middleware adicional. La ventana de contexto de 100,000 tokens permite al editor mantener el contexto en archivos grandes o tareas de refactorización de múltiples archivos, lo cual es una limitación común en modelos con ventanas de contexto más pequeñas.
Compromiso: No tendrás acceso a modelos propietarios como GPT-4 o Claude a menos que cambies la configuración manualmente. Sin embargo, para la generación y edición pura de código, este endpoint sin censura suele ofrecer resultados más rápidos y consistentes sin interrupciones por políticas.
Conexión con Claude Code
Claude Code es un agente de línea de comandos desarrollado por Anthropic. Aunque normalmente utiliza la API de Anthropic, se puede configurar para usar cualquier endpoint compatible con OpenAI si el cliente lo admite. Esto hace que nuestra API sea una alternativa viable para usuarios que prefieren el comportamiento sin censura de nuestro modelo pero les gusta la interfaz de Claude Code.
Para conectarte, necesitas asegurarte de que tu cliente admita URLs base personalizadas. Actualiza la configuración para apuntar a https://api.getcodexapi.com/v1 y establece el modelo en uncensored. También necesitarás proporcionar tu clave de API.
Esta configuración es útil para desarrolladores que desean las capacidades robustas de llamada de herramientas de un agente de programación pero necesitan un modelo que no rechace patrones de código complejos o inusuales. Ten en cuenta que aunque la interfaz permanece igual, el comportamiento del modelo subyacente diferirá de los modelos Claude estándar. Prueba siempre tus flujos de trabajo específicos para asegurarte de que el modelo sin censura cumple con tus estándares de calidad de código.
Uso del SDK de OpenAI
El SDK de OpenAI para Python o Node.js está diseñado para funcionar con cualquier endpoint compatible con OpenAI. Puedes cambiar a nuestra API modificando la URL base y la clave de API.
Así es como puedes inicializar el cliente en Python:
from openai import OpenAI
client = OpenAI(
base_url="https://api.getcodexapi.com/v1",
api_key="your-api-key"
)
Luego, puedes llamar al endpoint de finalización de chat como de costumbre:
response = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a Python function to sort a list."}]
)
Esta simplicidad te permite cambiar el modelo subyacente sin reescribir la lógica central de tu agente. El SDK maneja la serialización y el análisis de respuestas, para que puedas centrarte en la lógica de la aplicación.
Respuestas en streaming para retroalimentación en tiempo real
Para agentes de programación que proporcionan sugerencias de código en tiempo real, el streaming es esencial. Nuestra API admite Server-Sent Events (SSE) para respuestas en streaming. Esto permite al agente mostrar el código a medida que se genera, mejorando la experiencia del usuario.
- Establece
stream=Trueen tu solicitud de API. - Lee los fragmentos del stream.
- Actualiza la interfaz de usuario o el editor con cada fragmento.
Esto reduce la latencia percibida, especialmente para bloques de código grandes. Dado que nuestro modelo tiene una ventana de contexto de 100,000 tokens, puedes recibir respuestas en streaming que incluyen grandes cantidades de contexto sin preocuparte por la truncación.
Nota: El streaming no cambia la facturación ni el conteo de tokens. Los tokens se facturan según el total de entrada y salida, independientemente de si la respuesta se transmite o se devuelve en un solo bloque.
Manejo de llamadas a funciones
Los agentes de codificación de IA suelen usar llamadas a funciones para interactuar con herramientas externas, como ejecutar un comando de terminal o leer un archivo. Nuestra API admite esta función, lo que te permite definir esquemas de funciones en tu petición.
- Define tus funciones en el parámetro
functions. - El modelo devolverá una respuesta con un objeto
function_call. - Tu agente ejecuta la función y envía el resultado de vuelta al modelo.
- El modelo genera la siguiente respuesta basada en el resultado.
Esta interacción multiturno es crucial para tareas de programación complejas. Por ejemplo, un agente podría necesitar leer un archivo, analizarlo y luego generar una corrección. Nuestra API maneja esto sin problemas, manteniendo el contexto a través de múltiples turnos dentro del límite de 100,000 tokens.
Gestión de límites de peticiones
Para garantizar un uso justo y la estabilidad, nuestra API aplica un límite de 300 peticiones por minuto por clave. El tamaño máximo del cuerpo de la petición es de 8 MB. Si excedes estos límites, recibirás un error 429 Too Many Requests.
Mejores prácticas:
- Implementa retroceso exponencial en la lógica de reintento de tu agente.
- Usa streaming para reducir el número de llamadas a la API para respuestas grandes.
- Monitorea tu uso a través del panel para evitar cargos inesperados.
Si necesitas rotar las claves, puedes regenerar tu clave de API en cualquier momento. Esto revoca la clave antigua, así que asegúrate de actualizar tus agentes antes de regenerarla.
