Error 401: qué hacer cuando falla gpt-5.5

Un 401 significa que la autenticación falló: la solicitud no lleva API Key, o la clave no es válida, ha sido eliminada o ha caducado.

401 Unauthorized significa que la solicitud no lleva credenciales válidas. El gateway no pudo identificar al llamante, así que la petición nunca llega al modelo upstream. Revisar la cabecera Authorization y el estado de la key es el único camino.

gpt-5.5 lo ofrece OpenAI. Todo en esta página — causas, soluciones y datos medidos — se recopila del comportamiento real de este modelo en la capa de gateway.

En esta pasarela, el desencadenante más común es: Falta la cabecera Authorization. La primera acción recomendada es: Envía la cabecera como Authorization: Bearer seguida de tu clave.

Causas habituales

• Falta la cabecera Authorization
• La clave está mal escrita o tiene espacios sobrantes
• La clave se eliminó o desactivó en la página Tokens
• Se usó por error una clave de otra plataforma

Cómo solucionarlo

• Envía la cabecera como Authorization: Bearer seguida de tu clave
• Genera una clave nueva en la página Tokens
• Comprueba que no uses una clave de otro servicio
• Verifica la clave con una solicitud curl mínima

Reintento con retroceso exponencial

El siguiente código reintenta cuando gpt-5.5 devuelve 401: hasta 5 intentos, con espera creciente y jitter aleatorio para que las llamadas concurrentes no reintenten a la vez. Lee la URL base y la API key de variables de entorno, nunca las escribas fijas.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'gpt-5.5'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Datos clave de este modelo

Preguntas frecuentes

Otros errores de este modelo

• gpt-5.5: error 429 — causas y soluciones
• gpt-5.5: error timeout — causas y soluciones
• gpt-5.5: error 500 — causas y soluciones
• gpt-5.5: error 502 — causas y soluciones
• gpt-5.5: error 503 — causas y soluciones
• gpt-5.5: error 504 — causas y soluciones
• gpt-5.5: error 403 — causas y soluciones
• gpt-5.5: error 400 — causas y soluciones

Otros modelos con el mismo error

• gpt-5
• claude-opus-5
• gemini-2.5-pro
• deepseek-v4-pro
• grok-4.3
• llama-3.3-70b-instruct
• qvq-max
• qwq-32b
• glm-5
• MiniMax-M3
• kimi-k3
• hy3
• doubao-seed-evolving
• mimo-v2.5
• gpt-4o
• claude-opus-4-6

Volver a la página del modelo

Datos actualizados: 2026-10-11 15:15