Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man image-description

/image-description

agentutility / wordmint / image-description
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
wordmint
CATEGORY
uncategorized
STATUS
live
NAME
image-description takes a public image url and returns an ai vision description, alt text, ocr text, tags, or caption depending on mode
synonym alias of describe-image — reuses the canonical handler.
SYNOPSIS
POST https://x402.agentutility.ai/image-description
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Takes a public image URL and returns an AI vision description, alt text, OCR text, tags, or caption depending on mode. Use it as an image description API, AI image captioner, or image-to-text endpoint.

INPUTrequest schema
propertytypedescriptionreq?
image_urlstringrequired
modestring
enum: describe · alt_text · ocr · tags · caption
optional
promptstringoptional
OUTPUTresponse shape
fieldtypedescription
textstring
modestring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/image-description \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the image-description tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
wordmintimagedescriptionimage-description
methods
POST
cluster
wordmint
price
$0.02 USDC per call
ADJACENTother endpoints in wordmint
endpointdescriptionprice
alt-text-generatorAlt text generator / accessibility image description API.$0.02
classifyZero-shot text classifier.$0.02
classify-textClassifies text into caller-supplied labels (2-25), with multi-label mode.$0.02
describe-imageDescribes images with a vision LLM across five modes: describe, alt_text (accessibility, <=125 chars), OCR (extract visible text), tags (…$0.02
detect-piiDetects PII in text: emails, phones, SSNs, credit cards, addresses, names, IPs, and API tokens.$0.02
email-draftWrites emails with AI: subject, body, salutation, and sign-off.$0.02
extractNamed entity extractor / NER.$0.02
image-describeReturns detailed image descriptions, short captions, alt text, OCR text, or tags from a public image URL.$0.02
SEE ALSO
agentutility · wordmint · x402 · mcp · llms.txt · registry.json · bazaar.x402.org