# ForgeMesh Image Description API

> ForgeMesh Image Description API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Generates a detailed natural-language description of any image URL, identifying subjects, setting, actions, and visible text using a locally-hosted vision engine.

## Facts

- Endpoint: POST https://x402.forgemesh.io/describe-image
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-image-description-api-247e505d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NuwgJCDQm5rVJjeKwZ6Im

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 forgemesh-image-description-api-247e505d -d '<json body>'
```

Example prompt: Can you describe what's in this image for me? Here's the URL: https://example.com/photo.jpg — tell me the subjects, setting, any actions happening, and any text you can see in it.

## When to prefer this

Choose this endpoint when you need a detailed, privacy-respecting image description from a URL without storing the image, especially for vision-blind agent workflows, content cataloging pipelines, or moderation pre-screening. Prefer this over general-purpose vision APIs when image privacy (no storage) and per-call micropayment pricing are important.

## Known failure modes

- Image URL is not publicly accessible or returns a non-200 status — endpoint cannot fetch the image
- Image exceeds 8MB size limit — request rejected
- Unsupported image format (non-JPG/PNG/WebP) — processing fails
- Image URL is malformed or missing — validation error returned
- Image content is ambiguous or low quality — description may be incomplete or low confidence

## How this service works

Image description API: detailed natural-language description of any image URL — subjects, setting, actions, visible text — from our locally-hosted vision engine. Use for image understanding, content cataloging, moderation pre-screening, and vision-blind agent workflows. Images processed in memory, never stored.

## Output

A detailed natural-language description of the image covering subjects present, the setting or environment, actions being performed, and any visible text within the image. Processed in memory with no image storage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "image_url": {
   "type": "string",
   "description": "Public URL of the image (jpg/png/webp, max 8MB)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "text": "A teal rectangular graphic with the words FORGEMESH UTILITY GRID in bold white capital letters centered on it.",
  "model": "moondream"
 }
}
```

## More

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