---
title: "Test endpoint for image analysis using Grok vision"
method: POST
path: "/image-understanding/test"
tags: ["Image Understanding"]
---

# Test endpoint for image analysis using Grok vision

`POST /image-understanding/test`

Analyzes an image from a URL using Grok vision model with a text prompt

## Request body

- AnalyzeImageRequestDto
  - `imageUrl` string, required — URL of the image to analyze
  - `prompt` string, required — Text prompt/instruction for image analysis
  - `systemPrompt` string — Optional system prompt to guide the analysis

## Response `200`

Image analyzed successfully

- AnalyzeImageResponseDto
  - `result` string, required — The analysis result from Grok vision model
  - `model` string, required — The model used for analysis
  - `usage` object, required — Token usage information

## Other responses

- `400` — Invalid request parameters
- `500` — Failed to analyze image

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)