ES ▾
Obtener clave de API

Alternativa a OpenAI para desarrolladores: configuración de clave y SDK

Alternativa a la API de OpenAI sin filtros, lista para usar

Una alternativa a OpenAI para desarrolladores no debería costarte más de una tarde, ni una reescritura. Esta funciona con los SDK estándar de OpenAI: cambias la base URL, pegas una nueva clave de API y llamas al modelo llamado uncensored.

Actualizado

Un terminal conectado por un cable brillante a un único cubo, ilustrando un cambio de URL base para desarrolladores

Puntos clave

Cinco pasos desde cero hasta una llamada funcional

Si quieres una alternativa a OpenAI para desarrolladores que puedas probar hoy, este es todo el camino. Tarda unos diez minutos.

  1. Crea una cuenta con Google o con un correo electrónico y contraseña.
  2. Abre la página de la clave de API y pulsa el botón que reclama el crédito de prueba. Obtienes $0,50, válido durante 7 días, uno por persona, sin tarjeta.
  3. Copia la clave. Trátala como una contraseña y manténla fuera de git.
  4. Configura la URL base a https://api.openaiapialternative.com/v1 en tu SDK o cliente.
  5. Envía una petición con el modelo configurado a uncensored.

Todo lo demás, incluido el formato de mensajes, el streaming y las llamadas a herramientas, es igual al formato de chat completions de OpenAI que ya usas. El servicio expone POST /v1/chat/completions y GET /v1/models. Nada más, así que hay poco que aprender.

Python con el SDK oficial

Instala el paquete con pip install openai. El cliente toma la URL base y la clave como argumentos del constructor, así que no se toca el estado global y puedes mantener un segundo cliente para otro proveedor en el mismo proceso.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.openaiapialternative.com/v1",
    api_key=os.environ["UNCENSORED_API_KEY"],
)

resp = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "Answer briefly and directly."},
        {"role": "user", "content": "List three edge cases for a date parser."},
    ],
    max_tokens=300,
)
print(resp.choices[0].message.content)
print(resp.usage)

max_tokens es opcional. Si no lo indicas, la respuesta puede usar todo lo que quede de la ventana de 100.000 tokens, así que establece un límite cuando quieras un coste predecible.

Los modelos de chat no tienen memoria propia. Cada petición debe llevar el historial que quieres que vea el modelo, así que un asistente de múltiples turnos es solo una lista que vas ampliando:

from openai import OpenAI

client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")
history = [{"role": "system", "content": "You are a patient pair-programming partner."}]

while True:
    user = input("you> ")
    if not user:
        break
    history.append({"role": "user", "content": user})
    r = client.chat.completions.create(model="uncensored", messages=history)
    answer = r.choices[0].message.content
    history.append({"role": "assistant", "content": answer})
    print(answer)

Los tokens de entrada crecen con cada turno, porque se envía toda la lista cada vez. Con una ventana de 100.000 tokens tienes mucho margen, pero pagas por el historial en cada llamada, así que recorta los turnos antiguos o resúmelos cuando la lista sea larga.

Node y curl

El SDK de Node sigue el mismo patrón. Instala con npm install openai y pasa baseURL.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.openaiapialternative.com/v1",
  apiKey: process.env.UNCENSORED_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Write a haiku about stack traces." }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Para una verificación rápida desde el terminal, lista los modelos. Deberías ver una entrada con el ID uncensored.

# expect one entry with id "uncensored"
curl https://api.openaiapialternative.com/v1/models \
  -H "Authorization: Bearer $UNCENSORED_API_KEY"

Una petición en streaming ocupa una de tus ranuras de concurrencia hasta que termina la transmisión, lo cual importa si un cliente abandona una transmisión sin cerrarla. Cierra la conexión desde tu lado cuando el usuario navegue a otro lugar.

Editores, agentes y otros clientes

Muchas herramientas para desarrolladores permiten sobrescribir la URL base de OpenAI. Editores como Cursor tienen una pantalla de configuración de modelos donde puedes ingresar una URL base compatible con OpenAI personalizada y una clave, y interfaces de chat como SillyTavern te permiten agregar un endpoint compatible con OpenAI personalizado. Las etiquetas y las posiciones del menú cambian entre versiones, así que busca un campo llamado algo como "Sobrescribir URL base de OpenAI" o "Endpoint personalizado".

Sea cual sea la herramienta, necesitas los mismos tres valores:

CampoValor
URL basehttps://api.openaiapialternative.com/v1
Clave de APIla clave de tu cuenta
Nombre del modelouncensored

Si la herramienta insiste en una lista de nombres de modelos conocidos, añade uncensored como un modelo personalizado. Si añade /v1 por su cuenta, dale la dirección sin el sufijo, de lo contrario terminarás con una ruta duplicada y un error de no encontrado.

Llamadas a herramientas y modo JSON

La salida estructurada es donde una alternativa suele romperse, así que pruébala temprano. Ambas características usan el formato de OpenAI. Para el modo JSON, configura response_format y menciona JSON en el prompt.

import json
from openai import OpenAI

client = OpenAI(base_url="https://api.openaiapialternative.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    response_format={"type": "json_object"},
    messages=[
        {"role": "system", "content": "Reply with a JSON object with keys title and tags."},
        {"role": "user", "content": "Describe a short story about a lost lighthouse keeper."},
    ],
)
data = json.loads(resp.choices[0].message.content)
print(data["title"], data["tags"])

