---
title: "Estimate a workload as a percentage range"
method: POST
path: "/api/usage/estimate"
---

# Estimate a workload as a percentage range

`POST /api/usage/estimate`

## Request

- Base URL: `https://api.aetherya.ai`
- URL: `https://api.aetherya.ai/api/usage/estimate`
- Auth: HTTP bearer

Informational estimate only. Execution performs an authoritative server-side policy check.

## Headers

- `X-Aetherya-Workspace-Id` string

## Request body

- object
  - `service` string, required
  - `audienceSize` integer
  - `variants` integer
  - `browserMinutes` integer
  - `files` integer
  - `analysisDepth` integer

## Response `200`

Percentage estimate and policy guidance.

- object
  - `computeClass` 'light' | 'standard' | 'high' | 'extreme', required
  - `estimatedPercentMin` number, required
  - `estimatedPercentMax` number, required
  - `allowed` boolean, required
  - `limitingWindow` string, nullable
  - `canBuyCredits` boolean, required
  - `suggestions` string[], required

---

[API](https://skmtc.dev/aetherya/apis/aetherya-api.md) · [All operations](https://skmtc.dev/aetherya/apis/aetherya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aetherya/apis/aetherya-api/revisions/afa076131ee1?raw)