Skip to main content
The VoiceDub API uses a credit-based system where you pay for what you use. Credits are consumed when creating voice dubs and training custom voice models.

​
Credit System

All API operations consume credits based on audio duration:

Voice Dubbing

10 credits per minute of audioMinimum 10 credits per dub (for clips under 1 minute)

Voice Training

10 credits per minute of trainingCost depends on your maxMinutes setting

​
Credit Examples

  • 30-second TikTok clip: 10 credits (minimum charge)
  • 3-minute song: 30 credits
  • 10-minute podcast segment: 100 credits
  • 5-minute training: 50 credits
  • 10-minute training: 100 credits
  • 30-minute training: 300 credits
  • 60-minute training: 600 credits

​
Purchasing Credits

Buy credits through the Billing Dashboard:

​
Credit Packages ($0.01 per credit)

CreditsPrice
500$5
5,000$50
50,000$500
125,000$1250
Credits never expire and can be used anytime.

​
Auto Top-Up

Set up automatic credit top-ups to ensure uninterrupted API access. Auto top-up triggers when your balance falls below a threshold you set.

​
How Auto Top-Up Works

1

Set your threshold

Choose when to trigger auto top-up (e.g., when balance drops below 500 credits)
2

Set your target

Choose the credit balance to restore to (e.g., top up to 2,000 credits)
3

Add a payment method

Securely store a payment method for automatic charges
4

Automatic monitoring

System checks your balance every 30 minutes and triggers a top-up when needed (as long as 6 hours have passed since the last auto top-up)

​
Auto Top-Up Settings

​
threshold
integer
Minimum credit balance before triggering auto top-up (100-99,000 credits)
​
target
integer
Credit balance to restore to when auto top-up triggers (1,100–100,000 credits; must be at least 1,000 credits above threshold)

​
Auto Top-Up Behavior

Frequency: System checks every 30 minutes for accounts with auto top-up enabled Rate Limiting: Maximum 1 auto top-up per 6 hours Failure Handling: If payment fails, you’ll receive an email notification and auto top-up will pause until you resolve the issue (such as updating your payment method) and complete the payment Payment Authentication: If your payment method requires 3D Secure or similar authentication, you’ll receive an email notification and auto top-up will pause until you complete authentication manually

​
Managing Payment Methods

Access payment method management through the Billing Dashboard:
  • Set default payment method for auto top-ups
  • Update expiring cards seamlessly
  • Remove unused methods for security

​
Billing Management

​
Invoices & Receipts

  • Automatic receipts emailed after each purchase
  • Downloadable invoices available in your dashboard
  • Tax information included where applicable
  • Billing history with detailed transaction records

​
Failed Payments

When auto top-up payments fail:
  1. Immediate notification via email
  2. Auto top-up paused to prevent retry loops
  3. Manual retry option in your dashboard
  4. Alternative payment methods can be used
Common failure reasons:
  • Insufficient funds in bank account
  • Expired credit card needs updating
  • 3D Secure authentication required
  • Bank decline due to fraud protection

​
Payment Authentication Required

If your payment method requires additional authentication:
You’ll receive an email with a secure link to complete authentication. Auto top-up will resume once completed.
What triggers authentication:
  • First time using a new payment method
  • Large or unusual transaction amounts
  • Bank security requirements
  • Regulatory compliance (Strong Customer Authentication)

​
Credit Usage Tracking

Monitor your credit consumption: 
curl -X GET 'https://api.voicedub.ai/v1/me' \
  -H 'Authorization: Api-Key YOUR_API_KEY'

{
  "user": {
    "apiCredits": 1847
  }
}

​
Usage Monitoring

  • Real-time balance updates after each API call
  • Usage analytics in your developer dashboard
  • Historical usage data for budgeting and forecasting

​
Rate Limits & Fair Usage

While there are no hard limits on credit usage, we monitor for:
  • Unusual consumption patterns that may indicate abuse
  • Automated systems generating excessive load
  • Terms of service violations
Accounts violating fair usage may have temporary restrictions applied while we investigate.

​
Credit Restoration for Errors

If an API operation fails due to a processing error or technical issue on our platform, any credits used for that operation will be automatically restored to your account.

​
Troubleshooting

Check these common issues:
  • Payment method expired or invalid
  • Auto top-up disabled in settings
  • Recent auto top-up within 6-hour limit
  • Insufficient bank funds or card limits
  • Authentication required (check email)
Solutions:
  • Update payment method in the Billing Dashboard
  • Re-enable auto top-up if disabled
  • Wait for rate limit to reset
  • Complete payment authentication
Common causes:
  • Insufficient funds
  • Bank fraud protection
  • Expired card details
  • International transaction blocked
Solutions:
  • Contact your bank to authorize the transaction
  • Update payment method with current details
  • Try a different payment method
  • Use manual top-up instead of auto top-up
Immediate steps:
  • Check the Billing Dashboard for transaction status
  • Verify payment was successful in your bank/card statement
  • Allow up to 5 minutes for credit balance to update
If credits still missing:
  • Contact support with payment confirmation
  • Provide transaction ID or receipt number
Review your usage:
  • Check API request logs in the Logs Dashboard
  • Verify audio duration calculations (minimum 1-minute charge)
  • Review failed requests that may have consumed credits
  • Confirm credit costs: 10 credits per minute for both dubbing and training
Contact Support:
  • Email us at [email protected], including the email address you used to sign up and details about your usage
  • Include specific request IDs or timestamps for faster resolution
  • Our team will review your account and provide detailed usage breakdown
Need help with billing? Contact our support team at [email protected] for personalized assistance.