Para las herramientas, pasa una lista tools con esquemas de funciones, lee tool_calls de la respuesta, ejecuta la función tú mismo y envía el resultado de vuelta como un mensaje con role: "tool". Las respuestas en streaming entregan tool_calls en fragmentos, así que acumula la cadena de argumentos antes de analizarla.

Los modelos aún pueden devolver JSON mal formado de vez en cuando, sin importar el proveedor que uses. Envuelve el análisis en un bloque try y reintenta una vez con el mensaje de error añadido a la conversación.

Las semillas también se pasan, así que configurar seed con una temperatura fija te da una forma de comparar cambios en el prompt con las mismas entradas. No esperes una salida idéntica en bytes en cada ejecución, pero las diferencias se reducen considerablemente.

Límites, manejo de 429 y control de costes

Una clave completa permite 8 solicitudes concurrentes y 300 solicitudes por minuto. La clave de prueba permite 2 y 60. El cuerpo puede tener hasta 8 MB. Cada respuesta transporta X-RateLimit-Limit-Requests y X-RateLimit-Limit-Concurrency, además de X-Balance-USD para tu crédito restante.

Superar los límites devuelve HTTP 429. El código de error indica qué límite: rate_limited significa demasiadas peticiones por minuto, y concurrency significa demasiadas peticiones a la vez. Una sobrecarga temporal también devuelve 429, con una cabecera Retry-After: 5. Los SDK de OpenAI reintentan las respuestas 429 por defecto con espera exponencial, y puedes aumentar el conteo con max_retries en el cliente. Para trabajos por lotes, un semáforo de 8 te mantiene por debajo del límite de concurrencia.

Para presupuestar, trabaja con el precio: $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida. Un trabajo que envía 4M de tokens de entrada y recibe 1M de tokens de salida cuesta 4 x $0,15 + 1 x $0,50 = $1,10. Las peticiones fallidas o rechazadas no se cobran. La página de precios lista los tamaños de recarga y bonificaciones.

Un pequeño envoltorio de reintento es suficiente si no usas un SDK que reintente por ti. Lee Retry-After cuando esté presente, usa una demora exponencial como alternativa y desiste después de unos intentos. No reintentes las peticiones en caso de errores que no sean 429 o un fallo del servidor, porque una petición mal formada fallará de la misma manera cada vez.

Errores que cuestan una hora el primer día

La mayoría de las primeras llamadas fallidas provienen de una lista corta de causas. Verifica estas antes de sospechar del servicio.

  • Una ruta duplicada. La URL base ya termina en /v1. No añadas otra, ni llames a /chat/completions sin ella.
  • El nombre de modelo incorrecto. El código antiguo suele llevar el nombre de un modelo de proveedor. Reemplázalo por uncensored, o la petición no coincidirá con nada.
  • Una clave con espacios en blanco. Las claves copiadas desde una página web o una terminal suelen incluir un salto de línea al final. Elimínalo.
  • Pruebas con una clave de prueba a concurrencia de producción. La clave de prueba permite 2 peticiones simultáneas y 60 por minuto, por lo que una prueba de carga con 20 hilos devolverá 429 con el código concurrency casi al instante.
  • Esperar otros endpoints. Las llamadas de imagen, audio y embeddings no forman parte del servicio.

La segunda categoría es el comportamiento, no la configuración. Un modelo sin rechazos seguirá instrucciones extrañas más literalmente de lo que esperas. Si una respuesta va a un lugar que no querías, ajusta el prompt del sistema en lugar de la temperatura. Si las salidas son repetitivas, aumenta un poco temperature o añade una penalización de frecuencia, ambas se pasan directamente.

Un último hábito: guarda el cuerpo exacto de las peticiones que te sorprendan. Al pedir ayuda en la página de soporte, el ID de petición más ese cuerpo es un reporte de bug completo.

Antes de lanzar

  • Mantén la clave en el servidor. Nunca la envíes en un bundle de navegador o una aplicación móvil.
  • Registra el encabezado X-Request-Id en cada llamada. Esto hace que las preguntas de soporte puedan recibir respuesta.
  • Añade tu propio filtrado de entrada y salida si los usuarios finales pueden escribir libremente. El modelo no rechazará, así que la moderación es tuya para definir.
  • Mantén un proveedor de respaldo en la configuración. Cambiar es un cambio de URL base, así que una bandera de función es suficiente.
  • Recuerda el alcance: solo texto, sin embeddings, sin imágenes, sin ajuste fino.

La documentación tiene la lista completa de parámetros. Si algo se comporta raro, la página de soporte te dice cómo contactar al equipo.

Preguntas y respuestas

¿Qué SDKs funcionan?

Cualquier SDK o cliente de OpenAI que te permita configurar la URL base y la clave. Las bibliotecas oficiales de Python y Node funcionan, al igual que las llamadas HTTP directas con curl.

¿Necesito una tarjeta para probarlo?

No. El crédito de prueba de $0,50 se reclama con un solo clic en la página de la clave de API tras registrarte y no requiere tarjeta. Es válido durante 7 días, uno por persona.

¿Cuál es el nombre del modelo?

El ID del modelo es uncensored. Llama a GET /v1/models para confirmarlo con tu propia clave.

¿Qué tamaño puede tener una petición?

La ventana de contexto es de 100.000 tokens para el prompt más la completación, y el cuerpo máximo de la petición es de 8 MB.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de APILeer los docs