Skip to main content
GET
Get workspace usage over time

인증

X-API-Key
string
header
필수

API key authentication. Generate an API key from your account settings at https://platform.comfy.org/profile/api-keys. Pass the key in the X-API-Key header.

쿼리 매개변수

group_by
enum<string>
기본값:model

How to group spend within each time bucket.

사용 가능한 옵션:
model,
endpoint,
product
granularity
enum<string>
기본값:month

Width of each time bucket.

사용 가능한 옵션:
hour,
day,
month
starting_on
string<date-time>

Start of the range, inclusive (RFC 3339). Overrides months when set.

ending_before
string<date-time>

End of the range, exclusive (RFC 3339). Defaults to the current hour.

months
integer
기본값:6

How many months back to report, counted from ending_before. Ignored when starting_on is set.

필수 범위: 1 <= x <= 24

응답

Success - Usage returned

Billed usage for one workspace over a time range.

group_by
enum<string>
필수

How spend was grouped, echoing the request.

사용 가능한 옵션:
model,
endpoint,
product
granularity
enum<string>
필수

Width of each bucket, echoing the request.

사용 가능한 옵션:
hour,
day,
month
starting_on
string<date-time>
필수

Start of the reported range, inclusive.

ending_before
string<date-time>
필수

End of the reported range, exclusive.

groups
string[]
필수

Every group key present in the range, ordered by total spend, highest first. Use it to keep series in a stable order across buckets.

buckets
object[]
필수

One entry per group per time bucket, oldest bucket first. A group with no spend in a bucket is omitted rather than reported as zero.

breakdown
object[]
필수

Total spend per group across the whole range.

summary
object
필수