BerriAI/litellm · error · ValueError

api_base is required for Azure AI MAI image generation

Error message

api_base is required for Azure AI MAI image generation

What it means

Error "api_base is required for Azure AI MAI image generation" thrown in BerriAI/litellm.

Source

Thrown at litellm/llms/azure_ai/image_generation/mai_transformation.py:29

from litellm.utils import convert_to_model_response_object

if TYPE_CHECKING:
    from litellm.litellm_core_utils.logging import Logging as LiteLLMLoggingObj


class AzureFoundryMAIImageGenerationConfig(BaseImageGenerationConfig):
    """Azure AI Foundry MAI image generation (e.g. MAI-Image-2.5)."""

    DEFAULT_WIDTH = 1024
    DEFAULT_HEIGHT = 1024

    @staticmethod
    def get_mai_image_generation_url(
        api_base: str | None,
        api_version: str | None,
    ) -> str:
        if api_base is None:
            raise ValueError("api_base is required for Azure AI MAI image generation")

        api_version = api_version or "preview"
        path, separator, query = api_base.partition("?")
        path = path.rstrip("/")

        if "/mai/" in path:
            prefix, _, _ = path.partition("/images/")
            path = f"{prefix}/images/generations"
        else:
            path = f"{path}/mai/v1/images/generations"

        if separator:
            return f"{path}?{query}"
        return f"{path}?api-version={api_version}"

    @staticmethod
    def get_mai_image_edit_url(
        api_base: str | None,

View on GitHub (pinned to 6c2dcb801b)

Solutions

  1. Pass api_base for the Azure AI MAI image generation call.

When it happens

Trigger: Thrown at litellm/llms/azure_ai/image_generation/mai_transformation.py:29 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/6457ae9c13fba55b. Report an issue: GitHub.