Usage summary for the current billing period. Exposed via speko.usage.
summary = speko.usage.get()
print(summary.total_sessions, summary.total_minutes, summary.total_cost)
print(summary.balance_usd)
Signature
Speko.usage.get(
*,
from_date: str | None = None,
to_date: str | None = None,
) -> UsageSummary
Returns — UsageSummary
Total cost in USD over the range.
Per-provider rollup — see below.
Current organization balance in micro-USD (1_000_000 µ$ = $1), serialized as string so values beyond 2^53 survive JSON. Use int(summary.balance_micro_usd) when you need to do math.
Same balance, pre-divided for display convenience.
UsageByProvider
Billable unit (e.g. minutes, characters, tokens).
BYOK = customer key, no Speko margin. MANAGED = platform key, billed to the org.
Cost in USD for this row.
Example — last 24 hours
from datetime import datetime, timedelta, timezone
now = datetime.now(timezone.utc)
yesterday = now - timedelta(hours=24)
summary = speko.usage.get(
from_date=yesterday.isoformat(),
to_date=now.isoformat(),
)
for row in summary.breakdown:
print(f"{row.type}\t{row.provider}\t{row.quantity}{row.metric}\t${row.cost}")
