Search the documentation

Pick a page and open it with Enter.

Vision

Look at images by address (JSON).

POST/api/v1/vision

Look at images by address — URL, local file path, or data URL, mixed freely. Nothing is stored; for a URL the model fetches it itself, otherwise we embed the image inline.

Parameters

imagesstring[] · 1–600required

Image addresses as URL, path, or data URL.

questionstring | null · ≤8000

Optional question about the image.

detail"low" | "high" | "original" | "auto" | null

Level of detail for the description.

Example request

json
{
  "images": ["https://storage.smeeware.com/llm/diagramme/umsatz.png"],
  "question": "What values are on the Y axis?",
  "detail": "high"
}

Response

json
{
  "answer": "The Y axis is scaled in thousands of euros, from 0 to 120 in steps of 20.",
  "model": "deepseek-v4-flash-vision-exp",
  "images": [
    {
      "source": "https://storage.smeeware.com/llm/diagramme/umsatz.png",
      "media_type": "image/png",
      "bytes": 0,
      "inlined": false
    }
  ]
}

inlined=false = the model fetched the URL itself (bytes is then 0). For a path or data URL we load the image and embed it → inlined=true with a real byte count.

200

Description generated.

422

Empty or corrupt image file.