Cómo usar una API compatible con OpenAI en 5 pasos
Usar una API estilo OpenAI requiere cinco pasos: obtener una clave, instalar un SDK, apuntarlo a la base URL correcta, nombrar un modelo y enviar mensajes. Aquí tienes cada uno con código que puedes pegar.

Puntos clave
- Cualquier SDK de OpenAI funciona aquí una vez que cambies la base URL a https://api.uncensoredaiapis.com/v1 y uses tu propia clave.
- El ID del modelo es uncensored; las rutas principales son POST /v1/chat/completions y GET /v1/models.
- Streaming, modo JSON y llamadas a funciones usan los mismos parámetros que la API oficial.
- Los precios son $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, y puedes comenzar con $0,50 de crédito de prueba.
La versión corta
Si quieres saber cómo usar llamadas a la API de OpenAI con un servicio que no es OpenAI, la respuesta es que el formato de petición es una convención compartida. Un cliente que lo soporte necesita tres valores: dónde enviar las peticiones (la base URL), quién eres (la clave) y qué modelo ejecutar. Cambia esos tres valores y el mismo código funciona. Este sitio sigue esa convención, por lo que los paquetes estándar de Python y Node.js de OpenAI, y curl plano, funcionan contra él.
Sé claro sobre lo que eso significa y lo que no. Compatible significa que la interfaz coincide. No significa que este sea el servicio oficial de OpenAI ni que ejecute modelos de OpenAI. El backend es un modelo de pesos abiertos, gestionado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto legal, y lo seleccionas con el ID del modelo uncensored. Maneja solo texto: sin imágenes, audio, embeddings ni ajuste fino.
Los cinco pasos siguientes tardan unos diez minutos. Si prefieres leer fragmentos terminados en varios idiomas, consulta la página de ejemplos de código.
Paso 1: obtener una clave
Regístrate con Google, o con correo electrónico y contraseña, y abre la página de clave de API. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un clic. Es válido durante 7 días, limitado a uno por persona y no requiere tarjeta. Copia la clave y guárdala como una variable de entorno en lugar de pegarla en el código:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
export API_KEY="paste-your-key-here"La clave de prueba está limitada a 2 peticiones simultáneas y 60 peticiones por minuto. Una clave financiada permite 8 concurrentes y 300 por minuto. Los detalles de lo que incluye la prueba están en la FAQ de prueba gratuita.
Paso 2: instalar un SDK y enviar la primera petición
Instala el paquete oficial para tu lenguaje. Ambas son las mismas bibliotecas que usarías para cualquier servicio estilo OpenAI:
# base URL used below: https://api.uncensoredaiapis.com/v1 , model: uncensored
pip install openai
npm install openaiAhora una primera llamada en Python. La única diferencia con la configuración predeterminada es el argumento base_url:
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredaiapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise writing assistant."},
{"role": "user", "content": "Give me three titles for a noir short story."},
],
)
print(resp.choices[0].message.content)Y la misma llamada en Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredaiapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three titles for a noir short story." }],
});
console.log(resp.choices[0].message.content);Paso 3: entender el array de mensajes
Los modelos de chat no recuerdan nada entre llamadas. Cada petición lleva toda la conversación como una lista de mensajes, y cada mensaje tiene un role.
systemestablece el comportamiento y el estilo. Pon aquí la personalidad, las reglas de formato y las restricciones.usercontiene lo que preguntó la persona.assistantcontiene las respuestas anteriores del modelo. Las añades tú mismo cuando continúas una conversación.toollleva el resultado de una llamada a función, cubierto más abajo.
Para continuar un chat, añade la respuesta del asistente y el siguiente mensaje de usuario a la misma lista y envíala toda de nuevo. Por eso las conversaciones largas cuestan más: cada llamada paga por todo el historial como tokens de entrada. La ventana de contexto contiene 100,000 tokens en total, prompt y respuesta juntos, por lo que recortar turnos antiguos es una parte normal de construir una app de chat.
Los campos de muestreo útiles se pasan a través: temperature, top_p, stop, seed y las penalizaciones de frecuencia y presencia. max_tokens es opcional. Ajústalo cuando quieras limitar la longitud de la respuesta y el gasto.
Paso 4: streaming, modo JSON y herramientas
Transmisión
Añade stream: true para recibir tokens como eventos enviados por el servidor. Hace que las interfaces se sientan rápidas, ya que el texto aparece mientras el modelo sigue escribiendo, y el uso se informa al final del streaming.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.com/v1", apiKey: process.env.API_KEY });
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Write a short toast for a retirement party." }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}Modo JSON
Usa response_format: {"type": "json_object"} cuando tu código analice la respuesta. Describe también las claves deseadas en el prompt.
curl https://api.uncensoredaiapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"response_format": {"type": "json_object"},
"messages": [
{"role": "system", "content": "Reply with JSON: {\"mood\": string, \"score\": number}"},
{"role": "user", "content": "Rate this line: the rain finally stopped."}
]
}'Llamadas a funciones
Pasa una lista tools con esquemas de función, y opcionalmente tool_choice. Cuando el modelo quiera ejecutar una función, la respuesta contiene tool_calls. Ejecutas la función en tu propio código y envías la salida de nuevo como un mensaje con role tool. Las llamadas a funciones también usan streaming. Este es el bloque de construcción para agentes; la página de casos de uso muestra dónde compensa.
Paso 5: conocer los límites, costes y errores
Al superar un límite, la API devuelve HTTP 429. El código de error es rate_limited para demasiadas peticiones por minuto y concurrency para demasiadas a la vez. Una sobrecarga temporal también da un 429, con un encabezado Retry-After: 5. Una petición en streaming mantiene su slot de concurrente hasta que termina el streaming, así que cierra los streams que ya no leas. El límite del cuerpo es 8 MB. Cada respuesta lleva los encabezados X-Request-Id y X-Balance-USD, y el primero es lo que citas para soporte.
Los costes son simples. Una llamada de chat con 3.000 tokens de entrada y 700 de salida cuesta 3.000 veces $0,15 por millón, que es $0,00045, más 700 veces $0,50 por millón, que es $0,00035, así que $0,0008 en total. Mil llamadas de este tipo cuestan $0,80. Las peticiones fallidas o rechazadas no se cobran, y el crédito no caduca. La página de precios lista recargas desde $20 hasta $500 con +5% desde $50, +10% desde $100 y +15% desde $200. Puedes pagar con cripto (USDT en TRC20, USDC en Base).
En qué se diferencia de la API oficial
Tres diferencias valen la pena planear. Primero, el nombre del modelo: usa uncensored, no un nombre de modelo de OpenAI. Segundo, el alcance: solo obtienes chat completions y la lista de modelos, por lo que funciones como generación de imágenes, voz, embeddings y ajuste fino no están aquí. Tercero, el comportamiento: el modelo está ajustado para no rechazar peticiones adultas legales, por lo que la salida puede diferir de un asistente muy filtrado. Una regla nunca cambia: sin contenido sexual que involucre menores de edad.
Algunos hábitos ayudan desde el primer día. Mantén la clave en una variable de entorno, registra el X-Request-Id de cada llamada, y establece max_tokens mientras experimentas para que una respuesta descontrolada no gaste más de lo planeado. Cuando construyas una interfaz de chat, haz streaming de la respuesta y recorta turnos antiguos una vez que el historial crezca. Cuando construyas una tubería que analice la salida, usa el modo JSON y aún así protege el análisis, porque una respuesta cortada en el límite de tokens no es JSON válido. Y cuando dos partes de tu programa llamen a la API al mismo tiempo, cuéntalas contra las 8 peticiones concurrentes que permite una clave completa.
No olvides el coste de las pruebas. Unas pocas docenas de experimentos con prompts cortos cuestan mucho menos de un céntimo en total, así que el crédito de prueba de $0,50 rinde mucho mientras aprendes el formato de petición.
Si estás migrando una aplicación existente, la guía de migración recorre los cambios en orden. Los prompts enviados aquí no se utilizan para entrenamiento. Para la mayoría de las aplicaciones, la migración son los tres valores del inicio de esta página y un nombre de modelo.
Más guías
Preguntas y respuestas
¿Necesito el SDK oficial de OpenAI?
Puedes usarlo y es la ruta más fácil. Cualquier cliente compatible con OpenAI o HTTP plano también funciona, siempre que admita una base URL personalizada.
¿Qué nombre de modelo envío?
Envía uncensored. La base URL es https://api.uncensoredaiapis.com/v1.
¿Es esta la API oficial de OpenAI?
No. Sigue el mismo formato de petición, pero el modelo es un modelo de pesos abiertos gestionado por un proveedor independiente y el servicio es independiente de OpenAI.
¿Cuánto cuesta una petición?
Los tokens de entrada cuestan $0.15 por cada 1M y los de salida $0.50 por cada 1M. Una petición con 3,000 tokens de entrada y 700 de salida cuesta unos $0.0008.
¿Puedo probarlo antes de pagar?
Sí. Tras registrarte puedes reclamar $0,50 de crédito de prueba con un clic. Es válido durante 7 días y no requiere tarjeta.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.