Skip to main content
POST
/
v1
/
workspaces
/
{workspace_id}
/
workflows
/
{workflow_id}
/
estimate
Estimate workflow price
curl --request POST \
  --url https://api.app.layer.ai/api/v1/workspaces/{workspace_id}/workflows/{workflow_id}/estimate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": {}
}'
{
  "estimated_price_creative_units": 123,
  "output_counts": [
    {
      "output": {
        "name": "<string>",
        "type": "<string>",
        "description": "<string>",
        "value_schema": {},
        "display_name": "<string>"
      },
      "count": 123
    }
  ],
  "workspace_balance_creative_units": 123,
  "estimated_remaining_balance_creative_units": 123,
  "has_sufficient_creative_units": true
}

Authorizations

​
Authorization
string
header
required

Personal Access Token or OAuth2 JWT. Create a PAT at app.layer.ai → Settings → Personal Access Tokens.

Path Parameters

​
workspace_id
string<uuid>
required
​
workflow_id
string<uuid>
required

Body

application/json
​
inputs
Inputs · object
required

Workflow inputs matching the workflow's input schema.

Response

Successful Response

​
estimated_price_creative_units
number
required

Total estimated Creative Units price for this run.

​
output_counts
EstimateWorkflowOutputCount · object[]
required

Expected output count for each workflow output parameter.

​
workspace_balance_creative_units
number
required

Usable Creative Units balance (total balance minus reserved by in-progress generations).

​
estimated_remaining_balance_creative_units
number
required

Usable balance after subtracting the estimated price. Can be negative.

​
has_sufficient_creative_units
boolean
required

Whether the workspace has enough available Creative Units to cover the estimated price.