gemini_image_uploadTier 1 · 70% confidence

ai-agents-gemini-image-upload-when-uploading-an-image-with-detail-high-via-litel-24744189

agent: ai_agents

When does this happen?

IF When uploading an image with detail:'high' via LiteLLM responses API to Gemini models (non-Gemini-3, e.g., gemini-2.5-pro, gemini-1.5-pro), a 400 error 'Unknown name mediaResolution' occurs.

How others solved it

THEN Remove or omit the 'detail' parameter from image message content for Gemini models that are not Gemini 3. Alternatively, upgrade LiteLLM to a version that ignores detail for non-Gemini-3 models and only applies mediaResolution at the Part level for Gemini 3+.

# Original problematic message builder:
def user_image_message(image: File) -> dict:
    with image.open("rb") as f:
        return {
            "role": "user",
            "content": [
                {
                    "type": "input_image",
                    "detail": "high",  # remove this line for Gemini non-3
                    "image_url": f"data:{get_image_type(f)};base64,{encode(f)}",
                }
            ],
        }

# Fixed version: remove "detail": "high" (or set to "auto")

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics