Skip to main content
POST
/
v1
/
image
/
describe
Describe an image using AI vision
curl --request POST \
  --url https://api.urltodata.ai/v1/image/describe \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>"
}
'
{
  "subject": "<unknown>",
  "constraints": {
    "must_keep": [
      "<string>"
    ],
    "avoid": [
      "<string>"
    ]
  },
  "negative_prompt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.urltodata.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
default:your-api-key
required

API key as Bearer token (e.g. Bearer mp_abc123_secret)

Body

url
string<uri>
required

Image URL

prompt
string

Custom prompt for description

maxResolution
integer

Max image resolution

Required range: 64 <= x <= 2048

Response

Image description

subject
any

Primary subject of the image (string or structured object)

constraints
object
negative_prompt
string