Erros

Solicitações com falha retornam JSON com um objeto error. O status HTTP é o primeiro sinal; os campos message e code nomeiam a falha real.

JSON

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

Códigos de status comuns

Estado	Causa típica
400	JSON inválido, campo não suportado ou endpoint errado para o modelo
401	Chave de API ausente ou inválida
403	A chave não pode usar este modelo ou grupo
404	Caminho desconhecido ou tarefa ausente
429	Limite de taxa
499	Cliente cancelou a solicitação
5xx	Falha no provedor de serviços ou gateway

Solicitações de imagem e vídeo enviadas para o protocolo errado retornam 400 com unsupported_endpoint e nomeiam a API necessária. A conversão silenciosa de protocolo é apenas para modelos de texto.

Diagnósticos mais longos, novas tentativas e substitutos pertencem aos artigos técnicos no site principal, começando com Solução de erros de API de IA.