Error Handling

The SDK provides typed exceptions for different error scenarios.

Exception Hierarchy

QualiaError
└── QualiaAPIError
    ├── AuthenticationError
    ├── NotFoundError
    ├── ValidationError
    └── RateLimitError

Usage

from qualia import (
    Qualia,
    QualiaError,
    QualiaAPIError,
    AuthenticationError,
    NotFoundError,
    ValidationError,
    RateLimitError,
)

try:
    client = Qualia(api_key="invalid-key")
    client.models.list()
except AuthenticationError as e:
    print(f"Auth failed: {e}")
except NotFoundError as e:
    print(f"Not found: {e}")
except ValidationError as e:
    print(f"Validation error: {e}")
except RateLimitError as e:
    print(f"Rate limited. Retry after: {e.retry_after}s")
except QualiaAPIError as e:
    print(f"API error [{e.status_code}]: {e.message}")
except QualiaError as e:
    print(f"SDK error: {e}")

Exception Details

Exception	Description
QualiaError	Base exception for all SDK errors
QualiaAPIError	API returned an error response
AuthenticationError	Invalid or missing API key
NotFoundError	Requested resource doesn’t exist
ValidationError	Invalid request parameters
RateLimitError	Too many requests, includes retry_after