Erro 401: o que fazer quando gpt-5-pro falha

Um 401 significa que a autenticação falhou: a requisição não traz API Key, ou a chave é inválida, foi excluída ou expirou.

401 Unauthorized significa que a requisição não traz credenciais válidas. O gateway não conseguiu identificar quem chamou, então a requisição nunca chega ao modelo upstream. Verificar o header Authorization e o estado da key é o único caminho.

gpt-5-pro é fornecido por OpenAI. Tudo nesta página — causas, correções e dados medidos — é compilado a partir do comportamento real deste modelo na camada de gateway.

Neste gateway, o gatilho mais comum é: Falta o cabeçalho Authorization. A primeira ação recomendada é: Envie o cabeçalho como Authorization: Bearer seguido da sua chave.

Causas comuns

  • Falta o cabeçalho Authorization
  • A chave está escrita errada ou tem espaços extras
  • A chave foi excluída ou desativada na página Tokens
  • Foi usada por engano uma chave de outra plataforma

Como resolver

  • Envie o cabeçalho como Authorization: Bearer seguido da sua chave
  • Gere uma nova chave na página Tokens
  • Verifique se não está usando a chave de outro serviço
  • Valide a chave com uma requisição curl mínima

Nova tentativa com backoff exponencial

O código abaixo tenta novamente quando gpt-5-pro retorna 401: até 5 tentativas, com espera crescente e jitter aleatório para que chamadas concorrentes não repitam ao mesmo tempo. Leia a URL base e a API key de variáveis de ambiente, nunca as deixe fixas no código.

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-pro'


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"}]))

Dados-chave deste modelo

Endpoint da APIhttps://api.airai.cc/v1
Compatível com OpenAIOpenAI-compatible
FornecedorOpenAI
Contexto400K
RecursosReasoning, Tools, Files, Vision
Formatos de APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Fórmula de cobrançap * 15 + c * 120

Perguntas frequentes

401 em gpt-5-pro está relacionado ao tamanho do corpo?

Os parâmetros precisam mudar; só tentar de novo não ajudará. É um problema de configuração do cliente; nada muda no servidor. As tags de capacidade são Reasoning, Tools, Files, Vision e os limites de parâmetros vêm desse conjunto. A janela de contexto 400K define a entrada máxima por requisição; o que passar é rejeitado na hora. Falhe rápido em erros de parâmetro em vez de gastar retentativas com eles. Trunque ou resuma entradas longas — reduz 401 de forma perceptível.

Trocar por um modelo equivalente de outro fornecedor resolve 401?

Deixe também um modelo reserva preparado. Este modelo da OpenAI tem vários nós upstream entre os quais o gateway pode alternar. Deixe um modelo reserva mais leve pronto, assim o fluxo principal não para.

Como agendar jobs em lote quando gpt-5-pro retorna 401?

Reduza primeiro a concorrência — a maior parte dos problemas de throughput desaparece. Este modelo tem janela de contexto de 400K e é da OpenAI. Um contexto de 400K significa que entradas longas aumentam a latência do primeiro token. Comece com concorrência baixa, observe por alguns minutos e depois aumente.

Compartilhar uma key entre vários serviços torna 401 mais provável?

É sobretudo questão de cota, não uma falha do modelo. Tanto elevar o limite do plano quanto reduzir a frequência de chamadas ajuda. O preço de entrada fica em torno de $15.00 por milhão de tokens. Com a cobrança p * 15 + c * 120, requisições falhas não entram no uso. Confira primeiro saldo e limites de taxa no console, depois o código. Ao estimar o custo a partir de p * 15 + c * 120, inclua também o orçamento de retentativas.

Outros erros deste modelo

Outros modelos com o mesmo erro

Voltar à página do modelo

Dados atualizados: 2026-10-10 12:10

Suporte técnicoAtendimento online
Voltar ao topo