Usage & limits

Inspect the key you are using with GET /v1/key.

curl https://api.aivokey.dev/v1/key \
  -H "Authorization: Bearer sk-aivo_..."

Response

For a plan key it returns the remaining allowance per model and window; for PAYG it returns the prepaid balance:

{
  "mode": "plan",
  "plan": { "name": "Starter", "allowance_mode": "global_pool" },
  "models": [
    {
      "model": "deepseek-v4-pro",
      "allowance": {
        "5h":    { "limit": "12000000", "used": "1200000", "reset_at": "2026-09-11T15:00:00Z" },
        "7d":    { "limit": "30000000", "used": "8000000", "reset_at": "2026-09-14T00:00:00Z" },
        "month": { "limit": "60000000", "used": "24000000", "reset_at": "2026-10-01T00:00:00Z" }
      }
    }
  ],
  "balance_micro": "0",
  "fallback_enabled": false
}

• limit / used are micro-USD (1 USD = 1,000,000).
• balance_micro is the prepaid balance for PAYG.
• fallback_enabled reports whether this key falls back to balance when its plan allowance runs out.