Puntos clave
- Nuestra URL base es https://api.uncensoredgptapi.com/v1 y el ID del modelo es
uncensored. - Los SDK de Python y Node toman base_url o baseURL; ambos también leen variables de entorno.
- La mayoría de los fallos provienen de la falta de /v1, una ruta duplicada o un nombre de modelo antiguo.
- GET /v1/models es la forma más rápida de confirmar que la URL y la clave son correctas.
Qué hace la URL base
La URL base de la API GPT es la dirección que un SDK de OpenAI antepone a cada ruta de endpoint. Por defecto, los SDK oficiales envían peticiones a los servidores de OpenAI. Si configuras una URL base diferente, el mismo código de cliente envía el mismo formato de petición a otro servidor que hable el mismo protocolo.
Eso es todo lo que significa compatible con OpenAI en la práctica. Nuestra API acepta POST /v1/chat/completions y GET /v1/models con las mismas estructuras JSON, el mismo encabezado Authorization: Bearer y el mismo formato de streaming. Así que cambias tres valores:
- URL base:
https://api.uncensoredgptapi.com/v1 - Clave de API: la clave de tu panel de control
- Modelo:
uncensored
Nuestro servicio es independiente y ejecuta un único modelo de pesos abiertos. No es la API de OpenAI ni un enrutador hacia otros proveedores, por lo que nombres de modelo como gpt-4o no existen aquí. Usa uncensored en todas partes.
Python con el SDK de OpenAI
En el SDK actual de Python, pasa base_url al crear el cliente.
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredgptapi.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a base URL is in two sentences."},
],
)
print(resp.choices[0].message.content)Si tu código es más antiguo y usa openai.api_base, pertenece al SDK pre-1.0, donde la configuración global tiene un nombre diferente. Actualizar el paquete suele ser más fácil que adaptarlo. Verifica la versión con pip show openai.
Ayuda saber cómo el SDK construye una petición. Toma tu URL base, añade la ruta del endpoint como /chat/completions y añade el encabezado Authorization: Bearer desde tu clave. Ese es todo el mecanismo. Cuando algo falle, imprime o registra la URL final y compárala con el comando curl en la siguiente sección.
El mismo cliente acepta configuraciones de timeout y max_retries. Los valores predeterminados reintentan unas pocas veces en problemas de conexión, lo cual es adecuado para la mayoría de los scripts. Para los límites de peticiones, captura la excepción de límite de peticiones del SDK y reduce la frecuencia. Una petición en streaming mantiene su espacio de concurrencia hasta que termina, por lo que una ráfaga de streams largos puede alcanzar el límite de concurrencia incluso si tu número de peticiones por minuto es bajo.
import time
from openai import OpenAI, RateLimitError
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY", max_retries=0)
def ask(text, tries=4):
for attempt in range(tries):
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": text}],
)
return r.choices[0].message.content
except RateLimitError:
time.sleep(5 * (attempt + 1))
raise RuntimeError("still rate limited")La espera de cinco segundos en el primer reintento coincide con el valor Retry-After: 5 que envía la API en caso de sobrecarga temporal. Esperar más tiempo en cada intento posterior evita saturar el endpoint.
Node y curl
El SDK de Node usa baseURL con la URL en mayúsculas.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredgptapi.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
});
console.log(resp.choices[0].message.content);Sin ningún SDK, curl muestra exactamente lo que hace el SDK. La URL completa es la URL base más /chat/completions.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}]}'Leer ese comando es la forma más clara de entender la URL base: todo hasta e incluyendo /v1 es la base, y el SDK añade el resto.
Variables de entorno
Si no puedes editar el código, o quieres una configuración para varios scripts, los SDK de OpenAI leen OPENAI_BASE_URL y OPENAI_API_KEY del entorno cuando no se da un valor explícito.
export OPENAI_BASE_URL="https://api.uncensoredgptapi.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python my_script.pyEsto es útil para herramientas que no escribiste. Cualquier cosa construida sobre el SDK de OpenAI puede recoger las variables sin cambios, aunque aún necesitas configurar el nombre del modelo a uncensored dentro de la herramienta. Si la herramienta codifica un modelo, necesitas su propia configuración o un cambio de código.
Mantener separados dos endpoints
Muchos proyectos prueban contra un endpoint y despliegan contra otro, o cambian entre ellos por entorno. Mantén los tres valores fuera de tu código y léelos desde la configuración, para que un cambio sea una modificación de un archivo y no de código.
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ.get("LLM_BASE_URL", "https://api.uncensoredgptapi.com/v1"),
api_key=os.environ["LLM_API_KEY"],
)
MODEL = os.environ.get("LLM_MODEL", "uncensored")Usar tus propios nombres de variable en lugar de los predeterminados del SDK evita una trampa silenciosa: una herramienta que lee OPENAI_API_KEY del shell enviará cualquier clave configurada allí a cualquier URL base configurada junto a ella. Si tienes una clave antigua de OpenAI en tu perfil y una URL base nueva en tu proyecto, puedes terminar enviando la clave de un servicio a otro. Nombres separados hacen eso imposible y puedes ver a simple vista qué endpoint usará un script.
Trata el nombre del modelo como configuración también. Es el valor que más a menudo se deja atrás cuando cambias, y produce los fallos más confusos, ya que todo lo demás parece correcto.
El streaming y las herramientas usan la misma URL base
Cambiar la URL base no limita las funciones. El streaming, las llamadas a funciones y el modo JSON pasan por la misma ruta /chat/completions, por lo que el código que funcionaba contra la API original sigue funcionando. El streaming devuelve Server-Sent Events, con el uso reportado al final del stream.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredgptapi.com/v1", api_key="YOUR_API_KEY")
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Count from one to five."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
print()La comprobación de chunk.choices es importante. El último fragmento que lleva el uso puede no tener ningún elemento en choices, y el código que indexa en una lista vacía se bloquearía en el último mensaje. Las llamadas a funciones fluyen de la misma manera, como deltas parciales de tool_calls que ensamblas antes de ejecutar la función, y los resultados vuelven como mensajes con role: "tool". El modo JSON toma response_format={"type": "json_object"}.
Aplicaciones y frameworks con un campo de URL base
Muchas aplicaciones exponen la misma configuración bajo nombres diferentes: API base, endpoint, URL de OpenAI personalizada o host. La regla no cambia. Pega la URL base incluyendo /v1, pega la clave y escribe uncensored como nombre del modelo.
SillyTavern, por ejemplo, te permite añadir un endpoint compatible con OpenAI. La clase ChatOpenAI de LangChain acepta un argumento base_url. Otras interfaces llaman al campo proxy URL o proxy inverso. Los nombres de campo varían por versión, así que busca el que acepte una URL que termine en /v1.
Algunas aplicaciones solicitan un modelo desde un menú desplegable que llenan llamando a GET /v1/models. Ese endpoint funciona aquí y devuelve la lista de modelos, por lo que el menú desplegable debería mostrar uncensored una vez que la URL y la clave sean correctas. Si permanece vacío, la URL o la clave son incorrectas.
Cuando una aplicación ofrece un campo de URL base y un campo de "organización" o "proyecto", deja los campos adicionales vacíos. Esos existen para el servicio original y no significan nada aquí. Si una aplicación insiste en una clave que comienza con un prefijo determinado, prueba un tipo de conexión diferente, como una opción genérica o personalizada compatible con OpenAI, en lugar del preset para el servicio original.
Algunas herramientas de escritorio prueban la conexión solicitando un nombre de modelo específico del proveedor original y reportan un fallo incluso cuando el endpoint está bien. En ese caso, omite el botón de prueba y envía un mensaje real. Si llega la respuesta, la URL, la clave y el modelo son correctos, y la herramienta solo es estricta en su comprobación.
Las herramientas basadas en navegador también pueden tropezar con las reglas de origen cruzado, ya que la petición sale de la página hacia un host diferente. Si una herramienta web falla en el navegador pero la misma llamada funciona en curl, ejecuta la petición desde un pequeño servidor propio para que la clave permanezca fuera del código del lado del cliente, que es el diseño más seguro en cualquier caso.
Errores comunes y cómo solucionarlos
Casi cada configuración fallida proviene de una lista corta.
- Falta /v1. La URL base es
https://api.uncensoredgptapi.com/v1, toda la dirección hasta/v1y no solo el nombre del host. Sin/v1el SDK construye rutas que no existen. - Ruta duplicada. Si pegas
.../v1/chat/completionscomo URL base, el SDK añade la ruta de nuevo. Dale solo la base. - Barra final. La mayoría de los SDK la manejan, pero algunas herramientas no. Prueba sin una.
- Nombre antiguo del modelo. Un nombre de modelo como
gpt-4oque queda del código original no coincidirá. Estableceuncensored. - Clave incorrecta. Usa la clave de este servicio. Una clave de OpenAI no funciona aquí, y la nuestra no funciona en OpenAI.
- Errores de límite de peticiones. HTTP 429 con código
rate_limitedindica demasiadas peticiones por minuto; el códigoconcurrencyindica demasiadas a la vez. Un 429 con un encabezadoRetry-After: 5indica sobrecarga temporal, así que espera cinco segundos y reintenta.
Nuestra guía de solución de problemas detalla más los errores de integración.
Verifica la configuración en una sola llamada
Antes de ejecutar toda tu aplicación, llama al endpoint de modelos. Es económico y confirma la URL y la clave al mismo tiempo.
curl https://api.uncensoredgptapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Si eso devuelve una lista que contiene uncensored, envía una petición de chat real. Para una clave completa, espera hasta 8 peticiones simultáneas y 300 peticiones por minuto; una clave de prueba permite 2 simultáneas y 60 por minuto. Cada respuesta incluye X-Request-Id, X-Balance-USD y los encabezados de límite de peticiones, útiles al depurar.
Para obtener una clave, regístrate y usa la página de clave de API, donde los nuevos usuarios pueden reclamar un crédito de prueba de $0,50 con un solo clic. La documentación cubre streaming, llamadas a funciones y modo JSON una vez que la conexión funcione.
