Skip to main content
GET
/
v1
/
usage
Aggregated usage metrics
curl --request GET \
  --url https://api.aurous-labs.com/v1/usage \
  --header 'X-Api-Key: <api-key>'
{
  "object": "list",
  "data": [
    {
      "object": "usage.bucket",
      "bucket_start": "2026-05-07T00:00:00Z",
      "bucket_end": "2026-05-08T00:00:00Z",
      "groups": [
        {
          "key": {
            "status": "completed",
            "api_key_id": "key_01HVABCDEFGHJKMNPQRSTVWXYZ"
          },
          "metrics": {
            "request_count": 142,
            "successful_count": 142,
            "failed_count": 0,
            "cancelled_count": 0,
            "credits_used": 14.12,
            "duration_ms_p50": 1820,
            "duration_ms_p95": 4310,
            "image_count": 142,
            "video_seconds": 0
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.aurous-labs.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Your team API key (starts with al_live_).

Headers

​
Aurous-Version
string

Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-05-15 for unauthenticated requests.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-05-15"

Query Parameters

​
start_time
string
required

Inclusive lower bound (RFC 3339).

Example:

"2026-04-08T00:00:00Z"

​
end_time
string

Exclusive upper bound. Defaults to now.

Example:

"2026-05-08T00:00:00Z"

​
bucket_width
enum<string>

Bucket size. Default 1d. Each width has a max range cap.

Available options:
1m,
5m,
15m,
1h,
1d,
7d
​
group_by
enum<string>[]

Optional grouping dims (max 2).

Available options:
status,
api_key_id,
user_id,
type
​
status
string[]

Filter by status. Comma-separated or repeated.

​
type
string[]

Filter by inference type. Comma-separated or repeated.

​
api_key_id
string[]

Filter by opaque API-key id (key_).

​
user_id
string[]

Filter by opaque user id (usr_).

​
lora_id
string[]

Filter by opaque LoRA id (lora_).

​
character_id
string

Single character filter (char_).

Example:

"char_01HVABCDEFGHJKMNPQRSTVWXYZ"

​
limit
number

Items per page (1-100, default 24).

Required range: 1 <= x <= 100
Example:

24

​
page_token
string

Opaque cursor returned in next_page from a prior call. 24h TTL.

Example:

"eyJ2IjoxLCJxZiI6Ii4uLiJ9"

Response

Usage aggregates (newest first).

​
object
enum<string>
required

Discriminator

Available options:
list
Example:

"list"

​
data
object[]
required

Buckets in bucket_start DESC order.

​
has_more
boolean
required

True when more buckets exist beyond this page.

Example:

false

​
next_page
object
required

Pass as ?page_token=<token> on the next request. Opaque base64; tied to the original query fingerprint. Null when has_more=false. 24h expiry.

Example:

null