Overview

Free credits are allocated per user account and depend on your subscription tier. Credits are tracked using a 24-hour sliding window approach and determine your API usage allowance before billing applies.

How Free Credits Work

• User-level tracking: Free credits are applied per user account, not per API key
• Subscription-based: Your free credit allocation is determined by your subscription tier
• Sliding window: Free credits are tracked using a 24-hour sliding window, similar to rate limits
• Shared across API keys: All API keys under your account share the same free credit pool

Credit Usage and Billing

When using the API:

• Free credits first: API calls always use available free credits first, regardless of pay-as-you-go settings
• Within free credits: API calls are processed normally using your allocated free credits
• Exceeding free credits (no pay-as-you-go): If you exceed your free credit limit and don't have pay-as-you-go enabled, the API returns a 402 Payment Required status
• Exceeding free credits (with pay-as-you-go): Once free credits are exhausted, requests continue to be processed with standard billing rates applied

Current Free Credit Limits

For the most up-to-date free credit allocations by subscription tier, visit our pricing page.

Enabling Pay-as-You-Go

To avoid 402 Payment Required errors when exceeding free credits:

1. Visit your dashboard billing settings
2. Enable pay-as-you-go billing
3. Add a valid payment method
4. API calls will continue seamlessly with standard rates applied

Monitoring Usage

Monitor your free credit usage through your dashboard analytics and usage reports.

Note: API response headers and billing notifications are planned for future implementation.

Related Information

• Rate Limits - Learn about request rate limiting
• Authentication - How to authenticate API requests