Usage & Analytics – Crawleye Prompt-Based AI Video Analysis

Crawleye tracks your media minutes processed, storage consumption, and analysis history so you can stay within plan limits and manage costs effectively.
This guide shows you how to access your usage data via the dashboard or API.

---

1️⃣ Understanding Usage Metrics

Crawleye measures:

• Media Minutes Processed – Total video minutes analyzed by the AI
• Storage GB-Month – How much result and source video storage is used
• Charges USD – Billed amount based on minutes, features, and model size
• Credits Remaining Minutes – Available prepaid minutes from your plan
• Analysis Count – Number of analysis jobs completed

---

2️⃣ Viewing Usage in the Dashboard

1. Log in to Crawleye Dashboard
2. Go to Billing & Usage
3. See:
   • Minutes processed this month
   • Remaining credits
   • Storage usage (GB)
   • Graph of analysis activity over time
4. Filter:
   • By date range
   • By input type (Upload vs RTSP camera)
   • By model size and features

---

3️⃣ Usage API Endpoints

Get Current Usage

GET /v1/usage

{
  "media_minutes_processed": 1430,
  "storage_gb_month": 5.2,
  "charges_usd": 114.50,
  "credits_remaining_minutes": 570
}

Get Usage Analytics

GET /v1/usage/analytics

{
  "by_model": {
    "S_7B": { "minutes": 800 },
    "M_13B": { "minutes": 500 },
    "L_32B": { "minutes": 130 }
  },
  "by_feature": {
    "detect_only": 900,
    "ocr": 250,
    "reid_tracking": 180,
    "llm_summary": 100
  },
  "by_input_type": {
    "upload": 1100,
    "rtsp": 330
  },
  "daily_breakdown": [
    { "date": "2025-08-01", "minutes": 220 },
    { "date": "2025-08-02", "minutes": 185 }
  ]
}

4️⃣ Tracking Storage

Why Storage Matters
  •  Processed video results (JSON, CSV, annotated MP4) take up storage
  •  Each plan includes free retention (7–30 days)
  •  Extra storage is billed per GB-month

How to Check Storage
  •  Dashboard: Usage → Storage
  •  API: Included in /v1/usage response

⸻

5️⃣ Alerts & Notifications

You can enable:
  •  Email Alerts when usage reaches a percentage of your plan limit
  •  Webhook Notifications for real-time usage tracking

Webhook example:

{
  "event": "usage.limit_warning",
  "plan_limit_minutes": 2000,
  "minutes_used": 1800,
  "percentage_used": 90
}

6️⃣ Best Practices for Usage Optimization
  •  Test with short clips before running full-length analysis
  •  Use smaller models (S_7B) for less complex tasks
  •  Batch related tasks to avoid repeated processing
  •  Delete unneeded results to save on storage costs
  •  Schedule analyses during low-priority hours to use standard processing rates