​

synth_ai.core.errors

Consolidated error types for Synth AI SDK. This module provides base exception classes used throughout the SDK. CLI-specific errors remain in cli/ modules; these are for SDK/core use.

​

Classes

​

SynthError

Base exception for all Synth AI SDK errors.

​

ConfigError

Raised when configuration is invalid or missing.

​

AuthenticationError

Raised when API authentication fails.

​

ValidationError

Raised when data validation fails.

​

HTTPError

Raised when an HTTP request fails.

​

JobError

Raised when a job operation fails.

​

TimeoutError

Raised when an operation times out.

​

StorageError

Raised when storage operations fail.

​

ModelNotSupportedError

Raised when a model is not supported.

​

UsageLimitError

Raised when an org rate limit is exceeded. Attributes:

• limit_type: The type of limit exceeded (e.g., “inference_tokens_per_day”)
• api: The API that hit the limit (e.g., “inference”, “judges”, “prompt_opt”)
• current: Current usage value
• limit: The limit value
• tier: The org’s tier (e.g., “free”, “starter”, “growth”)
• retry_after_seconds: Seconds until the limit resets (if available)
• upgrade_url: URL to upgrade tier