BerriAI/litellm · error · ValueError

Gemini image edit requires at least one image.

Error message

Gemini image edit requires at least one image.

What it means

Error "Gemini image edit requires at least one image." thrown in BerriAI/litellm.

Source

Thrown at litellm/llms/gemini/image_edit/transformation.py:96

        api_base: str | None,
        litellm_params: dict,
    ) -> str:
        base_url = api_base or get_secret_str("GEMINI_API_BASE") or self.DEFAULT_BASE_URL
        base_url = base_url.rstrip("/")
        return f"{base_url}/models/{model}:generateContent"

    def transform_image_edit_request(
        self,
        model: str,
        prompt: str | None,
        image: FileTypes | None,
        image_edit_optional_request_params: dict[str, Any],
        litellm_params: GenericLiteLLMParams,
        headers: dict,
    ) -> tuple[dict[str, Any], RequestFiles | None]:
        inline_parts: Final = self._prepare_inline_image_parts(image) if image else []
        if not inline_parts:
            raise ValueError("Gemini image edit requires at least one image.")

        # Build parts list with image and prompt (if provided)
        parts: Final = inline_parts.copy()
        if prompt is not None and prompt != "":
            parts.append({"text": prompt})

        contents: Final = [
            {
                "parts": parts,
            }
        ]

        request_body: Final[dict[str, Any]] = {"contents": contents}

        request_body["generationConfig"] = get_gemini_image_generation_config(
            model=model,
            optional_params=image_edit_optional_request_params,
        )

View on GitHub (pinned to 6c2dcb801b)

Solutions

1. Pass at least one image for the Gemini image edit request.

When it happens

Trigger: Thrown at litellm/llms/gemini/image_edit/transformation.py:96 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/fd62e452a16cbbab. Report an issue: GitHub.