Frequently asked questions
How much does the API cost?
The API costs $10 per 1 million characters, which equals $0.01 per 1,000 characters. This flat rate applies to all models, including tts-1 and tts-1-hd, with no tiered pricing or volume discounts. You only pay for the characters you actually process, making it predictable for classroom materials or indie dev projects.
What is included in the character count?
The character count includes spaces and punctuation marks. Every single character in your input text contributes to the total, so a space counts as one character. This applies to all text sent to the endpoint, ensuring accurate billing based on the exact input length submitted in the JSON body.
Is there a free trial?
Yes, signing in with Google provides a $0.50 trial credit, valid for 7 days, covering about 50,000 characters. Accounts created with email and password start without this trial credit. This allows you to test the API’s quality and integration before committing to a top-up for your educational or dev needs.
How do I pay with USDT?
Payments are made via USDT on the TRON network (TRC-20) only. There are no credit cards, PayPal, or invoices. After you initiate a transfer, the balance is credited automatically within minutes. This method avoids traditional banking fees and suits indie developers who prefer crypto transactions for their API usage.
Do failed requests cost money?
No, failed requests are free. If synthesis fails, the charge is returned in full. You only pay for successfully generated audio files. This ensures you are not penalized for temporary network issues or invalid inputs, keeping your budget predictable for classroom projects and automated edtech tools.
Does my balance expire?
No, your balance does not expire. Once you top up with USDT, the credits remain available indefinitely. You can use them at your own pace, whether for a single lesson or a long-term edtech project. This flexibility supports teachers and developers who may not generate audio daily.
Is there a minimum spend?
There is no minimum spend for using the API. You can use any amount of credit, down to a single character. The only constraint is the $5 minimum for a USDT top-up. This allows you to start small and scale your usage as your classroom or app grows.
Are there VAT fees?
No, there are no VAT fees or invoices. The price you see is the price you pay. Since payments are processed via crypto (USDT), traditional tax structures do not apply. This simplifies accounting for indie developers and schools that prefer straightforward, transparent billing without additional administrative overhead or tax complexities.
How do I top up?
Send USDT on the TRON network (TRC-20) to the address provided in your dashboard. The minimum top-up is $5. Once the blockchain confirms the transaction, your balance is updated automatically within minutes. No manual approval is required, allowing you to resume generating audio for your projects immediately.
What is the minimum top-up amount?
The minimum top-up amount is $5. This applies to USDT transfers on the TRON network. There is no minimum for API usage itself, but this threshold ensures efficient processing of crypto transactions. You can top up as often as needed, provided each transfer meets this minimum amount.
Can I use multiple keys?
Yes, you can issue a new API key at any time. When you generate a new key, the old one stops working immediately. This allows you to rotate keys for security or separate projects. Each account maintains one active key, ensuring clear attribution and billing for all generated audio files.
How do I check my balance?
Your balance, trial status, and characters left are displayed on the /get-api-key/ page. You can also view usage details there. This dashboard provides real-time information on your credit status, helping you manage your budget for classroom materials or indie development without needing to check external billing portals.
What happens if I run out of credits?
If you run out of credits, you cannot generate new audio until you top up. Requests will fail without charge. You can top up with USDT to restore your balance. This ensures you only pay for what you use, without unexpected charges.
Can I get a refund?
Refunds are automatic for failed requests, where the charge is returned in full. For successful requests, credits are consumed. For other billing issues, contact support via email. The system prioritizes returning funds for errors rather than manual refund processing.
Cost calculator
Standard Rate
Our pricing model charges $10 per 1 million characters, equating to $0.01 per 1,000 characters. This rate applies uniformly regardless of the voice model selected, whether "tts-1" or "tts-1-hd". The cost is calculated based on the exact length of the input text provided in each request.
Per Character Cost
The base rate is $10 per 1 million characters. This simple metric allows educators and developers to predict costs precisely before sending any text to the API.
Spaces and Punctuation
Every character counts toward the total. Spaces, commas, periods, and other punctuation marks are included in the character count. This ensures that the billing reflects the exact volume of data processed by the synthesis engine.
Long Text Calculation
For longer lessons or chapters exceeding 4,096 characters, you must split the input into smaller parts and join the audio files. Each part is synthesized separately and then joined into a single audio file. You are charged for each part processed, ensuring accurate billing for extensive materials.
Free Trial
When you sign in with Google on the /get-api-key/ page, you immediately receive a free trial balance of $0.50. This credit allows you to generate approximately 50,000 characters of speech, which is sufficient for testing voice quality or creating a short classroom audio clip.
The trial credit is valid for 7 days from the moment of sign-in. After this period, the credit expires and does not roll over. If you created your account using only an email and password, you start without this initial trial credit.
Trial Duration
The $0.50 trial credit remains active for exactly 7 days after your first login. This short window is designed to let educators and indie developers verify the API’s voice presets and audio formats without financial commitment. Once the seven days pass, any unused trial balance is forfeited and cannot be reclaimed.
This duration applies only to accounts registered via Google. Accounts created with an email and password do not receive the trial credit at all, ensuring a clear distinction between trial users and paid customers who top up with USDT.
- Valid for 7 days from sign-in.
- Provides $0.50 credit (~50,000 characters).
- Available only for Google sign-in accounts.
- Expires automatically after the period ends.
Payment Method
SonicLesson accepts USDT on the TRON network (TRC-20) for all top-ups. We do not process credit cards, PayPal, or traditional bank transfers, keeping the billing infrastructure simple and borderless. This method allows educators and indie developers to fund their accounts without navigating complex merchant gateways or waiting days for settlement.
USTRON Network
We support USDT specifically on the TRON (TRC-20) chain. This network offers low transaction fees and fast confirmation times, ensuring your API credits are available when you need them. No other blockchain networks or fiat currencies are currently accepted for direct top-ups.
- Supported network: TRON (TRC-20)
- Currency: USDT (Tether)
- No credit cards or PayPal
Minimum Top-Up
The minimum top-up amount is $5. This low threshold makes it easy for teachers to start with a small budget for classroom materials or for indie developers to test the API before scaling up. There is no minimum monthly spend or required subscription plan.
Automatic Credit
Once your transfer is confirmed on the blockchain, your balance is updated automatically within minutes. You do not need to submit a support ticket or wait for manual review. Your characters are immediately available for use in your synthesis requests.
Cost Examples
Predicting API costs is straightforward because billing scales linearly with character count, including spaces and punctuation. This transparency helps teachers budget for classroom materials and developers estimate expenses for edtech tools without hidden surprises.
Short Lesson
A 500-character script for a 30-second audio clip costs $0.005. This rate makes it affordable to generate distinct voices for individual vocabulary words or short dialogue exercises in language classes.
Long Chapter
A 10,000-character story chapter costs $0.10. Since the API handles text splitting, you can paste a full lesson plan and receive a single audio file, avoiding manual chunking.
Monthly Estimate
Generating 1 million characters monthly costs $10. For a small team or solo developer, this covers extensive audio production for multiple projects without requiring a minimum spend or subscription tier.

