BerriAI/litellm · error · PangeaGuardrailMissingSecrets

Pangea API Key not found. Set PANGEA_API_KEY environment var

Error message

Pangea API Key not found. Set PANGEA_API_KEY environment variable or pass it in litellm_params.

What it means

Error "Pangea API Key not found. Set PANGEA_API_KEY environment variable or pass it in litellm_params." thrown in BerriAI/litellm.

Source

Thrown at litellm/proxy/guardrails/guardrail_hooks/pangea/pangea.py:81

        pangea_output_recipe: str | None = None,
        api_key: str | None = None,
        api_base: str | None = None,
        **kwargs,
    ):
        """
        Initializes the PangeaHandler.

        Args:
            guardrail_name (str): The name of the guardrail instance.
            pangea_recipe (str): The Pangea recipe key to use for scanning.
            api_key (Optional[str]): The Pangea API key. Reads from PANGEA_API_KEY env var if None.
            api_base (Optional[str]): The Pangea API base URL. Reads from PANGEA_API_BASE env var or uses default if None.
            **kwargs: Additional arguments passed to the CustomGuardrail base class.
        """
        self.async_handler = get_async_httpx_client(llm_provider=httpxSpecialProvider.GuardrailCallback)
        self.api_key = api_key or os.environ.get("PANGEA_API_KEY")
        if not self.api_key:
            raise PangeaGuardrailMissingSecrets(
                "Pangea API Key not found. Set PANGEA_API_KEY environment variable or pass it in litellm_params."
            )

        # Default Pangea base URL if not provided
        self.api_base = api_base or os.environ.get("PANGEA_API_BASE") or "https://ai-guard.aws.us.pangea.cloud"
        self.pangea_input_recipe = pangea_input_recipe
        self.pangea_output_recipe = pangea_output_recipe

        # Pass relevant kwargs to the parent class
        super().__init__(
            guardrail_name=guardrail_name,
            supported_event_hooks=list(self.get_supported_event_hooks()),
            **kwargs,
        )
        verbose_proxy_logger.debug(
            "Initialized Pangea Guardrail: name=%s, recipe=%s, api_base=%s",
            guardrail_name,
            pangea_input_recipe,

View on GitHub (pinned to 77b7c6c40c)

Solutions

1. Set the PANGEA_API_KEY environment variable.
2. Or pass api_key in the pangea guardrail's litellm_params.
3. Verify the key is valid in the Pangea console.

When it happens

Trigger: Thrown at litellm/proxy/guardrails/guardrail_hooks/pangea/pangea.py:81 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of BerriAI/litellm@77b7c6c40c (2026-08-18). Data as JSON: /api/errors/f9f91cd80af34fce. Report an issue: GitHub.