Skip to content

Usage and costs

View Markdown

Every charge Nodus makes is backed by usage records: one line per meter, per object, per window. This page shows how to read them, group them and export them.

Rented GPU and CPU compute uses live quotes instead of a fixed list-price ceiling. Rates and available configurations can change before acquisition. The rate is frozen when capacity is acquired, and your spending limits still apply. Existing allocations keep their frozen rates.

Review the current offering before submitting work:

Terminal window
nodus get offerings
nodus get offering a100-sxm-40g-x1-us -o json

The CLI, SDK and console use the same server quotes. An unavailable live quote is not a free rate or a capacity reservation. Offering hourly rates apply to the whole machine; an offering with eight GPUs is priced for all eight.

This policy applies to rented compute. Inference, storage, network transfer and shared capacity retain their separate pricing policies. Usage records show the charges that actually accrued.

Each compute object shows its cost so far in status.cost:

Terminal window
nodus get job train-llama -o jsonpath='{.status.cost}'
{"totalUSD": "4.182500", "heldUSD": "0.750000", "bySegment": {"bootUSD": "0.121000", "runningUSD": "3.980000", "teardownUSD": "0.081500"}}

heldUSD is reserved credit. Review the final total in the run’s Cost tab.

Terminal window
nodus get usage --since 2d
nodus get usage --group-by project,meter
nodus get usage --group-by member --since 30d
nodus get usage --group-by label:team,day
nodus get usage --group-by rank,segment --field-selector object.uid=<uid of a multi-node Job>

--group-by accepts project, kind, member, meter, day, segment, rank and label:<key>. member is the person who started the work, whichever of their API keys they used. Labels are the ones the object carried when it was admitted, so label your work before you submit it:

metadata:
name: train-llama
labels:
team: research

Grouped totals always add up to the ungrouped total: every line lands in exactly one group, and lines without the grouped value share an empty group.

Terminal window
nodus get usage --since 30d -o csv > usage.csv
curl -H "Authorization: Bearer $NODUS_TOKEN" -H "Accept: text/csv" \
"https://api.nodus-compute.ai/v1/usagerecords?since=30d"

Amounts are in US dollars. Use the exported totals to reconcile your spending with the console.

For help with a charge, see Receipts and invoices.