BerriAI/litellm · error · AuthenticationError

HuggingfaceException - {original_exception.message}

Error message

HuggingfaceException - {original_exception.message}

What it means

Error "HuggingfaceException - {original_exception.message}" thrown in BerriAI/litellm.

Source

Thrown at litellm/litellm_core_utils/exception_mapping_utils.py:1450

            response=getattr(original_exception, "response", None),
        )
    elif "A valid user token is required" in error_str:
        raise BadRequestError(
            message=error_str,
            llm_provider="huggingface",
            model=model,
            response=getattr(original_exception, "response", None),
        )
    elif "Rate limit reached" in error_str:
        raise RateLimitError(
            message=error_str,
            llm_provider="huggingface",
            model=model,
            response=getattr(original_exception, "response", None),
        )
    if hasattr(original_exception, "status_code"):
        if original_exception.status_code == 401:
            raise AuthenticationError(
                message=f"HuggingfaceException - {original_exception.message}",
                llm_provider="huggingface",
                model=model,
                response=getattr(original_exception, "response", None),
            )
        elif original_exception.status_code == 400:
            raise BadRequestError(
                message=f"HuggingfaceException - {original_exception.message}",
                model=model,
                llm_provider="huggingface",
                response=getattr(original_exception, "response", None),
            )
        elif original_exception.status_code == 408:
            raise Timeout(
                message=f"HuggingfaceException - {original_exception.message}",
                model=model,
                llm_provider="huggingface",
            )

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Inspect the HuggingFace error message; check model id, task, and inputs.

When it happens

Trigger: Thrown at litellm/litellm_core_utils/exception_mapping_utils.py:1450 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/c950ed1f7af4f4cf. Report an issue: GitHub.