Skip to main content
POST
Estimate node credits
Returns a per-node microcredit estimate for an array of node configurations. Useful for surfacing live pricing in a UI (canvas card, playground form) before the user kicks off a run.
Pricing uses the same rules as run-time billing, without starting a run or charging credits. For output-dependent models, final usage can differ from the estimate.
Build each node’s input from its model schema. Read model pricing for the billing basis, applicable units, and estimate limitations before treating a quote as a budget. If a type does not match a known node type, the estimate for that item is 0 and the server logs the unknown type. Use GET /v1/models to preflight valid identifiers.

Authorizations

string
required
Bearer API key. Format: Bearer gx_your_api_key.

Body

array
required
Array of node configurations to estimate. Max 100 entries.

Response

array
One entry per request node, in input order.

Request

Response example

Errors

Unknown type values do not return 400; they produce a 0 microcredit estimate for that item. Validation errors from this endpoint use a compact response body: