Billing & Usage
Monitor your usage, understand tier limits, and manage your Sematryx subscription.
Plan Limits
Each tier includes different limits for optimizations and Private Learning Store:
| Feature | Free | Starter | Pro | Enterprise |
|---|---|---|---|---|
| Monthly Optimizations | 10 | 500 | 5,000 | Unlimited |
| Optimization Overage | — | $0.20/ea | $0.10/ea | Custom |
| Private Learning Store | — | ✓ | ✓ | ✓ |
| Private Learning Accesses | — | 1,000/mo | 5,000/mo | Unlimited |
| Storage Included | — | 1 GB | 5 GB | Unlimited |
| Storage Overage | — | $2/GB/mo | $1/GB/mo | Included |
| Explanation Levels | 0-2 | 0-3 | 0-4 | 0-5 |
| API Rate Limit | 10/min | 60/min | 300/min | Custom |
See pricing page for full details and current rates.
Checking Your Usage
Monitor your usage programmatically via the SDK or API:
from sematryx import get_usage
# Get current billing period usage
usage = get_usage()
print(f"Optimizations used: {usage['optimizations']['used']}/{usage['optimizations']['limit']}")
print(f"Private learning accesses: {usage['private_learning']['accesses']}")
print(f"Storage used: {usage['private_learning']['storage_mb']} MB")
print(f"Billing period: {usage['period_start']} to {usage['period_end']}")The response includes detailed usage breakdown:
{
"tier": "pro",
"period_start": "2024-01-01T00:00:00Z",
"period_end": "2024-01-31T23:59:59Z",
"optimizations": {
"used": 847,
"limit": 5000,
"overage": 0,
"overage_rate": "$0.10 per optimization"
},
"private_learning": {
"enabled": true,
"accesses": 2340,
"included_accesses": 5000,
"overage_accesses": 0,
"storage_mb": 156,
"storage_limit_mb": 5120,
"overage_storage_gb": 0
},
"current_charges": {
"base_subscription": "$299.00",
"optimization_overage": "$0.00",
"storage_overage": "$0.00",
"total": "$299.00"
}
}Managing Private Learning Storage
Monitor and manage your Private Learning Store storage:
from sematryx import PrivateLearningStore
store = PrivateLearningStore(api_key='your-api-key')
# Get storage details
storage = store.get_storage_info()
print(f"Used: {storage['used_mb']} MB")
print(f"Limit: {storage['limit_mb']} MB")
print(f"Utilization: {storage['utilization_percent']:.1f}%")
# List stored patterns by size
patterns = store.list_patterns(sort_by='size', limit=10)
for p in patterns:
print(f"{p['signature']}: {p['size_kb']} KB, {p['access_count']} accesses")
# Delete old/unused patterns to free space
store.cleanup(
older_than_days=90,
min_accesses=2,
dry_run=True # Preview what would be deleted
)Storage Tips
- •Cleanup regularly: Remove patterns older than 90 days with low access counts
- •Use signatures: Tag patterns with problem signatures for better retrieval
- •Anonymize: Enable anonymization to reduce storage per pattern
Overage Billing
When you exceed your tier's included limits, overage charges apply:
Optimization Overage
Charged per optimization beyond your monthly limit. Rates vary by tier.
Storage Overage
Charged monthly per GB above your included storage.
Private Learning Access Overage
Charged per 1,000 accesses beyond your included monthly accesses.
Usage Alerts
Set up webhooks to receive alerts when approaching limits:
# Webhook payload for usage alerts
{
"event": "usage.threshold_reached",
"timestamp": "2024-01-15T10:30:00Z",
"data": {
"resource": "optimizations",
"threshold": 80,
"current_usage": 4000,
"limit": 5000,
"message": "You've used 80% of your monthly optimizations"
}
}Available Alert Thresholds
- 50%: Halfway through your monthly limit
- 80%: Approaching limit (default alert)
- 100%: Limit reached, overage billing begins
- Storage 90%: Storage nearly full
Configure alerts in your account settings.
Upgrading Your Plan
Upgrade anytime to get higher limits and additional features:
Immediate Effect
New limits apply immediately. You're charged a prorated amount for the remainder of the billing period.
Downgrade
Downgrades take effect at the next billing period. Ensure storage is within new limits before downgrade.
Billing FAQ
When does my billing period reset?
Billing periods are monthly from your subscription start date. Usage limits reset at the start of each period.
Can I set a spending cap?
Yes. In your account settings, you can set a maximum overage amount. Once reached, additional requests will be rejected until the next billing period.
What happens if I exceed storage limits?
New patterns won't be stored until you free up space or upgrade. Existing patterns remain accessible. You'll receive an alert when approaching 90% capacity.
Do unused optimizations roll over?
No. Monthly optimization limits reset each billing period. Consider upgrading if you consistently need more.