Usage & Billing

Every API request is tracked for usage monitoring and billing. You can view your usage at any time.

What's Tracked

Each API call logs:

Viewing Usage

Request your usage summary from your TutorQ account manager, or use the admin API if you have access:

Monthly Summary

GET /admin/partner/keys/{key_id}/usage?year=2026&month=3

Response:

{
  "summary": {
    "api_key_id": "abc123",
    "year": 2026,
    "month": 3,
    "total_requests": 12450,
    "total_tokens": 12450,
    "total_results": 48200,
    "avg_response_ms": 892.3,
    "error_count": 12
  },
  "daily_breakdown": [
    {
      "date": "2026-03-01",
      "requests": 420,
      "tokens": 420,
      "avg_response_ms": 856.2
    },
    {
      "date": "2026-03-02",
      "requests": 395,
      "tokens": 395,
      "avg_response_ms": 912.1
    }
  ]
}

Billing Model

During the test/pilot phase, API access is free. Production pricing will be based on:

• Per-request pricing — charged per API call
• Monthly minimums — base fee for the partnership
• Volume discounts — reduced rates at higher volumes

Pricing details will be finalized after the pilot evaluation period.

Cost Optimization Tips

• Use higher similarity_threshold (0.6-0.7) to reduce low-quality results
• Use lower top_k (2-3) if you only need the top match
• Cache frequent queries on your side to reduce API calls
• Batch related questions from the same student session