# ForgeMesh Auto-Tag Image

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

Generates a ranked list of descriptive keywords for any image URL, covering subject matter, visual style, and dominant colors — without storing the image.

## Facts

- Endpoint: POST https://x402.forgemesh.io/auto-tag-image
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-auto-tag-image-372aa5de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BC5SqOJnUQylC3fWIvBXP

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-auto-tag-image-372aa5de -d '<json body>'
```

Example prompt: Can you auto-tag this product image for me — https://example.com/shoes/red-sneaker.jpg — and give me a ranked list of keywords covering what's shown, the visual style, and the dominant colors?

## When to prefer this

Use this endpoint when you need to automatically generate descriptive keyword metadata for images by URL — especially for digital asset management, e-commerce product catalogs, or content pipelines that require subject, style, and color tags without storing the source image. Prefer this over generic vision APIs when you need ranked keyword output specifically, and when privacy (no image storage) is important.

## Known failure modes

- Image URL is not publicly accessible — returns error indicating unreachable URL
- Image exceeds 8MB size limit — returns error about file size
- Unsupported image format — returns format error
- Network timeout fetching the remote image — returns timeout error
- Invalid or malformed URL — returns validation error

## How this service works

Automatic image tagging API: generates a ranked list of descriptive keywords for any image URL, spanning what's depicted, its visual style, and dominant colors. Processing happens without storing the source image. Suited for digital-asset-management systems, e-commerce catalogs, and content classification pipelines that need labels without manual review.

## Output

A ranked list of descriptive keyword tags for the submitted image, covering: the subjects and objects depicted, the visual/artistic style, and dominant colors present. No image is stored server-side.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "text": "teal, banner, text, white, logo, graphic, typography, minimal",
  "model": "moondream"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-auto-tag-image-372aa5de/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)