Use TokenGuard in 5 minutes

1. What changes in your app

BEFORE  App ──► OpenAI / OpenRouter / Anthropic
AFTER   App ──► TokenGuard ──► provider

Keep your provider API key. Add a TokenGuard user key. Point the SDK base URL at the API host (https://token-guard.onrender.com).

2. Create a user key

1. Open the developer console or product portal.
2. Console: unlock with TOKENGUARD_ADMIN_SECRET. Portal: sign in with Clerk.
3. Provision / create a key → copy the one-time tg_... key.

Or POST /mgmt/provision with header X-TokenGuard-Admin-Secret.

3. Call the proxy

Required on every LLM request:

curl -s https://token-guard.onrender.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_PROVIDER_KEY" \
  -H "X-TokenGuard-API-Key: tg_YOUR_KEY" \
  -H "X-TokenGuard-Provider: openrouter" \
  -H "X-TokenGuard-Session-ID: dev-session-1" \
  -d '{"model":"openai/gpt-4o-mini","messages":[{"role":"user","content":"Hello"}],"max_tokens":64}'

4. SDK pattern (OpenAI-compatible)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: "https://token-guard.onrender.com/v1",
  defaultHeaders: {
    "X-TokenGuard-API-Key": process.env.TOKENGUARD_API_KEY,
    "X-TokenGuard-Provider": "openrouter",
    "X-TokenGuard-Session-ID": "my-app-1",
  },
});

5. Status codes you should handle

JSON errors include a machine code field (e.g. budget_exceeded).

Useful URLs