Usage & Billing

​

How Usage is Calculated

​

Agent Minutes

​

Examples

​

What Counts as Usage

• Successful TTS generations
• Streamed audio (counted when complete)

• Failed generations
• API calls that don’t generate audio (listing voices, etc.)
• Partial streams that error before completion

​

Monitoring Usage

​

Dashboard

• Current period usage
• Usage history
• Remaining minutes
• Projected usage

​

API

# Get current usage
usage = client.usage.get_current()

print(f"Used: {usage.minutes_used:.2f} minutes")
print(f"Included: {usage.minutes_included} minutes")
print(f"Remaining: {usage.minutes_remaining:.2f} minutes")
print(f"Overage: {usage.overage_minutes:.2f} minutes")

curl -X GET "https://api.kugelaudio.com/v1/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

​

Usage Alerts

1. Go to Settings → Notifications
2. Enable usage alerts
3. Set thresholds (e.g., 80%, 100%)

​

Billing Cycle

​

How It Works

1. Start of Period: Subscription fee charged
2. During Period: Usage tracked against included minutes
3. End of Period: Overage charges calculated and billed
4. Reset: Minutes reset for the new period

​

Billing Dates

• Monthly: Billed on the same day each month
• Yearly: Billed on the anniversary of signup

​

Invoices

• Subscription fee
• Overage charges (if any)
• Detailed usage breakdown
• Tax information

​

Spending Limits

​

Setting a Limit

1. Go to Settings → Billing
2. Enable Spending Limit
3. Set your maximum overage amount

​

What Happens at the Limit

1. New TTS requests are rejected
2. You receive an email notification
3. Existing streams complete normally

​

Upgrading & Downgrading

​

Upgrading

1. Charged the prorated difference immediately
2. New limits take effect immediately
3. Usage carries over to the new plan

​

Downgrading

1. Change takes effect at next billing period
2. Current limits remain until then
3. No partial refunds for unused time

​

Mid-Cycle Changes

Example: Upgrade from Starter (€20) to Business (€89) on day 15 of 30

Prorated charge = (€89 - €20) × (15/30) = €34.50

​

Payment Methods

​

Supported Methods

• Credit Cards: Visa, Mastercard, American Express, Discover
• Debit Cards: With Visa/Mastercard logo
• Enterprise: Invoice/wire transfer

​

Updating Payment Method

1. Go to Settings → Billing
2. Click Update Payment Method
3. Enter new card details

​

Failed Payments

1. We retry 3 times over 7 days
2. You receive email notifications
3. After 7 days, account is suspended
4. Update payment method to restore access

​

Taxes

​

VAT (EU Customers)

• VAT is added based on your country
• Business customers can add VAT ID for reverse charge
• VAT ID is validated automatically

​

Other Regions

• US: No sales tax (digital services)
• Other: Local taxes may apply

​

Refunds

​

Eligibility

• 14-day money-back guarantee on first subscription
• Prorated refunds for annual plan cancellations
• No refunds for overage charges

​

Requesting a Refund

• Account email
• Reason for refund
• Invoice number (if applicable)

​

Cost Optimization

​

Tips to Reduce Usage

1. Cache common phrases: Store frequently used audio
2. Use appropriate models: kugel-1-turbo for real-time, kugel-1 only when quality is critical
3. Batch processing: Generate during off-peak hours
4. Text optimization: Remove unnecessary filler words

​

Estimating Costs

Estimated Monthly Cost = 
  Subscription + 
  max(0, Expected Minutes - Included Minutes) × Overage Rate

Business Plan (€89/mo, 250 included, €0.11 overage)
Expected usage: 400 minutes

Cost = €89 + (400 - 250) × €0.11
     = €89 + €16.50
     = €105.50/month

​

Questions?