Analyze Image (Vision Helper)
vision_helper_analyze_imageAnalyze images with a vision model to get text descriptions, answer questions, or compare multiple images. Accepts URLs, file paths, data URIs, or base64.
Instructions
Analyze one or more images with a vision-capable model on OpenRouter and return the analysis as text. Use this whenever you need to know what is in an image but you cannot see it yourself.
Default mode is detailed and thorough (high reasoning effort, high-quality model, automatic retry and fallback). Pass quick: true for a fast, cheap answer (quick model, ~1024-token output, minimal reasoning) — e.g. a yes/no, a caption, or an object check.
Accepts an http(s) URL, local file path, file:// URI, data: URI, or raw base64 (PNG, JPEG, WebP, or GIF only); pass an array of up to 5 to compare images (state the comparison in the prompt). Long analyses are truncated at 25000 characters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | Yes | Image to analyze: URL, file path, data URI, raw base64, or an array of these. | |
| model | No | OpenRouter model ID, e.g. 'qwen/qwen3.8-max'. Defaults to OPENROUTER_MODEL, then a built-in default; see vision_helper_list_models for options. | |
| quick | No | Set true for a fast, cheap analysis: quick model (OPENROUTER_QUICK_MODEL), ~1024-token output, minimal reasoning. Good for yes/no checks, captions, object checks, or brief comparisons (up to 5 images). | |
| prompt | No | Optional instruction for the vision model, e.g. 'Transcribe all text in this screenshot'. When omitted, a general detailed description is used. | |
| max_tokens | No | Maximum number of tokens for the vision model's answer. | |
| temperature | No | Sampling temperature (0-2). Lower is more deterministic. |