openrouter-cost-controls

# OpenRouter Cost Controls ## Overview OpenRouter provides per-key credit limits, a credit balance API, and per-generation cost queries. Combined with client-side budget middleware, you can enforce hard spending caps at the key level and soft caps in your application. This skill covers key-level limits, per-request cost tracking, budget enforcement middleware, and alert systems. ## Check Credit Balance ```bash # Current balance and limits curl -s https://openrouter.ai/api/v1/auth/key \ -H "Authorization: Bearer $OPENROUTER_API_KEY" | jq '{ credits_used: .data.usage, credit_limit: .data.limit, remaining: ((.data.limit // 0) - .data.usage), is_free_tier: .data.is_free_tier, rate_limit: .data.rate_limit }' ``` ## Per-Key Credit Limits ```python import os, requests MGMT_KEY = os.environ["OPENROUTER_MGMT_KEY"] # Management key # Create a key with a $50 credit limit resp = requests.post( "https://openrouter.ai/api/v1/keys", headers={"Authorization": f"Bearer {MGMT_KEY}"}, json={"name": "backend-prod", "limit": 50.0}, ) new_key = resp.json()["data"]["key"] # sk-or-v1-... # List all keys with their limits and usage keys = requests.get( "https://openrouter.ai/api/v1/keys", headers={"Authorization": f"Bearer {MGMT_KEY}"}, ).json() for k in keys.get("data", []): print(f"{k['name']}: ${k.get('usage', 0):.4f} / ${k.get('limit', 'unlimited')}") ``` ## Budget Enforcement Middleware ```python import os, time, requests from openai i...