CLI
Usage & Impact
Track your API usage, costs, and environmental impact
Usage & Impact
Usage Summary
View your usage for the current period:
melious usageChange the time period:
melious usage --period daymelious usage --period weekmelious usage --period monthShows total requests, tokens, credits, environmental impact, breakdown by product, and your most-used models.
Usage History
View recent API calls in a table:
melious usage historyFilter by product:
melious usage history --product inferenceFilter by model:
melious usage history --model qwen3-235b-a22b-instructAdjust page size:
melious usage history --limit 50| Flag | Type | Default | Description |
|---|---|---|---|
--limit | int | 20 | Items per page |
--product | string | — | Filter: inference, kit, engine, chat |
--model | string | — | Filter by model ID |
Per-Key Breakdown
See usage split across your API keys:
melious usage keysShows requests, tokens, credits, and last-used time for each key.
Environmental Impact
View your CO2, water, and energy usage with real-world equivalents:
melious usage envThis shows:
- Carbon emissions (grams CO2) with everyday equivalents
- Water consumption (liters) with household comparisons
- Energy usage (kWh) with device-hour equivalents
- Renewable energy percentage across providers
Melious tracks environmental impact for every API call. You can also see per-response impact using melious run --show-env or by enabling stats.environment in your config.