Skip to main content
GET
Return caller-owned evaluation runtime and LLM usage.
Returns the evaluation runtime and LLM usage shown in the Droyd Usage view. The default period is the 30 days ending when the request is made. Use competition_id to filter evaluation and inference usage, or model to filter inference usage. The response includes the competitions and models used in the selected period for building filter controls. Set bucket=hour for an hourly series or bucket=day for a daily series; day is the default. Evaluation usage records CPU, memory, and GPU device time consumed in Droyd sandboxes, plus calculated Droyd sandbox runtime cost. GPU time and cost are aggregated across chip types. unavailable_runs identifies sandbox runs whose cost could not be calculated completely.

Authorizations

Authorization
string
header
required

A Droyd API key in the Authorization Bearer slot.

Query Parameters

bucket
enum<string>
default:day
Available options:
hour,
day
competition_id
string<uuid>
model
string
from
string<date-time>
to
string<date-time>

Response

Successful response.

ok
any
required