gpu usage

Show serverless inference usage (tokens and cost)

Synopsis

Shows inference token/cost rollups from GET /v1/usage. Scope the query with --modality and/or --model — at least one is required (without a filter the usage endpoint returns GPU-instance usage, which this command does not render). Requires a key with the billing:read scope.

gpu usage [flags]

Examples

# Chat token usage by day (default range: last 30 days)
gpu usage --modality chat

# A single model, monthly buckets
gpu usage --model gpuai/qwen2.5-7b-instruct --bucket month

# An explicit date range
gpu usage --modality chat --start 2026-05-01T00:00:00Z --end 2026-05-29T00:00:00Z

Options

      --bucket string     Aggregation bucket: hour | day | week | month (default "day")
      --end string        Range end (RFC3339)
  -h, --help              help for usage
      --modality string   Filter by modality: chat | image | video
      --model string      Filter by model id
      --start string      Range start (RFC3339)

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

• gpu - GPU.ai command-line interface