🔨 In Development — This section is still being developed and may change.
Understand how personal connectors are billed and how to manage your usage and costs effectively.
Personal connectors have associated costs based on usage. This guide explains the billing model, pricing tiers, and how to monitor and optimize your connector usage.
Connectors are billed based on:
- API Calls: Each connector function call counts as usage
- Data Transfer: Amount of data processed through connectors
- Compute Resources: Processing power used for connector operations
- Connector Calls: Each function invocation
- Data Processing: Measured in MB of data processed
- Storage: For connectors that cache or store data
- Included: 100 connector calls per month
- Data Limit: 10 MB of data processing
- Connectors: Access to basic connectors (Notion, Google Workspace)
- Support: Community support
- Included: 1,000 connector calls per month
- Data Limit: 100 MB of data processing
- Connectors: All available connectors
- Additional: 500 calls for $5, 50 MB for $2
- Support: Email support
- Included: Custom allocation based on needs
- Connectors: All connectors plus custom integrations
- SLA: 99.9% uptime guarantee
- Support: Dedicated support team
Monitor your connector usage through Freddy Hub:
- Navigate to Usage & Billing
- Select Personal Connectors tab
- View usage by connector type and time period
Track usage programmatically:
# Get usage statistics
usage = freddy.personal_connectors.get_usage(
start_date="2024-01-01",
end_date="2024-01-31",
configuration_id="config_123" # Optional: specific connector
)
print(f"Total calls: {usage.total_calls}")
print(f"Data processed: {usage.data_mb} MB")
print(f"Cost: ${usage.cost}")
# Usage by connector type
for connector_usage in usage.by_connector:
print(f"{connector_usage.type}: {connector_usage.calls} calls")Set up alerts for usage thresholds:
# Configure usage alerts
freddy.billing.set_alerts([
{
"metric": "connector_calls",
"threshold": 800,
"period": "monthly",
"action": "email"
},
{
"metric": "data_processing",
"threshold": 80,
"period": "monthly",
"action": "email"
}
])- Batch Operations: Combine multiple calls into single requests when possible
- Caching: Cache frequently accessed data to reduce API calls
- Selective Queries: Use specific queries instead of broad searches
- Pagination: Handle large datasets with pagination instead of single large requests
# Instead of multiple calls
for item in items:
notion_connector.get_page(item.id) # Multiple API calls
# Use batch operations
notion_connector.get_pages(item_ids) # Single API call# Instead of transferring large files
connector.download_file(file_id) # Downloads entire file
# Use streaming for large data
for chunk in connector.stream_file(file_id):
process_chunk(chunk) # Process in chunksAdd and manage payment methods in Freddy Hub:
- Credit cards (Visa, MasterCard, American Express)
- PayPal
- Bank transfers (Enterprise only)
- Prepaid credits
View detailed billing history:
# Get billing history
bills = freddy.billing.get_history(
start_date="2024-01-01",
end_date="2024-01-31"
)
for bill in bills:
print(f"Date: {bill.date}")
print(f"Amount: ${bill.amount}")
print(f"Description: {bill.description}")
print(f"Invoice: {bill.invoice_url}")- Automatic invoice generation for paid plans
- Download invoices in PDF format
- Email delivery of monthly statements
- Integration with accounting software
- Custom Pricing: Negotiated rates for high-volume usage
- Consolidated Billing: Single invoice for multiple accounts
- Budget Management: Set spending limits and alerts
- Cost Centers: Allocate costs to different departments
- Priority Support: Fast-tracked support requests
- Technical Account Manager: Dedicated point of contact
- Custom Integrations: Build connectors for proprietary systems
- SLA Guarantees: Guaranteed uptime and response times
Unexpected Charges
- Review usage logs for unexpected connector activity
- Check for unused or misconfigured connectors
- Verify billing calculations in the dashboard
Payment Failures
- Update payment method information
- Check for insufficient funds or expired cards
- Contact support if payment method issues persist
Usage Disputes
- Provide detailed usage logs showing the discrepancy
- Include timestamps and descriptions of disputed activity
- Contact billing support with supporting evidence
Billing Support
- Email: billing@aitronos.com
- Live chat: Available in Freddy Hub
- Phone: Enterprise customers only
Technical Issues
- Check status.aitronos.com for service outages
- Review connector documentation for known issues
- Contact technical support for integration problems
Estimate your connector costs before implementation:
def estimate_connector_costs(config):
"""Estimate monthly costs for connector usage."""
# Base costs by connector type
base_costs = {
"notion": 0.001, # per call
"google_workspace": 0.002,
"slack": 0.001,
"github": 0.001,
"database": 0.005,
"custom_api": 0.01
}
total_calls = config.get("estimated_calls", 1000)
connector_type = config.get("connector_type", "notion")
base_cost = base_costs.get(connector_type, 0.001) * total_calls
# Data processing costs
data_mb = config.get("estimated_data_mb", 50)
data_cost = data_mb * 0.02 # $0.02 per MB
return {
"base_cost": base_cost,
"data_cost": data_cost,
"total_monthly": base_cost + data_cost,
"assumptions": {
"calls_per_month": total_calls,
"data_mb_per_month": data_mb
}
}
# Example usage
config = {
"connector_type": "notion",
"estimated_calls": 2000,
"estimated_data_mb": 100
}
costs = estimate_connector_costs(config)
print(f"Estimated monthly cost: ${costs['total_monthly']:.2f}")- Connectors Overview - Learn about available connectors
- Usage Guide - How to use connectors effectively
- Authentication - Set up your connectors
- API Reference - Technical details
For billing questions, contact billing@aitronos.com.