# ForgeMesh Image Tagging API

> ForgeMesh Image Tagging API 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-14).

Generates 5–15 keyword tags (subjects, style, colors, setting) for any image URL using a locally-hosted vision engine

## Facts

- Endpoint: POST https://x402.forgemesh.io/image-tags
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-image-tagging-api-9a46dfae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3onaPeHC0OjmRVlURtbn0

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-tagging-api-9a46dfae -d '<json body>'
```

Example prompt: Can you tag this product photo for me? Here's the URL: https://example.com/product123.jpg — I need keyword tags covering what's in the image, the colors, style, and setting so I can index it in our catalog.

## When to prefer this

Use this endpoint when you need fast, affordable ($0.005 per call) keyword tag extraction from image URLs for media libraries, product catalogs, or search indexing workflows. Prefer it when no image retention is a requirement and when you need structured multi-dimensional tags covering subjects, colors, style, and setting from a single API call.

## Known failure modes

- Image URL is not publicly accessible — returns an error or empty tags
- Image exceeds 8MB size limit — request rejected
- Invalid or malformed image URL — parsing error returned
- Image format not supported by vision engine — processing failure
- Network timeout fetching the remote image URL — retry suggested

## How this service works

Image tagging API: 5-15 keyword tags (subjects, style, colors, setting) for any image URL from our locally-hosted vision engine. Use for media libraries, search indexing, product cataloging, and content classification agents. No image retention.

## Output

A set of 5–15 keyword tags describing the image's subjects, visual style, dominant colors, and setting — ready for use in search indexing, media library organization, or product classification. No image data is retained after processing.

## 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-image-tagging-api-9a46dfae/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)