$0.02 per plan, flat. No charge when nothing fits, or when planning is unavailable. Pay with x402 (USDC on Base or Solana), MPP on Tempo, or platform credits.
- URL:
POST https://compute.x402layer.cc/compute/flows/plan - Price: $0.02 per plan, flat
- No charge when nothing fits (
charged: false) or when planning is unavailable
Request
goal is required (3 to 600 characters). maxSteps is 1 to 5. budgetUsd only adds a warning when one run of the flow would cost more. networks keeps services payable on those networks.
Ways to pay (pick one per request)
With credits, send
Idempotency-Key: <your-id> so a retry of the same request is never charged twice.
Response
pick: null means no service does that step yet.
Running a step safely
- Call the step’s
urlwith itsmethod(useinputExampleas the body shape). It answers 402 with its own payment terms. - Pay only if those terms match the plan: the same
payTowhen one is listed inpay.options, and at mostpriceUsd. - Send the request again with the payment header.
Errors that matter
Free alternatives
GET https://studio.x402layer.cc/api/marketplace/plan?q=<goal>is a free keyword match over the Singularity Layer marketplace only (no model, no outside indexes).- Signed in on studio.x402layer.cc, the marketplace and the chat assistant include free daily plans.
MCP
The Singularity MCP has three tools for this:request_flow_plan_payment (the 402, free), plan_flow_with_payment (signed x402 payment) and plan_flow_with_credits (full-access Studio token or Cloud API key). See MCP Server.