Costs API

The Costs API surfaces lab compute spend: GPU hours, LLM API calls, and storage. It also provides the live-burn view (pods currently running) and the approval queue (high-cost experiment requests awaiting Captain sign-off).

Get Cost Summary

string

required

Convex ID of the lab.

curl "https://www.hubify.com/api/v1/costs?labId=$LAB_ID" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const { summary, experiments } = await hubify.costs.get({ labId });

object

required

Aggregated cost data.

Show Summary fields

number

All-time spend in USD.

number

All-time GPU hours.

object

Per-GPU-type breakdown: { "H200 SXM": { count, costUsd } }.

object

Live pods currently burning compute.

Show Live running

number

Number of active pods.

number

Accrued cost since each pod started.

number

Total GPU hours running right now.

object

Per-GPU live breakdown.

object[]

required

Per-experiment cost records (most recent 200).

Show Cost record

string

Linked experiment ID.

number

Estimated cost when submitted.

number

Final cost after completion.

number

GPU hours used.

string

One of pending_approval, approved, denied, auto_approved.

number

Unix ms.

The liveRunning.costUsd field is derived at query time from running pods’ hourly rates. It shows your current exposure even before experiments complete.

Overview

Labs

Data

Compute

Lab Ops

Costs

Costs API

Get Cost Summary

​Costs API

​Get Cost Summary

Costs API

Get Cost Summary