{"uid":"cap_Ux-7Tgu5yx3fNlcclAZeq","slug":"forgemesh-x402-service-spec-b0a7691d","name":"ForgeMesh x402 Service Spec","description":"The exact call spec for one x402 service in the ForgeMesh fleet: routes, methods, prices, JSON input schemas, and worked examples, pulled from that service's own live API discovery surface. Pass `product` (id or name from fleet-products). Built for agents integrating a new paid tool without trial-and-error against its API.","url":"https://x402.forgemesh.io/x402-service-spec","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"product":{"type":"string","description":"Required: product id or name from fleet-products, e.g. \"imagegen\" or \"voice\""}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LmDHyYOg-1Fb3YTj-MT6a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the complete call specification for a single ForgeMesh x402 service: routes, HTTP methods, pricing, JSON input schemas, and worked examples, fetched live from that service's own API discovery surface.","exampleAgentPrompt":"Pull up the full call spec for the ForgeMesh 'imagegen' service — I need the routes, what JSON it expects, how much each call costs, and a worked example so I can integrate it without guessing.","exampleUseCases":null,"resultDescription":"A structured document containing the target ForgeMesh service's live API routes, accepted HTTP methods, per-route pricing in USDC, JSON input schemas for each route, and worked request/response examples — everything needed to call that service correctly on the first try.","failureModes":["Unknown product id or name returns an error indicating the product was not found in the ForgeMesh fleet","Missing required 'product' parameter returns a validation error","Service discovery surface for the requested product is temporarily unavailable, returning a 5xx error","Payment of $0.05 USDC not completed or rejected, returning a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when an agent needs to integrate a specific ForgeMesh x402 service and wants the authoritative, live-fetched call spec rather than cached or hand-written documentation. Prefer it over the fleet catalog endpoint when you already know which product you want and need deep per-route detail including schemas and examples, not just a high-level listing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:05:30.848Z","isFirstParty":false}