Describe or summarize an image with multimodal AI.
Accepts an image (either by URL or base64 payload) and optional instructions, then runs it through the configured multimodal model. Useful for auto-captioning screenshots, validating mockups, or asking follow-up questions about a visual.
/ai/interpretWhere this helper shines
Describe or summarize an image with multimodal AI. keeps ai helpers on autopilot. Use it whenever you need to describe or summarize an image with multimodal AI without pausing a sprint or asking design/dev to jump in.
- Trigger this helper whenever you need to describe or summarize an image with multimodal AI without waiting on a full deploy.
- Drop it into automations (Zapier, Make, workers) to describe or summarize an image with multimodal AI as part of your workflow.
- Share the GET URL so support and success can describe or summarize an image with multimodal AI safely using their Dataczar API key.
Copy & ship snippets
GET
Instant link
GET https://api.dataczar.app/ai/interpret?image_url=https%3A%2F%2Fexample.com%2Fdemo.png&prompt=sample-prompt&model=sample-model&ak=demoOpen directly in any browser, webhook, or low-code workflow.
curl
curl GET
curl "https://api.dataczar.app/ai/interpret?image_url=https%3A%2F%2Fexample.com%2Fdemo.png&prompt=sample-prompt&model=sample-model&ak=demo"Swap ak=demo with your Dataczar API key.
curl
curl POST
curl -X POST "https://api.dataczar.app/ai/interpret?ak=demo" \
-H 'Content-Type: application/json' \
-d '{
"prompt": "sample_prompt",
"model": "sample_model",
"temperature": 30,
"image_base64": "sample_image_base64",
"image_url": "https://example.com/demo.png",
"image_mime_type": "sample_image_mime_type",
"top_p": 70,
"max_tokens": 80,
"seed": 90,
"vision_temperature": 100,
"options": "sample_options"
}'Send JSON payloads from back-end jobs, queues, or workers.
Parameters
Query Parameters
| Name | Type | Description |
|---|---|---|
| image_url | string | Publicly accessible URL to the image to inspect (use POST for base64 payloads). |
| prompt | string | Optional instruction, e.g., "List every button label". |
| model | string | Defaults to the AI text model (gpt-4o-mini). |
All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.
Responses
Status 200
Interpretation succeeded.
{
"ok": true,
"status": 200,
"prompt": "Identify the KPIs in this dashboard",
"model": "gpt-4o-mini",
"result": {
"provider": "openai",
"text": "The dashboard highlights three KPIs: total signups, weekly email sends, and helper invocations...",
"usage": {
"prompt_tokens": 120,
"completion_tokens": 75,
"total_tokens": 195
},
"id": "chatcmpl-abc123"
}
}Examples
Request
"GET /ai/interpret?image_url=https%3A%2F%2Fdataczar-public.s3.amazonaws.com%2Fscreenshots%2Fdashboard.png&prompt=List%20each%20chart&ak=demo"Response
{
"ok": true,
"prompt": "List each chart",
"model": "gpt-4o-mini",
"result": {
"provider": "mock",
"text": "[mock vision] described https://dataczar-public... with instructions",
"id": "mock-vision"
},
"status": 200
}Request
"POST /ai/interpret {\"image_base64\":\"iVBORw0K...\",\"prompt\":\"Summarize the screenshot\"}"Response
{
"ok": true,
"prompt": "Summarize the screenshot",
"model": "gpt-4o-mini",
"result": {
"provider": "mock",
"text": "[mock vision] described inline image with instructions",
"id": "mock-vision"
},
"status": 200
}Test Contracts
[
{
"name": "interpret_with_url",
"method": "GET",
"params": {
"image_url": "https://dataczar-public.s3.amazonaws.com/examples/demo.png"
},
"expect": {
"ok": true
}
}
]Grab your Dataczar API key
Every helper runs with the same simple API key. Sign in (or create a free Dataczar account) at Dataczar Connect to issue keys in seconds, then drop the key into any `ak=` parameter and start shipping.
Tip: reuse the same key across these helpers, or rotate keys per project from the Connect dashboard.