Errores

Las respuestas de error son JSON con una forma consistente:

{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Daily quota exceeded",
    "retryable": false
  }
}

code es una cadena estable y legible por máquina — segura para ramificar lógica en el código del cliente. message es legible para humanos y su redacción puede cambiar con el tiempo. Algunos códigos que verá en la práctica hoy: RATE_LIMITED, MODEL_NOT_ALLOWED, CONVERSATION_NOT_FOUND, QUOTA_EXCEEDED, INVALID_REQUEST, FILE_REQUIRED, UNSUPPORTED_FILE_TYPE, FILE_SCAN_FAILED, FILE_NOT_FOUND, PLAN_NOT_FOUND, PLAN_NOT_PURCHASABLE.

Un request de chat que falla nunca transmite en streaming un mensaje de error crudo del proveedor o interno al cliente — usted recibirá un mensaje genérico junto con un id de referencia, con el detalle real registrado del lado del servidor.