Skip to content

Exception Handling

AnyLLMError

Bases: Exception

Base exception for all any-llm errors.

All custom exceptions in any-llm inherit from this class. It preserves the original exception for debugging while providing a unified interface.

Attributes:

Name Type Description
message

Human-readable error message
original_exception

The original SDK exception that triggered this error
provider_name

Name of the provider that raised the error (if available)
Source code in src/any_llm/exceptions.py 
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
class AnyLLMError(Exception):
    """Base exception for all any-llm errors.

    All custom exceptions in any-llm inherit from this class. It preserves
    the original exception for debugging while providing a unified interface.

    Attributes:
        message: Human-readable error message
        original_exception: The original SDK exception that triggered this error
        provider_name: Name of the provider that raised the error (if available)

    """

    default_message: str = "An error occurred"

    def __init__(
        self,
        message: str | None = None,
        original_exception: Exception | None = None,
        provider_name: str | None = None,
    ) -> None:
        self.message = message or self.default_message
        super().__init__(self.message)
        self.original_exception = original_exception
        self.provider_name = provider_name

    def __str__(self) -> str:
        """Return string representation of the exception."""
        if self.provider_name:
            return f"[{self.provider_name}] {self.message}"
        return self.message

__str__()

Return string representation of the exception.

Source code in src/any_llm/exceptions.py 
31
32
33
34
35
def __str__(self) -> str:
    """Return string representation of the exception."""
    if self.provider_name:
        return f"[{self.provider_name}] {self.message}"
    return self.message

AuthenticationError

Bases: AnyLLMError

Raised when authentication with the provider fails.

Source code in src/any_llm/exceptions.py 
44
45
46
47
class AuthenticationError(AnyLLMError):
    """Raised when authentication with the provider fails."""

    default_message = "Authentication failed"

ContentFilterError

Bases: AnyLLMError

Raised when content is blocked by the provider's safety filter.

Source code in src/any_llm/exceptions.py 
62
63
64
65
class ContentFilterError(AnyLLMError):
    """Raised when content is blocked by the provider's safety filter."""

    default_message = "Content blocked by safety filter"

ContextLengthExceededError

Bases: AnyLLMError

Raised when the input exceeds the model's maximum context length.

Source code in src/any_llm/exceptions.py 
74
75
76
77
class ContextLengthExceededError(AnyLLMError):
    """Raised when the input exceeds the model's maximum context length."""

    default_message = "Context length exceeded"

InvalidRequestError

Bases: AnyLLMError

Raised when the request to the provider is invalid.

Source code in src/any_llm/exceptions.py 
50
51
52
53
class InvalidRequestError(AnyLLMError):
    """Raised when the request to the provider is invalid."""

    default_message = "Invalid request"

MissingApiKeyError

Bases: AnyLLMError

Raised when a required API key is not provided.

Source code in src/any_llm/exceptions.py 
80
81
82
83
84
85
86
87
88
89
90
91
class MissingApiKeyError(AnyLLMError):
    """Raised when a required API key is not provided."""

    def __init__(self, provider_name: str, env_var_name: str) -> None:
        self.env_var_name = env_var_name

        message = (
            f"No {provider_name} API key provided. "
            f"Please provide it in the config or set the {env_var_name} environment variable."
        )

        super().__init__(message, provider_name=provider_name)

ModelNotFoundError

Bases: AnyLLMError

Raised when the requested model is not found or not available.

Source code in src/any_llm/exceptions.py 
68
69
70
71
class ModelNotFoundError(AnyLLMError):
    """Raised when the requested model is not found or not available."""

    default_message = "Model not found"

ProviderError

Bases: AnyLLMError

Raised when the provider encounters an internal error.

Source code in src/any_llm/exceptions.py 
56
57
58
59
class ProviderError(AnyLLMError):
    """Raised when the provider encounters an internal error."""

    default_message = "Provider error"

RateLimitError

Bases: AnyLLMError

Raised when the API rate limit is exceeded.

Source code in src/any_llm/exceptions.py 
38
39
40
41
class RateLimitError(AnyLLMError):
    """Raised when the API rate limit is exceeded."""

    default_message = "Rate limit exceeded"

UnsupportedParameterError

Bases: AnyLLMError

Raised when a parameter is not supported by the provider.

Source code in src/any_llm/exceptions.py 
106
107
108
109
110
111
112
113
114
115
116
class UnsupportedParameterError(AnyLLMError):
    """Raised when a parameter is not supported by the provider."""

    def __init__(self, parameter_name: str, provider_name: str, additional_message: str | None = None) -> None:
        self.parameter_name = parameter_name

        message = f"'{parameter_name}' is not supported for {provider_name}"
        if additional_message is not None:
            message = f"{message}.\n{additional_message}"

        super().__init__(message, provider_name=provider_name)

UnsupportedProviderError

Bases: AnyLLMError

Raised when an unsupported provider is specified.

Source code in src/any_llm/exceptions.py 
 94
 95
 96
 97
 98
 99
100
101
102
103
class UnsupportedProviderError(AnyLLMError):
    """Raised when an unsupported provider is specified."""

    def __init__(self, provider_key: str, supported_providers: list[str]) -> None:
        self.provider_key = provider_key
        self.supported_providers = supported_providers

        message = f"'{provider_key}' is not a supported provider. Supported providers: {', '.join(supported_providers)}"

        super().__init__(message)