Venice Admin

Manage your Venice AI account - check balance, view usage history, and manage API keys.

⚠️ Important: These endpoints require an Admin API key, not a regular inference key. Create one at venice.ai → Settings → API Keys → Create Admin Key.

API Base URL: https://api.venice.ai/api/v1

Setup

1. Create an Admin API key from venice.ai → Settings → API Keys
2. Set the environment variable:

export VENICE_API_KEY="your_admin_api_key_here"

---

Check Balance

View your current DIEM and USD balances.

uv run {baseDir}/scripts/balance.py

Output includes:

• Whether you can consume (has balance)
• Current consumption currency (DIEM or USD)
• DIEM balance and epoch allocation
• USD balance

---

View Usage History

View detailed usage history with filtering and pagination.

uv run {baseDir}/scripts/usage.py

Options:

• --currency: Filter by currency: DIEM, USD, VCU (default: DIEM)
• --start-date: Start date filter (ISO format: 2024-01-01)
• --end-date: End date filter (ISO format: 2024-12-31)
• --limit: Results per page (default: 50, max: 200)
• --page: Page number (default: 1)
• --sort: Sort order: asc or desc (default: desc)
• --format: Output format: json or csv (default: json)
• --output: Save to file instead of stdout

Examples:

# Last 50 DIEM transactions
uv run {baseDir}/scripts/usage.py

# USD usage in January 2024
uv run {baseDir}/scripts/usage.py --currency USD --start-date 2024-01-01 --end-date 2024-01-31

# Export to CSV
uv run {baseDir}/scripts/usage.py --format csv --output usage.csv

---

List API Keys

View all your API keys.

uv run {baseDir}/scripts/api_keys_list.py

Output includes:

• Key ID and name
• Key type (Admin, Inference, etc.)
• Creation date
• Last used date
• Rate limits

---

Runtime Note

This skill uses uv run which automatically installs Python dependencies (httpx) via PEP 723 inline script metadata. No manual Python package installation required - uv handles everything.

---

Security Notes

• Admin keys have elevated permissions - protect them carefully
• Admin keys can view billing info and manage other keys
• Never commit admin keys to version control
• Consider using inference-only keys for production workloads

API Reference

Endpoint	Description	Auth Required
GET /billing/balance	Check DIEM/USD balance	Admin key
GET /billing/usage	View usage history	Admin key
GET /api_keys	List all API keys	Admin key

Full API docs: docs.venice.ai