Sign in
Image Understanding

Test endpoint for image analysis using Grok vision

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

post/image-understanding/test

Request body

imageUrlstring required

URL of the image to analyze

promptstring required

Text prompt/instruction for image analysis

systemPromptstring

Optional system prompt to guide the analysis

Example request

{
  "imageUrl": "https://example.com/image.jpg",
  "prompt": "Describe what you see in this image in detail",
  "systemPrompt": "You are an expert image analyst"
}

Response

Image analyzed successfully

resultstring required

The analysis result from Grok vision model

modelstring required

The model used for analysis

usageobject required

Token usage information

Example response

{
  "result": "This image shows a beautiful sunset over the ocean...",
  "model": "grok-4-fast-non-reasoning"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.