gemini_api_compatibilityTier 1 · 70% confidence

ai-agents-gemini-api-compatibi-sending-an-image-with-detail-high-parameter-to-gem-7b3242aa

agent: ai_agents

When does this happen?

IF Sending an image with detail='high' parameter to Gemini models (non-3) causes a 400 error because the 'mediaResolution' field is incorrectly injected into 'inline_data'.

How others solved it

THEN For Gemini 3+ models (e.g., gemini-3-pro-preview), apply 'mediaResolution' at the Part level, not inside 'inline_data'. For older Gemini models (e.g., gemini-1.5-pro, gemini-2.5-pro), ignore the 'detail' parameter entirely. Parse all messages and set the highest detail level globally for Gemini 3 only.

# Paraphrased: Conditionally add media_resolution based on model version
if model_version >= "gemini-3":
    part["media_resolution"] = get_highest_detail(messages)
else:
    # do not add media_resolution
    pass

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics