Documentación y endpoints de la API Codex

URL Base y autenticación

Envía solicitudes a la URL base https://api.codexapipricing.com/v1 usando tu clave API. Este endpoint es compatible con SDK estándar de OpenAI, por lo que solo necesitas actualizar la base URL y proporcionar tu clave. Autentícate pasando el encabezado Authorization: Bearer YOUR_API_KEY con cada solicitud. Puedes generar una clave inmediatamente al iniciar sesión con Google o con correo electrónico y contraseña. La clave se muestra una sola vez después de su creación, así que guárdala de forma segura. Tus prompts no se utilizan para entrenamiento, lo que garantiza la privacidad de tus datos.

Endpoint de completados de chat

Utiliza el POST /v1/chat/completions endpoint para generar texto. Esta es la interfaz principal para enviar prompts y recibir respuestas. El ID del modelo es siempre uncensored, independientemente de la versión del modelo que se ejecute en nuestros servidores. Puedes verificar los modelos disponibles mediante GET /v1/models. Envía tu historial de mensajes en el messages

Parámetros compatibles y modo JSON

Controla la generación con parámetros como temperature, top_p, y stop. Utiliza response_format establecido a {"type": "json_object"} para forzar la salida JSON. Esto es útil para la extracción de datos estructurados o la llamada de funciones. También puedes establecer max_tokens para limitar la longitud de la salida, con un valor predeterminado de 2,048 si se omite. La ventana de contexto admite hasta 100,000 tokens para prompt y completación combinados. Pasa seed para resultados deterministas o presence_penalty y frequency_penalty ajustar la repetición. Estos parámetros permiten ajustar el comportamiento del modelo sin una configuración compleja. El modo JSON asegura un formato estricto para un análisis confiable en tu aplicación.

Respuestas en streaming mediante SSE

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve Eventos Enviados por Servidor (SSE) a medida que se generan los tokens. Esto reduce la latencia percibida para respuestas largas. Los detalles del uso de tokens aparecen en el último fragmento del flujo. Puedes procesar los tokens incrementalmente para mostrar el texto en tiempo real. Esta función funciona con todos los SDK compatibles con OpenAI. El flujo es ideal para interfaces de chat donde los usuarios esperan retroalimentación inmediata. El último fragmento contiene el recuento total de tokens para la precisión de la facturación. Usa este método para manejar salidas grandes con gracia sin esperar a la respuesta completa.

Límites de velocidad y cuerpos de solicitud

Cada clave de API está limitada a 300 solicitudes por minuto y 8 solicitudes concurrentes. El tamaño máximo del cuerpo de la solicitud es de 8 MB. Si excedes estos límites, recibirás un error 429. Puedes generar nuevas claves para reemplazar las existentes, pero solo una clave está activa por cuenta. Los errores y las denegaciones no cuentan contra tu límite de velocidad. La ventana de contexto de 100,000 tokens permite un historial de conversación extenso. Mantén los cuerpos de tus solicitudes concisos para permanecer dentro de los límites de tamaño. Monitorea tu uso para evitar interrupciones durante las horas pico. Estos límites garantizan un uso justo para todos los clientes prepagados.

Gestión de errores y resolución de problemas

Gestiona los errores comprobando el código de estado HTTP. Un error 401 indica una clave API inválida o ausente. Un error 402 significa que tu crédito prepagado se ha agotado. Un error 429 indica que has superado los límites de frecuencia. Usa el error field in the response to get details. Mistakes like double charges are fixed via the Support page. Credit never expires, so you can top up later. Refusals for content policy violations are free. This predictable error structure helps you debug integration issues quickly without guessing the cause.

cURL

Copycurl https://api.codexapipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the hourly rates for the large model."}]
  }'

Python

Copyfrom openai import OpenAI

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