---
title: "IMAGE DESCRIPTION (vision AI) — POST {url} or {image_base64} and get back what is IN the image"
method: POST
path: "/api/describe-image"
tags: ["AI Utilities"]
---

# IMAGE DESCRIPTION (vision AI) — POST {url} or {image_base64} and get back what is IN the image

`POST /api/describe-image`

## Request

- Base URL: `https://api.webbersites.com`
- URL: `https://api.webbersites.com/api/describe-image`
- Auth: API key in header `X-PAYMENT`

IMAGE DESCRIPTION (vision AI) — POST {url} or {image_base64} and get back what is IN the image: a detailed description, notable objects, visible text transcribed, colors, and style. Or ask a specific {question} about the image ('what error is on this screen?'). PNG/JPEG/GIF/WebP up to 5 MB. For agents without eyes: alt text, screenshot triage, image search and moderation. Fast vision model; the x402 payment IS the auth.

Price: $0.02 per call, paid in USDC via the x402 protocol (see the x402 security scheme).

## Request body

- object
  - `url` string: Public http(s) URL of the image (png, jpeg, gif, webp; max 5 MB)
  - `image_base64` string: Alternative to url: the image as base64 (data URI accepted)
  - `question` string: Optional specific question about the image, up to 500 chars — replaces the default full description

## Response `200`

Success

- object
  - `description` string: the answer — full description, or the answer to your question
  - `content_type` string
  - `input_bytes` number
  - `model` string
  - `usage` object

## Other responses

- `402`: Payment required — the response body lists accepted payment methods (amount, asset, network, pay-to address). Retry the request with a signed X-PAYMENT header.

---

[API](https://skmtc.dev/webbersites/apis/webbersites-x402-data-api.md) · [All operations](https://skmtc.dev/webbersites/apis/webbersites-x402-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/webbersites/apis/webbersites-x402-data-api/revisions/c14a76c67a94?raw)