BerriAI/litellm · error · ValueError

ElevenLabs API key is required. Set ELEVENLABS_API_KEY envir

Error message

ElevenLabs API key is required. Set ELEVENLABS_API_KEY environment variable.

What it means

Error "ElevenLabs API key is required. Set ELEVENLABS_API_KEY environment variable." thrown in BerriAI/litellm.

Source

Thrown at litellm/llms/elevenlabs/text_to_speech/transformation.py:179

            remaining_params=params,
        )

        return mapped_voice, mapped_params

    def validate_environment(
        self,
        headers: dict,
        model: str,
        api_key: str | None = None,
        api_base: str | None = None,
    ) -> dict:
        """
        Validate Azure environment and set up authentication headers
        """
        api_key = api_key or litellm.api_key or litellm.openai_key or get_secret_str("ELEVENLABS_API_KEY")

        if api_key is None:
            raise ValueError("ElevenLabs API key is required. Set ELEVENLABS_API_KEY environment variable.")

        headers.update(
            {
                "xi-api-key": api_key,
                "Content-Type": "application/json",
            }
        )

        return headers

    def get_error_class(self, error_message: str, status_code: int, headers: dict | Headers) -> BaseLLMException:
        return ElevenLabsException(message=error_message, status_code=status_code, headers=headers)

    def transform_text_to_speech_request(
        self,
        model: str,
        input: str,
        voice: str | None,

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Set ELEVENLABS_API_KEY in the environment.

When it happens

Trigger: Thrown at litellm/llms/elevenlabs/text_to_speech/transformation.py:179 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/821cf0a4fcfaf01a. Report an issue: GitHub.