# 2s Image Description API

> 2s Image Description API is a paid API for AI agents from 2s.io, paid per call via x402, $0.018/call, status unknown (last checked 2026-09-14).

Analyzes an image URL and returns a structured description including alt text, OCR text, object detection, dominant colors, and content type classification.

## Facts

- Endpoint: POST https://2s.io/api/ai/describe-image
- Price: $0.018/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-image-description-api-ac84bf8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ckqLbVAcT4HnYkBdZ9zMz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-image-description-api-ac84bf8f -d '<json body>'
```

Example prompt: Can you describe this image for me — https://example.com/chart.png — and focus on the chart axes and labels? I need the alt text, any visible text, and the main objects you can see.

## When to prefer this

Use this endpoint when you need structured, multi-faceted image analysis in a single call — especially when you need OCR text, object detection, accessibility alt text, color palette, and content type classification all at once without managing separate vision APIs or API keys. Ideal for AI agents that need to understand image content on demand, pay per use, with no subscription overhead.

## Known failure modes

- Image URL unreachable or returns non-200 — endpoint may return an error or empty result
- Image exceeds 1MB size limit — likely rejected or truncated
- Non-HTTPS URL provided — schema requires HTTPS
- Unsupported image format (not JPEG/PNG/GIF/WebP) — may fail or return degraded results
- Image contains no text — text field returns empty string, not an error
- Payment not included or insufficient — 402 response requiring x402 USDC payment on Base or Solana

## How this service works

The (most) everything API: 575+ pay-per-call endpoints for AI agents — ground-truth data, a full AI gateway, and agent infrastructure (storage, queues, watchers). USDC via x402, no signup, no API keys, and upto billing: pay actual usage, not the quote.

## Output

Returns a structured object with: a short accessibility alt text (5-15 words), a 2-3 sentence description, verbatim OCR text (empty string if none), a content type classification (photograph/illustration/screenshot/diagram/document/mixed/other), a list of salient objects/subjects, and hex codes for dominant colors. Also includes provider metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "imageUrl": {
   "type": "string",
   "maxLength": 2048,
   "description": "HTTPS URL of a JPEG, PNG, GIF, or WebP image (≤1MB)."
  },
  "instruction": {
   "type": "string",
   "maxLength": 1000,
   "description": "Optional caller-supplied focus hint, e.g. \"describe the chart axes\"."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-image-description-api-ac84bf8f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)