Failed Requests
Synthesis is not instantaneous, and network hiccups happen. When a request fails, you are not charged for the characters processed. This ensures that transient issues do not inflate your monthly bill.
Our system handles the billing logic automatically. If the API returns an error status, the character count is deducted from your balance, and no audio file is generated or charged.
Status Codes
Standard HTTP status codes indicate the result of your request. A 200 OK means success and a charge applies. A 4xx or 5xx error indicates failure, and the request is free.
Common errors include 401 Unauthorized for invalid keys or 429 Too Many Requests if you exceed the 60 requests per minute limit. These failures incur zero cost.
- 200 OK: Charge applies
- 400 Bad Request: Free
- 401 Unauthorized: Free
- 429 Rate Limit: Free
- 500 Server Error: Free
No Hidden Fees
Our pricing model strips away the administrative overhead typical of enterprise contracts. You pay strictly for what you process, with no hidden fees or surprise charges attached to your account.
No VAT
We do not issue invoices with Value Added Tax. The rate is simple: $0.01 per 1,000 characters. This flat structure avoids regional tax complexities for schools and indie developers.
No Subscriptions
There are no monthly plans or recurring seat fees. You only incur costs when you generate audio. If you stop using the API, your bill is zero.
No Minimum Spend
You can top up with as little as $5 via USDT. There is no requirement to maintain a specific balance or commit to a minimum annual spend.
Balance Management
Your API key is your only credential for billing and access. Unlike enterprise contracts, there are no monthly subscriptions or minimum spend requirements tying you to a specific account tier. You pay only for what you generate, and your balance remains active indefinitely until you choose to stop.
Managing your account is straightforward because there is only one active key per account. This simplicity reduces integration overhead for indie developers and classroom materials, ensuring that billing metadata is always tied to a single, traceable identifier.
Key Management
You can issue a new API key at any time via the dashboard. The old key stops working immediately, providing instant security without waiting for manual approval or batch updates.
Since there is no phone support or live chat, key rotation is self-service. This allows teachers and developers to regenerate credentials quickly after a suspected leak or when handing off access to a new team member.
- One active key per account
- Instant revocation on new key generation
- No manual approval delays
- Self-service via /get-api-key/
Listen to the 8 voices
Each sample below was generated by this API from the same sentence. The language’s dominance in data and education tools means libraries handle text splitting and format conversion natively.
23 languages
Any voice speaks any of these languages.
Sources and further reading
- Wikipedia
- Tether (USDT)
- W3C WAI: making audio and video accessible
- TRON developer hub: TRC-20
- LibriVox public-domain audiobooks
- openai-node on GitHub
- LibriTTS-R corpus (OpenSLR 141)
- Creative Commons Attribution 4.0
- LibriTTS-R paper (arXiv 2305.18802)
- Node.js documentation
- Python documentation
- curl documentation
