Solução de problemas de solicitações

Erro 503 de API de IA: endpoints indisponíveis ou sobrecarregados

Um 503 significa que o endpoint que responde está indisponível para esta solicitação. Leia os detalhes do erro e o relatório oficial correspondente; isso não confirma, por si só, uma interrupção global.

Resposta rápida

Um 503 significa que o endpoint que responde está indisponível para esta solicitação. Leia os detalhes do erro e o relatório oficial correspondente; isso não confirma, por si só, uma interrupção global.

Diferenças entre provedores

OpenAI documenta respostas de sobrecarga 503, incluindo server_is_overloaded. Respeite Retry-After quando fornecido. Gemini identifica 503 UNAVAILABLE como erro transitório para o qual uma espera limitada pode ser adequada.

A API direta do Claude documenta 529 para sobrecarga. Um 503 observado por um gateway deve ser atribuído à camada que responde até haver mais evidências.

Resposta recomendada do aplicativo

Use espera exponencial com variação aleatória e limites explícitos de tentativas e tempo. Evite enviar a mesma solicitação que falhou em um ciclo rápido. Preserve um ID de solicitação e detalhes de resposta sem dados sensíveis para investigação.

Se considerar outro endpoint, verifique o modelo compatível, a autenticação, o tratamento de dados e a resposta real. Uma página de status normal é apenas uma evidência. O relatório de um roteador não estabelece a disponibilidade de todos os modelos a montante.

Páginas de serviços relacionados

Cada entrada mostra sua própria cobertura de coleta. Um serviço com link não é necessariamente coletado automaticamente.

A data de revisão editorial se aplica a este guia. As horas de coleta dos relatórios atuais aparecem nas páginas dos serviços.