Skip to main content
Enterprise API

Usage and billing

Usage analytics per model and API key, and invoice billing.

#Usage analytics

GET /models/usage returns analytics for dashboards and monitoring: the completed generations of the account the API key belongs to and their estimated cost in USD, grouped by time bucket and model.

Warning

Usage analytics is not a billing record. Data can lag behind real time and may not include every request, so totals can differ from your invoice. Use your invoices for reconciliation, and a request's status endpoint for a single request.

bash
curl --get \
  --url https://api.higgsfield.ai/models/usage \
  --header "Authorization: Key ${HF_API_KEY_ID}:${HF_API_KEY_SECRET}" \
  --data-urlencode "start=2026-10-01T00:00:00Z" \
  --data-urlencode "end=2026-10-24T00:00:00Z" \
  --data-urlencode "timeframe=day" \
  --data-urlencode "expand=time_series" \
  --data-urlencode "expand=auth_method"
Parameter Default Description
start, end last 24 hours ISO 8601 time range, at most 31 days.
timeframe hour Bucket size: hour, day, week (from Monday) or month.
bound_to_timeframe true Align start and end to bucket boundaries.
model all models Filter by model; repeat for several.
expand time_series Add auth_method to break results down by API key ID.
page, limit 1, 50 Pagination over buckets; limit is at most 100.

Only completed generations are counted: failed, moderated and canceled requests are not charged.

#Invoice billing

Instead of a prepaid balance, enterprise organizations can be billed by invoice for their usage. Terms, pricing and payment schedule are agreed with Higgsfield. Email [email protected] or contact your account manager.

Was this page helpful?
Navigation