# ForgeMesh API Call Shapes Lookup

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

Returns the complete route definitions, input schemas, worked examples, and pricing for a named ForgeMesh x402 service so an agent can construct correct API calls without live probing.

## Facts

- Endpoint: POST https://x402.forgemesh.io/api-call-shapes
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-api-call-shapes-lookup-beea3f15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xqz5-zo76fqdDrxJt_-4o

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-api-call-shapes-lookup-beea3f15 -d '<json body>'
```

Example prompt: What are the exact routes, input schemas, and worked examples for the ForgeMesh 'imagegen' x402 service — I need to know how to call it correctly before making a live request.

## When to prefer this

Use this endpoint when an AI agent needs to introspect a ForgeMesh x402 service before calling it — to understand its routes, required parameters, and pricing without trial-and-error probing. Prefer this over generic API documentation lookups when the target service is a ForgeMesh x402 product specifically.

## Known failure modes

- Unrecognized product name/id — returns list of valid options instead of call shapes
- Missing required 'product' field — likely returns an error or empty response
- Product exists but has no documented call shapes yet — may return empty or partial data
- Network or payment failure — x402 payment of $0.05 USDC required per call

## How this service works

Returns the complete set of call shapes (routes, methods, input schemas, worked examples, prices) for a named ForgeMesh x402 service, so an agent can construct a correct request without probing the live API first. Required `product` — an id or name from fleet-products; unmatched values list the valid options.

## Output

A structured document containing all call shapes for the requested ForgeMesh product: the available routes, HTTP methods, input schemas with field descriptions, worked request/response examples, and per-call pricing. If the product name is unrecognized, the response lists the valid product options instead.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "product": {
   "type": "string",
   "description": "Required: product id or name from fleet-products, e.g. \"imagegen\" or \"voice\""
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "product": {
   "id": "imagegen",
   "host": "imagegen.coinopai.com",
   "name": "AI Image Generation",
   "summary": "Paid AI image generation via x402. Text-to-image, background removal, 4x HD upscaling.",
   "category": "media",
   "endpoints": [
    {
     "price": "$0.250000",
     "route": "/generate",
     "method": "GET",
     "example": null,
     "description": "Standard AI image generation. Requires x402 payment of 0.25 USDC on Base.",
     "input_schema": [
      {
       "in": "query",
       "name": "prompt",
       "schema": {
        "type": "string"
       },
       "required": true,
       "description": "Natural language image description"
      },
      {
       "in": "query",
       "name": "aspect",
       "schema": {
        "enum": [
         "1:1",
         "16:9",
         "9:16",
         "4:3"
        ],
        "type": "string",
        "default": "1:1"
       },
       "required": false,
       "description": "Aspect ratio"
      }
     ]
    }
   ],
   "price_range": {
    "max": 0.75,
    "min": 0.25
   },
   "route_count": 4
  },
  "generated_at": "2026-07-17T11:53:32.075Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-api-call-shapes-lookup-beea3f15/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)