ES ▾
https://api.unrestrictedaiapi.com/v1uncensored2026-10-06
Obtener clave de API

Error 401 de la API LLM: Solución de fallos de autenticación

Un error 401 de la API LLM significa que el servidor no pudo autenticar tu petición. En casi todos los casos, la causa está en el lado del cliente: un encabezado mal escrito, una clave con un carácter extraño o una petición enviada al host incorrecto. Esta guía recorre las verificaciones en el orden que encuentra el problema más rápido.

Actualizado

Una clave que no encaja en un candado brillante, ilustrando un fallo de autenticación al llamar a una API LLM

Puntos clave

  1. 401 es un fallo de autenticación, no un límite de peticiones ni un error de facturación.
  2. El encabezado debe ser exactamente Authorization: Bearer YOUR_KEY, con un espacio y sin comillas.
  3. Una clave enviada a la URL base incorrecta falla igual que una clave incorrecta.
  4. Prueba primero con curl; si curl funciona, el error está en la configuración de tu aplicación.

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_KEY con la palabra Bearer faltante.
  • Authorization: Bearer: YOUR_KEY con dos puntos extra.
  • Authorization: Bearer "YOUR_KEY" con comillas dentro del valor.
  • Authorization: Bearer YOUR_KEY con dos espacios.
  • Un encabezado llamado X-API-Key o api-key en lugar de Authorization. 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.py funciona, pero API_KEY=abc en su propia línea no llega a los procesos hijos. Usa export.
  • Sombreado por otro valor. Las bibliotecas pueden leer OPENAI_API_KEY automá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ódigoSignificado habitualDónde buscar
401Clave faltante o inválidaCabecera, clave, base URL
429Límite de peticiones o sobrecarga temporalEspera y reintenta; consulta la documentación para ver los límites
400Cuerpo de la petición malformadoJSON, nombre del modelo, parámetros
404Ruta incorrectaBase 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.

Preguntas y respuestas

¿Significa un 401 que me he quedado sin crédito?

No. Un 401 se refiere a la autenticación: falta la clave, está malformada o es desconocida. Quedarse sin crédito es una condición separada.

¿Por qué la misma clave funciona en curl pero no en mi aplicación?

Tu aplicación probablemente está leyendo un valor diferente, como una variable de entorno antigua, una entrada .env entre comillas o una clave con espacios en blanco al final. Imprime la longitud y el repr de la clave que realmente usa tu código.

¿Puedo usar mi clave de OpenAI con esta API?

No. Cada clave funciona solo en el host que la emitió. Usa la clave de la página de claves de API junto con la base URL de este sitio.

¿Se cobra un 401?

No. Las peticiones fallidas o rechazadas no se cobran.

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 API