Ejecuta esta prueba con curl primero
Antes de cambiar el código, elimina tu aplicación del panorama. Este único comando envía la petición mínima válida a la API:
curl -i https://api.unrestrictedaiapi.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
GET /v1/models no cuesta nada, por lo que es una forma segura de probar una clave. La bandera -i imprime la línea de estado y los encabezados.
- 200 y una lista de modelos: la clave está bien. Tu aplicación está enviando algo diferente, así que ve a las secciones sobre variables de entorno y URL base.
- 401: la clave o el encabezado son incorrectos. Continúa con la siguiente sección.
- Error de conexión o DNS: la URL base es incorrecta, lo cual es un problema diferente al 401.
Pega la clave a mano en esta prueba, no a través de una variable. Eso elimina el entorno de la lista de sospechosos.
Causa 1: el encabezado no está del todo bien
La API espera Authorization: Bearer <key>. Pequeñas desviaciones producen todas un error 401 de la API LLM:
Authorization: YOUR_KEYcon la palabra Bearer faltante.Authorization: Bearer: YOUR_KEYcon dos puntos extra.Authorization: Bearer "YOUR_KEY"con comillas dentro del valor.Authorization: Bearer YOUR_KEYcon dos espacios.- Un encabezado llamado
X-API-Keyoapi-keyen lugar deAuthorization. Esas son convenciones de otros servicios.
Si usas un SDK de OpenAI, no escribes el encabezado tú mismo. El SDK lo construye a partir del argumento api_key. Si ves un 401 de todos modos, el valor pasado al SDK es el problema, no el formato del encabezado.
Causa 2: la clave en sí está dañada
Las claves son cadenas aleatorias largas, por lo que los errores de copia son comunes y difíciles de detectar a simple vista.
- Salto de línea o espacio al final. Copiar desde un terminal o un archivo de texto a menudo añade uno. Muchas bibliotecas HTTP envían entonces un encabezado no válido o una clave que no coincide.
- Clave truncada. Al hacer doble clic, se selecciona solo parte de la cadena si la clave contiene caracteres que rompen la selección de palabras. Usa el botón de copiar en la página de clave de API en su lugar.
- Comillas inteligentes. Pegar a través de un procesador de palabras o una aplicación de chat puede cambiar las comillas rectas por curvas.
- Clave antigua o rotada. Si creaste una clave nueva, la antigua puede que ya no sea la que estás usando.
Para buscar caracteres invisibles en Python, imprime el repr del valor:
import os
key = os.environ.get("API_KEY", "")
print(repr(key), len(key))
print(repr(key.strip()) == repr(key))
Si la segunda línea imprime False, tienes espacios alrededor de la clave. Llama a .strip() cuando la leas.
Causa 3: la URL base incorrecta
Este es el error más común al migrar una aplicación existente a un nuevo proveedor. Tu clave solo es válida en el host que la emitió. La URL base para este sitio es:
{"base_url": "https://api.unrestrictedaiapi.com/v1"}
Dos patrones de fallo aparecen una y otra vez:
- Configuraste la clave nueva pero dejaste la URL base antigua. La petición va al proveedor antiguo, que rechaza una clave que nunca ha visto y devuelve 401. El texto del error luego menciona al proveedor antiguo, lo cual es una pista útil.
- Configuraste la URL base nueva pero dejaste una clave antigua en el entorno. La petición llega a nosotros, y rechazamos la clave del otro proveedor.
Verifica también la ruta. La URL base ya termina en /v1, por lo que los SDKs añaden /chat/completions a ella. Si construyes la URL a mano, la ruta completa es /v1/chat/completions, no /v1/v1/chat/completions.
Causa 4: variables de entorno y archivos de configuración
Si curl funciona pero tu aplicación falla, algo está pasando a la aplicación una clave diferente a la que crees.
- Variable no exportada. En un shell,
API_KEY=abc python app.pyfunciona, peroAPI_KEY=abcen su propia línea no llega a los procesos hijos. Usaexport. - Sombreado por otro valor. Las bibliotecas pueden leer
OPENAI_API_KEYautomáticamente. Si una antigua está configurada en tu perfil de shell, puede anular lo que pretendías. - Comillas en un archivo .env. Algunos cargadores mantienen las comillas como parte del valor. Si tu clave llega envuelta en caracteres de comillas, elimínalas o prueba con la comprobación repr anterior.
- No reiniciada. Los servidores y los cuadernos leen variables de entorno al inicio. Reinicia después de editar.
- Entorno diferente en producción. Los contenedores, CI y paneles de hosting tienen cada uno su propio almacén de variables. Imprime la longitud de la clave, nunca la clave misma, en los registros.
Una comprobación mínima en Python que demuestra la configuración
Este script usa el SDK de OpenAI e informa claramente si falla la autenticación:
import os
from openai import OpenAI, AuthenticationError
client = OpenAI(
base_url="https://api.unrestrictedaiapi.com/v1",
api_key=os.environ["API_KEY"].strip(),
)
try:
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the word ok."}],
max_tokens=5,
)
print("auth ok:", r.choices[0].message.content)
except AuthenticationError as e:
print("401:", e.status_code, e.response.headers.get("X-Request-Id"))
Si esto imprime un X-Request-Id, inclúyelo cuando escribas a soporte, ya que permite al equipo encontrar tu petición. La misma comprobación en otros lenguajes está en el inicio rápido para cinco lenguajes.
401 frente a otros errores
No gastes tiempo en la autenticación si el error es algo diferente. Un mapa breve:
| Código | Significado habitual | Dónde buscar |
|---|---|---|
| 401 | Clave faltante o inválida | Cabecera, clave, base URL |
| 429 | Límite de peticiones o sobrecarga temporal | Espera y reintenta; consulta la documentación para ver los límites |
| 400 | Cuerpo de la petición malformado | JSON, nombre del modelo, parámetros |
| 404 | Ruta incorrecta | Base URL y endpoint |
Comprueba también el nombre del modelo. Usa uncensored exactamente; un ID de modelo incorrecto es un error de petición, no un 401. Los detalles de la especificación, incluidos los endpoints y encabezados que acepta la API, están en la página de especificación de API compatible con OpenAI.
Proxies, navegadores y últimos recursos
Dos configuraciones causan 401 que parecen misteriosos.
Proxies y pasarelas
Un proxy inverso, una pasarela de API o un envoltorio serverless entre tu aplicación y la API pueden eliminar o reescribir la cabecera Authorization. Prueba desde la misma máquina con curl y compara. Algunos marcos también reenvían la cabecera solo a hosts del mismo origen, por lo que un envoltorio fetch personalizado puede perderla silenciosamente en una llamada de origen cruzado.
Claves en código front-end
Llamar a la API directamente desde JavaScript del navegador expone la clave a cualquiera que abra las herramientas de desarrollo, y los navegadores también pueden bloquear la petición por razones de origen cruzado que parecen errores de autenticación. Mantén la clave en un servidor y deja que tu interfaz frontend llame a tu propio endpoint, que a su vez llama a la API con la clave adjunta. Si una clave se pegó alguna vez en código público o una captura de pantalla, reemplázala.
Sigues atascado
Si una clave recién copiada sigue devolviendo 401 en la prueba de curl, genera la clave nuevamente desde la página de clave de API, pégala directamente en el comando y prueba una vez más. Si eso falla, envía a soporte la hora de la petición, el endpoint y la cabecera de respuesta X-Request-Id. Nunca envíes la clave completa en un mensaje; los primeros y los últimos cuatro caracteres son suficientes para identificarla.
