Billing
Billing & Usage
Understand Hebbrix pricing tiers, monitor your API usage, and manage your subscription programmatically.
Pricing Tiers
Free
$0/month
Perfect for testing and personal projects
- 100K tokens/month
- GPT-5-nano model
- 60 requests/minute
- Basic memory storage
- Profile extraction
- Community support
Starter
$19/month
For indie developers
- 1M tokens/month
- GPT-5-mini model
- 300 requests/minute
- Knowledge graph
- BYOK supported
- Email support
Most Popular
Pro
$99/month
For teams and production apps
- 10M tokens/month
- GPT-5 model included
- 1,200 requests/minute
- RL Training & Agent API
- Priority support
- 99.9% SLA guarantee
AI That Learns
Enterprise
Custom
For large organizations
- Unlimited tokens
- Canary Deployment
- Any model (BYOK)
- Dedicated infrastructure
- SOC 2 & HIPAA compliance
- 24/7 support & 99.99% SLA
Usage Limits
| Resource | Free | Starter | Pro | Enterprise |
|---|---|---|---|---|
| Price | $0/mo | $19/mo | $99/mo | Custom |
| Tokens | 100K/mo | 1M/mo | 10M/mo | Unlimited |
| Default Model | GPT-5-nano | GPT-5-mini | GPT-5 | Any (BYOK) |
| Rate Limit | 60/min | 300/min | 1,200/min | 3,000/min |
| Knowledge Graph | - | ✓ | ✓ | ✓ |
| BYOK (Bring Your Own Key) | - | ✓ | ✓ | ✓ |
| SLA | - | - | 99.9% | 99.99% |
| Dedicated Support | Community | Priority | 24/7 |
Endpoints
Code Examples
Check Usage
Python
from hebbrix import Hebbrix
client = Hebbrix()
# Get current usage
usage = client.usage.get()
print(f"API Calls: {usage.api_calls.used}/{usage.api_calls.limit}")
print(f"Remaining: {usage.api_calls.remaining}")
print(f"Storage: {usage.storage.used / 1024**3:.2f}GB used")
print(f"Memories: {usage.memories.used:,}")Monitor Usage Programmatically
Python (Usage Monitoring)
# Set up usage alerts
usage = client.usage.get()
# Calculate percentage used
percent_used = (usage.api_calls.used / usage.api_calls.limit) * 100
if percent_used > 80:
print(f"Warning: {percent_used:.1f}% of API calls used!")
# Consider upgrading or implementing rate limiting
if percent_used > 95:
print("Critical: Consider upgrading to avoid service interruption")
# Notify admin or auto-upgradeUpgrade Subscription
Python (Upgrade)
# Upgrade to Pro tier
result = client.billing.upgrade(tier="pro")
print(f"Upgraded to: {result.tier}")
print(f"New limits: {result.api_calls_limit:,} API calls/month")
# Check subscription status
subscription = client.billing.subscription()
print(f"Status: {subscription.status}")
print(f"Renews: {subscription.current_period_end}")Rate Limit Headers
Every API response includes headers to help you track your rate limits:
| Header | Description |
|---|---|
X-RateLimit-Limit | Max requests per window |
X-RateLimit-Remaining | Requests remaining in window |
X-RateLimit-Reset | Unix timestamp when window resets |
X-Monthly-Usage | Current month API call count |
Response Headers
HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705312800
X-Monthly-Usage: 45230
Content-Type: application/jsonOverage & Limits
When you hit limits
If you exceed your monthly API calls, requests will return 429 Too Many Requests. Upgrade your plan or wait until the next billing period.
Billing Cycle
Usage resets monthly on your subscription anniversary date. Unused quota doesn't roll over.
Instant Upgrades
Upgrades take effect immediately with pro-rated billing. New limits apply right away.
cURL Example
GET
/v1/usagecurl -X GET "https://api.hebbrix.com/v1/usage" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"