curl https://www.novakit.ai/api/v1/quota \
  -H "Authorization: Bearer sk_your_api_key"

{
  "org_id": "org_abc123",
  "plan": {
    "code": "pro_monthly",
    "name": "Pro Monthly",
    "kind": "recurring",
    "entitled": true,
    "period_end": "2025-02-01T00:00:00Z"
  },
  "quotas": {
    "credits": {
      "remaining": 170,
      "limit": 200,
      "used": 30,
      "usage_percent": 15
    },
    "image_generations": {
      "remaining": 138,
      "limit": 150,
      "used": 12,
      "usage_percent": 8
    },
    "video_seconds": {
      "remaining": 810,
      "limit": 900,
      "used": 90,
      "usage_percent": 10
    },
    "stt_seconds": {
      "remaining": 3240,
      "limit": 3600,
      "used": 360,
      "usage_percent": 10
    }
  }
}

{
  "choices": [...],
  "usage": {
    "prompt_tokens": 150,
    "completion_tokens": 200,
    "total_tokens": 350
  },
  "model": "openai/gpt-4o-mini",
  "model_tier": "basic"
}

{
  "data": [...],
  "usage": {
    "generations_used": 1,
    "generations_remaining": 149
  },
  "model": "fal-ai/flux/dev",
  "model_tier": "standard"
}

{
  "data": {...},
  "usage": {
    "seconds_used": 5,
    "seconds_remaining": 895
  },
  "model": "fal-ai/minimax/video-01",
  "model_tier": "standard"
}

{
  "error": "Quota exceeded for image_generations",
  "bucket": "image_generations",
  "remaining": 0,
  "limit": 100,
  "reset_at": "2025-02-01T00:00:00Z"
}

try {
  const response = await novakit.images.generate({
    prompt: "A sunset",
  });
} catch (error) {
  if (error.status === 402) {
    // Quota exceeded
    console.log(`Quota exceeded for ${error.bucket}`);
    console.log(`Resets at: ${error.reset_at}`);

    // Notify user or upgrade plan
    await notifyUser("quota_exceeded", error.bucket);
  }
}

// credits.low event
{
  "type": "credits.low",
  "data": {
    "bucketType": "chat_tokens",
    "remaining": 100000,
    "limit": 1000000,
    "percentUsed": 90
  }
}

const cache = new Map();

async function getCachedResponse(prompt: string) {
  const key = hashPrompt(prompt);

  if (cache.has(key)) {
    return cache.get(key);
  }

  const response = await novakit.chat.completions.create({
    messages: [{ role: "user", content: prompt }],
  });

  cache.set(key, response);
  return response;
}

// Generate multiple images in one request
const response = await novakit.images.generate({
  prompt: "A sunset",
  n: 4, // Generate 4 images at once
});

const MAX_DAILY_REQUESTS = 1000;
let dailyRequests = 0;

async function makeRequest() {
  if (dailyRequests >= MAX_DAILY_REQUESTS) {
    throw new Error("Daily limit reached");
  }

  dailyRequests++;
  // Make API call...
}