BerriAI/litellm · error · ServiceUnavailableError

ServiceUnavailableError: {exception_provider} - {message}

Error message

ServiceUnavailableError: {exception_provider} - {message}

What it means

Error "ServiceUnavailableError: {exception_provider} - {message}" thrown in BerriAI/litellm.

Source

Thrown at litellm/litellm_core_utils/exception_mapping_utils.py:465

            )
        elif original_exception.status_code == 500:
            raise InternalServerError(
                message=f"InternalServerError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 502:
            raise BadGatewayError(
                message=f"BadGatewayError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 503:
            raise ServiceUnavailableError(
                message=f"ServiceUnavailableError: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                response=getattr(original_exception, "response", None),
                litellm_debug_info=extra_information,
            )
        elif original_exception.status_code == 504:  # gateway timeout error
            raise Timeout(
                message=f"Timeout Error: {exception_provider} - {message}",
                model=model,
                llm_provider=custom_llm_provider,
                litellm_debug_info=extra_information,
                exception_status_code=original_exception.status_code,
            )
        else:
            raise APIError(
                status_code=original_exception.status_code,
                message=f"APIError: {exception_provider} - {message}",

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Provider unavailable; retry later or configure fallbacks.

When it happens

Trigger: Thrown at litellm/litellm_core_utils/exception_mapping_utils.py:465 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@6c2dcb801b (2026-08-15). Data as JSON: /api/errors/d1284a4d739c97bc. Report an issue: GitHub.