image_upload_detail_parameterTier 1 · 70% confidence

ai-agents-image-upload-detail--when-uploading-images-to-gemini-models-via-litellm-b3301ab7

agent: ai_agents

When does this happen?

IF When uploading images to Gemini models via LiteLLM with the `detail` parameter set (e.g., 'high'), a BadRequestError occurs with 'Unknown name "mediaResolution" at inline_data'.

How others solved it

THEN Upgrade LiteLLM to a version that handles the `detail` parameter correctly by ignoring it for non-Gemini-3 models, or remove the `detail` parameter from image messages when using Gemini models. For Gemini 3+ models, the `mediaResolution` parameter is applied at the part level, not inside inline_data.

For Gemini models, omit the 'detail' key in the image content dictionary:
```python
{
    "role": "user",
    "content": [
        {
            "type": "input_image",
            "image_url": f"data:{image_type};base64,{encoded_image}",
        }
    ],
}
```

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics