{"uid":"cap_D5vIU7YkRpKorVmV_efDO","slug":"inferrail-credits-purchase-via-x402-b7699e8c","name":"Inferrail Credits Purchase via x402","description":"Paid services for AI agents over x402 on Base and MPP on Tempo. Inferrail Web Read: one public web page as clean markdown, $0.002 per delivered page, refusals and target-site errors never charged, a retry never pays twice. Inferrail Hosted: one dollar budget shared by every agent and process using a workspace key (250 governed runs a month free, then $0.001/run in x402 credits).","url":"https://inferrail-cost-gateway.onrender.com/hosted/v1/credits/x402?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["workspace_id","governed_runs","status"],"properties":{"next":{"type":"string"},"status":{"enum":["settled"],"type":"string"},"payment_ref":{"type":"string"},"workspace_id":{"type":"string"},"governed_runs":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"next":"Credits are in GET https://inferrail-cost-gateway.onrender.com/hosted/v1/workspace.","status":"settled","payment_ref":"0xpayer:0xnonce","workspace_id":"ws_0123456789abcdef0123","governed_runs":1000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","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":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rbd9xhat9hpDoUt71xYkL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Purchase governed LLM-run credits for an Inferrail workspace using USDC payment over the x402 protocol, enforcing a shared budget across parallel agents","exampleAgentPrompt":"Top up my Inferrail workspace with a $1 USDC payment over x402 so my parallel agents have governed run credits and can't blow past the shared budget.","exampleUseCases":[{"title":"Multi-agent pipeline budget enforcement","prompt":"I'm running five parallel AI agents on Inferrail and I want them all to share a $1 budget — can you buy governed run credits via x402 USDC payment so they can't overspend?"},{"title":"Automated workspace credit refill","prompt":"My Inferrail workspace is running low on governed runs — top it up with a $1 USDC x402 payment and tell me how many runs I get back."},{"title":"First-time workspace funding","prompt":"I just created a new Inferrail workspace and need to fund it — pay $1 in USDC using x402 to buy governed LLM credits so my agents can start making calls."}],"resultDescription":"Returns a JSON object confirming payment settlement, including the workspace_id credited, the number of governed_runs added (e.g. 1000), a payment_ref identifying the on-chain transaction (payer address and nonce), a status of 'settled', and a 'next' hint pointing to GET /v1/workspace to verify the credit balance.","failureModes":["Payment not received or x402 header missing — results in 402 Payment Required with no credits allocated","Invalid or non-existent workspace_id — credits cannot be applied and request fails","Insufficient USDC balance in payer wallet — transaction not completed","Malformed request body (missing required fields: type, method, bodyType, body) — 400 Bad Request","Network or provider outage on Render-hosted service — 503 or timeout with no state change"],"whenToPreferThis":"Choose this endpoint when you need to pre-fund a shared LLM cost budget for a workspace where multiple parallel agents or processes must operate under a hard spending cap. It is the correct choice when paying with USDC via the x402 protocol for Inferrail governed runs, and when you want atomic budget reservation before each LLM provider call rather than post-hoc billing. Prefer over generic LLM API top-ups when cost governance across concurrent agents is the primary requirement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-03T00:38:29.410Z","isFirstParty":false,"canonicalSlug":"inferrail-credits-purchase-via-x402-b7699e8c"}