Errores

Las solicitudes fallidas devuelven JSON con un objeto error. El estado HTTP es la primera señal; los campos message y code nombran la falla real.

JSON

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

Códigos de estado comunes

Estado	Causa típica
400	JSON no válido, campo no admitido o punto final incorrecto para el modelo
401	Clave API faltante o no válida
403	La llave no puede utilizar este modelo o grupo
404	Ruta desconocida o tarea faltante
429	Límite de tarifa
499	Cliente canceló la solicitud
5xx	Fallo del proveedor de servicios o gateway

Las solicitudes de imágenes y videos enviadas al protocolo incorrecto devuelven 400 con unsupported_endpoint y nombran la API requerida. La conversión de protocolo silenciosa es sólo para modelos de texto.

Los diagnósticos, reintentos y alternativas más extensos pertenecen a los artículos técnicos del sitio principal, comenzando con Solución de problemas de errores de API AI.