CLI Reference

Janus provides a janus command-line tool for server management, key management, usage reporting, budget enforcement, and pricing lookup.

Top-level commands

janus serve

Start the gateway server.

janus serve --port 20128 --host 127.0.0.1

Option	Default	Description
--port / -p	20128	Port to listen on
--host	127.0.0.1	Host to bind to
--config / -c	~/.janus/config.yaml	Path to config file
--reload	off	Enable auto-reload for development

janus config-init

Create a default config file. Will not overwrite an existing file.

janus config-init
# Config created: /home/user/.janus/config.yaml

janus config-init --path ./my-config.yaml
# Config created: /home/user/Projects/Janus/my-config.yaml

Option	Default	Description
--path / -p	~/.janus/config.yaml	Where to create the config

janus config-path

Print the default config file path.

janus config-path
# /home/user/.janus/config.yaml

---

Keys

janus keys create

Create a new API key. The full key is printed once — save it immediately.

janus keys create --name "default"

API Key (save this — shown once): sk-janus-a1b2c3d4e5f67890a1b2c3d4e5f67890
ID: 1  Name: default

Option	Default	Description
--name / -n	default	Name for this key
--no-login	off	Disallow dashboard login
--models / -m	all	Comma-separated allowed model IDs or prefix/* patterns
--daily-budget	none	Daily spending limit in USD
--absolute-budget	none	Lifetime spending limit in USD; never resets
--config / -c	~/.janus/config.yaml	Path to config file

janus keys create --name "trial-key" --absolute-budget 25
janus keys create --name "limited-app" --daily-budget 5 --absolute-budget 25

janus keys update

Update a key by numeric ID. Omitted budget options leave the existing limits unchanged.

janus keys update 3 --absolute-budget 50
janus keys update 3 --daily-budget 5 --absolute-budget 25
janus keys update 3 --clear-absolute-budget

Option	Description
--name / -n	Rename the key
--login / --no-login	Allow or disallow dashboard login
--models / -m	Set allowed model IDs or prefix/* patterns
--clear-models	Remove the model allowlist
--daily-budget	Set a positive daily limit in USD
--absolute-budget	Set a positive lifetime limit in USD
--clear-daily-budget	Remove only the daily limit
--clear-absolute-budget	Remove only the lifetime limit
--config / -c	Path to config file

Absolute limits include the key's existing recorded spending; editing the limit does not reset the total. See Budgets for accounting and enforcement details.

janus keys list

List all API keys.

janus keys list

    1  sk-janus-a1b2...  default                 active  2026-06-25 10:00:00
    2  sk-janus-f3e4...  dev-key                 active  2026-06-25 11:30:00
    3  sk-janus-c5d6...  ci                       revoked  2026-06-24 09:00:00

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

janus keys revoke

Revoke an API key by ID.

janus keys revoke 3
# Revoked key 3

Argument	Description
key_id	Key ID to revoke (required)

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

---

Usage

janus usage stats

Show overall usage statistics.

janus usage stats

Total requests: 1250
Total input tokens: 890000
Total output tokens: 320000

By model:
  claude-sonnet-4-20250514          800 requests     560000 in    200000 out
  gpt-4o                            450 requests     330000 in    120000 out

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

janus usage cost

Show cost breakdown by model for the last N days.

janus usage cost --days 7

Cost breakdown (last 7 days):
Model                                  Requests         Cost
----------------------------------------------------------
  claude-sonnet-4-20250514                  800     $12.5000
  gpt-4o                                    450      $3.2000
----------------------------------------------------------
  Total                                             $15.7000

Option	Default	Description
--days / -d	30	Number of days to show
--config / -c	~/.janus/config.yaml	Path to config file

janus usage by-key

Show spending per client API key for the last N days.

janus usage by-key --days 7

Spending per key (last 7 days):
Key                                  Requests         Cost
------------------------------------------------
  default                                 1000     $13.5000
  dev-key                                  250      $2.2000

Option	Default	Description
--days / -d	30	Number of days to show
--config / -c	~/.janus/config.yaml	Path to config file

---

Budgets

janus budgets list

List all active budgets.

janus budgets list

    1  Global           warning
       Daily: $10.00  spent today: $8.20  82%
    2  Key #3           ok
       Daily: $5.00  spent today: $1.10  22%
       Absolute: $25.00  spent total: $8.00  32%  (never resets)

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

janus budgets set

Create or update a budget. Existing limits are preserved unless explicitly changed or cleared. Daily limits can be global or per-key; absolute limits require a specific key.

# Global budget: $10/day
janus budgets set --daily 10.00 --key global
# Budget 1 set: global daily limit = $10.00, warn at 80%

# Per-key budget for key named "dev-key": $5/day, warn at 70%
janus budgets set --daily 5.00 --key "dev-key" --warn 70

# Lifetime cap; retains any existing daily limit
janus budgets set --absolute 25.00 --key "dev-key"

# Remove only the lifetime cap
janus budgets set --clear-absolute --key "dev-key"

Option	Default	Description
--daily / -d	unchanged	Daily limit in USD
--absolute	unchanged	Lifetime limit in USD; never resets
--clear-daily	off	Remove the daily limit
--clear-absolute	off	Remove the lifetime limit
--key / -k	global	global or a key name
--warn / -w	existing or 80	Warn threshold percentage (1–100)
--config / -c	~/.janus/config.yaml	Path to config file

Key matching

--key matches against key names (set with janus keys create --name), not numeric IDs. Use global for a global budget.

janus budgets delete

Delete a budget by ID.

janus budgets delete 2
# Deleted budget 2

Argument	Description
budget_id	Budget ID to delete (required)

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

---

Pricing

janus pricing list

List all known model pricing, sorted by name. Includes builtin prices merged with any DB overrides (seeded from YAML on first startup, then managed via dashboard or CLI).

janus pricing list

  claude-3-5-haiku-20241022     in: $0.8    out: $4.0   cc: $1.0   cr: $0.08
  claude-sonnet-4-20250514      in: $3.0    out: $15.0  cc: $3.75  cr: $0.3
  gpt-4o                        in: $2.5    out: $10.0  cc: $0.0   cr: $0.0
  ...

Prices are per million tokens (Mtok).

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

janus pricing show

Show pricing for a specific model.

janus pricing show gpt-4o

Model: gpt-4o
  Input:              $2.5 / Mtok
  Output:             $10.0 / Mtok
  Cache creation:     $0.0 / Mtok
  Cache read:         $0.0 / Mtok

Argument	Description
model	Model name (required)

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

Pricing uses progressive prefix matching — gpt-4o matches the same entry as gpt-4o-2024-08-06. Unknown models show no pricing found.

---

Inventory

Manage upstream API key inventory. See Key Inventory for concepts and dashboard workflows.

janus inventory generate-encryption-key

Generate a Fernet key for INVENTORY_ENCRYPTION_KEY:

janus inventory generate-encryption-key
# gAAAAABl...

janus inventory encrypt-keys

Encrypt plaintext upstream keys and gateway provider API keys/OAuth credential blobs at rest in one pass. Requires INVENTORY_ENCRYPTION_KEY to be set in the environment.

export INVENTORY_ENCRYPTION_KEY='gAAAAABl...'
janus inventory encrypt-keys

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

janus inventory verify

Summarize inventory state for cutover verification:

janus inventory verify

Option	Default	Description
--config / -c	~/.janus/config.yaml	Path to config file

janus inventory migrate

Import a Dashboard_For_Apis export JSON into upstream keys:

janus inventory migrate export.json
janus inventory migrate export.json --dry-run
janus inventory migrate export.json --verify

Argument	Description
export_file	Path to export JSON (required)

Option	Default	Description
--dry-run	off	Count rows without writing
--verify	off	Print summary after import
--config / -c	~/.janus/config.yaml	Path to config file

janus bench run

Benchmark every routable model through a running gateway. The command is a normal API client: it streams a fixed deterministic prompt set (temperature 0) at each model listed by GET /v1/models, measures status, time-to-first-token, and tokens/sec client-side, and estimates cost from the local pricing registry. Because requests go through the gateway, the server's attempt signals and usage rows record themselves as a side effect — benchmarking also densifies the data model="auto" ranks on.

A plan (models, request count, token cap) is printed before anything runs; real upstream requests are made and real money may be spent.

janus bench run --base-url http://127.0.0.1:20128 --api-key "$JANUS_API_KEY"
janus bench run --prefix anthropic/ --prompts 3 --output bench.md
janus bench run --models deepseek/deepseek-chat,openai/gpt-4o-mini --yes

Option	Default	Description
--base-url	http://127.0.0.1:20128	Gateway base URL
--api-key (env JANUS_API_KEY)	required	API key with model access
--models	all routable	Comma-separated model ids
--prefix	off	Only models starting with this prefix
--limit	off	Benchmark at most this many models
--prompts	1	Fixed prompts per model (1–3)
--max-tokens	64	Output token cap per request
--timeout	60	Per-request timeout (seconds)
--output / -o	stdout	Write the Markdown report here
--yes	off	Skip the confirmation prompt
--config / -c	~/.janus/config.yaml	Local config for cost estimates