Frequently asked questions
What is text-to-speech?
Text-to-speech (TTS) is a cloud API that converts written text into audio files. You send a POST request with your text and receive an audio response. It is designed for integrating synthetic speech into applications, such as making online course content accessible or enhancing reading experiences without requiring human voice actors.
How does TTS work for novels?
Send your novel text to the /v1/audio/speech endpoint. The API generates audio based on selected voices like Aria or Orion. Since novels are long, you split the text into chunks of up to 4096 characters. Each chunk generates a separate audio file, which you then join to create the full audiobook.
Which voice is best for 'To Kill a Mockingbird'?
Orion (deep, documentary) or Sage (calm, instructional) are suitable choices. Aria offers a warm narrator style, while Luna provides a soft storytelling tone. All eight voices support English and can adapt to the narrative tone of literary fiction.
Can TTS handle long texts?
Yes, but you must split the text. The API accepts up to 4096 characters per request. For longer novels, divide the text into parts within this limit. Generate audio for each part individually, then join the resulting audio files to create a continuous listening experience for your users.
How do I split text for TTS?
Divide your text into segments of up to 4096 characters. Send each segment as a separate POST request to the API. The API returns an audio file for each request. You are responsible for concatenating these audio files in order to reconstruct the full narrative or chapter.
What is the character limit?
Each API request supports a maximum of 4096 characters in the input field. This limit applies per request, not per session. If your text exceeds this, you must split it into multiple requests. Spaces and punctuation count toward this character limit.
Is the API compatible with OpenAI SDK?
Yes. The API uses the same request shape as the OpenAI speech endpoint. You can use official OpenAI SDKs by changing the base_url to https://api.nbcasino.info/v1. Simply provide your API key, and the SDK will handle the requests as it would for OpenAI's service.
How much does it cost to read a chapter?
Pricing is $0.01 per 1,000 characters. A typical chapter might range from 3,000 to 5,000 characters, costing between $0.03 and $0.05. The rate is $10 per million characters. Costs are incurred only for successful synthesis; failed requests are free.
Do I need a developer to integrate TTS?
Basic integration requires sending JSON POST requests, which developers handle easily. The API supports standard HTTP methods and JSON bodies. While non-developers can use the curl examples provided, automating text splitting and audio joining for long novels typically requires custom code or a developer's assistance.
What audio formats are supported?
The API supports mp3, wav, opus, flac, and pcm formats. You specify the desired format using the response_format field in your request. MP3 is efficient for web delivery, while WAV and FLAC offer lossless quality. PCM is available for uncompressed raw audio needs.
Can I use the audio in paid courses?
Yes, the generated audio files are returned in the response and can be used in your products. The API does not store the audio, so you must save it yourself. There are no restrictions on commercial use, and the audio includes an inaudible watermark marking it as synthetic.
How do I handle failed requests?
If synthesis fails, the charge is returned in full. You receive an error response indicating the issue. Check your input text length and voice validity. Retrying the request is free if it fails again. Ensure your API key is valid and you have sufficient balance.
Is there a free trial available?
Yes, signing in with Google provides $0.50 of credit, valid for 7 days. This covers about 50,000 characters. Accounts created with email and password start without trial credit. You can top up with USDT on the TRON network to continue using the service.
How do I track my API usage?
The dashboard on /get-api-key/ displays your balance, characters left, and usage history. Request metadata, including time, characters, and status, is kept for billing. You can monitor your consumption directly from the account page to manage your budget effectively.
What languages are supported?
The API supports 23 languages, including English, Spanish, French, German, Japanese, and Chinese. Any voice can speak any supported language. If the language is not set, it is guessed from the script. For non-English Latin text, explicitly set the language parameter to ensure accuracy.
How do I authenticate API requests?
Include your API key in the Authorization header as 'Bearer tts-...'. You receive one active key per account. If you generate a new key, the old one stops immediately. Ensure your key is valid and associated with an account that has sufficient balance.
Can I regenerate my API key?
Yes, you can issue a new key at any time from your account page. When a new key is generated, the old one stops working immediately. This allows you to revoke access if a key is compromised without affecting your balance or usage history.
Is there a developer dashboard?
The /get-api-key/ page serves as the dashboard. It shows your API key, balance, trial status, characters left, and usage statistics. It also provides ready-to-use curl examples for quick testing. There is no separate dashboard; all account management happens on this single page.
How do I handle rate limits?
The limit is 60 requests per minute per key. Before your first top-up, the limit is 10 requests per minute. Requests are processed sequentially, so high load may cause queuing. Monitor your usage to avoid hitting the limit, which may delay audio generation.
What happens if I exceed my limit?
Requests may queue if you exceed the rate limit. The API processes requests one after another. If you exceed the limit, additional requests wait until capacity is available. Failed requests due to limits are not charged, but successful ones are billed normally.
Understanding TTS for Literature
Text-to-speech (TTS) converts written text into synthesized audio, enabling users to listen to content rather than read it. For literature like 'To Kill a Mockingbird', this technology transforms static chapters into an accessible audio experience, preserving narrative flow without requiring visual attention.
Using TTS for novels allows product teams to offer flexible consumption methods. Users can engage with classic texts during commutes or while multitasking, expanding the reach of educational materials beyond traditional reading screens.
Text-to-speech basics
The API accepts text input and returns an audio file. Users send a POST request with the desired voice and format, receiving a synthesized MP3, WAV, or other format. This process is straightforward: input text, receive audio.
The system supports up to 4096 characters per request. For longer texts, content is split into manageable segments, processed individually, and then joined to form a continuous listening experience.
- Input: Plain text up to 4096 characters.
- Output: Audio file in chosen format.
- Processing: Sequential synthesis with queue handling.
Why use TTS for novels?
TTS enhances engagement by allowing users to experience literature through audio. It supports diverse learning styles and enables multitasking, making classic novels more accessible to busy professionals and students.
For educational platforms, integrating TTS provides an additional feature. It allows courses to offer audio versions of readings, catering to users who prefer listening over reading, especially for long-form content.
- Enhances user engagement.
- Supports multitasking.
- Caters to diverse learning styles.
Accessibility benefits
TTS improves accessibility for users with visual impairments or dyslexia. By converting text to speech, it ensures that literary content is available to a wider audience, complying with accessibility standards.
It also aids language learners by providing audio examples of pronunciation and intonation. This is particularly useful for classics like 'To Kill a Mockingbird', where understanding dialect and tone is crucial.
- Supports visual impairments.
- Assists users with dyslexia.
- Aids language learners.
Choosing the Right Voice
For educational platforms, voice selection directly impacts learner retention and accessibility compliance. VoiceLoom provides eight distinct presets derived from licensed LibriTTS-R and LibriVox recordings, allowing product teams to match narrative tone with content type without custom cloning or voice design.
Aria for clear narration
Aria offers a warm, clear narrator voice ideal for classic literature like 'To Kill a Mockingbird.' Her tone ensures complex sentences remain intelligible, supporting students who rely on audio for accessibility or prefer passive listening during commutes.
- Warm, clear narrator tone
Sage for instructional tone
Sage delivers a calm, instructional voice suitable for course summaries or educational commentary. This preset maintains a steady, non-distracting pace, making it effective for reinforcing key concepts after the main narrative segments conclude.
- Calm, instructional delivery
Milo for conversational style
Milo provides a friendly, conversational voice that humanizes supplementary materials or discussion prompts. Use Milo for interactive elements or quiz explanations where a more relatable tone encourages student engagement without breaking the immersive experience.
- Friendly, conversational style
Technical Implementation Steps
To integrate VoiceLoom’s TTS API into your LMS, begin by generating a secure API key via the /get-api-key/ dashboard. This key authenticates your requests to the API base https://api.nbcasino.info/v1 using the standard Authorization: Bearer header, allowing compatibility with existing OpenAI SDK configurations by changing the base URL.
API key setup
Navigate to the account dashboard to issue your unique key. Ensure you store this credential securely within your course management system’s environment variables. The key enables access to all voices and formats, with the ability to revoke and replace it instantly if needed.
- Generate key via /get-api-key/
- Use
Authorization: Bearer tts-...header - Revoke old keys instantly
Making the first request
Construct a POST request to https://api.nbcasino.info/v1/audio/speech with a JSON body. Include the model (e.g., tts-1), voice (e.g., aria for clear narration), and input text. For literature, ensure the text does not exceed 4096 characters per request to avoid truncation.
- Endpoint:
POST /v1/audio/speech - Body: JSON with
model,voice,input - Max 4096 characters per call
Handling responses
The API returns the audio file directly in the response body. Handle potential errors by checking the HTTP status code; failed requests are free and return no charge. Store the returned audio file in your LMS’s media library, ensuring it is tagged with the corresponding chapter or section metadata.
- Audio returned in response body
- Failed requests are free
- Store in LMS media library
Managing Long Texts
When adapting longer literary works like *To Kill a Mockingbird*, your API integration must handle the 4096-character input limit per request. Instead of truncating the narrative, your system should split the text into sequential chunks, ensuring each segment remains within the allowed length while preserving semantic coherence for accurate synthesis.
Each chunk generates a separate audio file. Your backend must retrieve these files and concatenate them into a single continuous audio file. This approach ensures that even extensive novels can be processed efficiently without exceeding the per-request constraints of the text-to-speech engine.
Splitting at 4096 characters
Break the source text into segments no longer than 4096 characters, including spaces and punctuation. Since requests are processed sequentially, splitting ensures that no single chunk exceeds the API's capacity. This method allows you to process large chapters or entire novels without losing context or encountering input errors.
- Count characters accurately, including spaces.
- Split at natural boundaries like sentence ends when possible.
- Keep each segment under 4096 characters.
Joining audio segments
After generating audio for each split segment, retrieve the files and join them in the correct order. The API returns audio data that can be concatenated to form a continuous listening experience. This process ensures that the narrative flow remains intact, allowing users to listen to long texts without interruption.
- Maintain the original order of segments.
- Concatenate files seamlessly.
- Verify file integrity before joining.
Ensuring seamless playback
To provide a smooth user experience, ensure that the transition between audio segments is seamless. Minimize gaps between segments by optimizing the concatenation process. This ensures that listeners do not notice the boundaries between generated clips, maintaining immersion in the literary work.
- Minimize gaps between segments.
- Optimize concatenation for smooth playback.
- Test transitions with sample texts.
Language Considerations
Text-to-speech engines often guess the language based on character scripts, which can lead to incorrect accents for non-English Latin texts. For instance, French or German dialogue in *To Kill a Mockingbird* might default to an English pronunciation if the language field is omitted.
Explicitly setting the language parameter ensures accurate pronunciation for diverse dialogue segments. This is critical for maintaining narrative immersion and clarity in educational audio content.
English script detection
The API assumes English for any Latin-script input unless specified otherwise. This default behavior simplifies workflows for single-language courses but risks mispronunciation for secondary languages appearing in the text.
Setting explicit language codes
Passing an ISO language code (e.g., fr for French) overrides the script detection. This ensures that specific dialogue or narration segments are rendered with the correct linguistic rules and accent.
Use this feature when your course includes multilingual excerpts or when the primary language differs from the default assumption.
Multi-language support
VoiceLoom supports 23 languages, including English, Spanish, German, and Japanese. Each voice preset can handle any of these languages, allowing consistent audio style across linguistic boundaries.
Verify supported languages before integrating. Vietnamese, Indonesian, Thai, Ukrainian, Romanian, Czech, and Bengali are not supported.
- Supported: Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish.
Audio Format Selection
The API supports MP3, WAV, OPUS, FLAC, and PCM formats. Format choice depends on your LMS constraints and playback quality needs.
MP3 offers broad compatibility, while WAV provides uncompressed fidelity. OPUS delivers superior compression for efficient delivery without significant quality loss.
MP3 for web compatibility
MP3 is the default for most web players. It balances file size and quality, ensuring smooth playback across devices.
Use this format for general course content where bandwidth efficiency matters.
- Universal browser support
- Small file size
- Good quality-to-size ratio
WAV for high fidelity
WAV provides uncompressed audio. This is ideal for archival purposes or high-end audiobook experiences.
Expect larger file sizes, which may impact loading times on slower connections.
- Lossless quality
- Larger file size
- Best for archival
OPUS for efficiency
OPUS offers excellent compression. It maintains clarity while significantly reducing data usage.
Ideal for mobile users or areas with limited bandwidth.
- High compression ratio
- Maintains clarity
- Bandwidth friendly
Pricing for Long Texts
For educational platforms, predicting infrastructure costs for classic literature requires precise character accounting. Since the API charges $10 per 1 million characters, even substantial novels remain economically viable for LMS integration.
Cost calculation
The rate is $0.01 per 1,000 characters, including spaces and punctuation. Failed requests incur no charge, protecting your budget during initial quality checks. This predictable model allows product teams to allocate exact funds per course module.
- $10 per 1 million characters
- $0.01 per 1,000 characters
- Spaces and punctuation count as characters
Character counting
Accurate budgeting depends on strict character limits. The API processes up to 4,096 characters per request. You must split longer texts like 'To Kill a Mockingbird' into segments, ensuring no single request exceeds this boundary.
Budgeting for courses
Use the $0.50 trial credit to test a chapter. Calculate the total characters of your syllabus audio assets. Since balance does not expire, you can pre-purchase USDT on TRON to cover large-scale course generation without monthly subscriptions.

Testing and Validation
Validating your TTS implementation ensures the final audio meets quality standards before deployment in your LMS. Start by utilizing the free trial credit to test core functionality without financial risk.
Conduct systematic quality checks by listening to generated segments for clarity, pacing, and tone consistency. Verify that the synthetic watermark is present and that audio files play correctly across different devices.
Free trial usage
Use the $0.50 trial credit to generate approximately 50,000 characters. This allows you to test the API’s response time and audio quality before committing to a top-up.
Ensure your account is set up correctly via Google or email. Remember that trial credit is valid for 7 days, so plan your initial tests accordingly.
- Test with both 'tts-1' and 'tts-1-hd' models.
- Verify character counting accuracy.
- Check balance deduction after each request.
Quality checks
Listen for natural pacing and correct pronunciation of key literary terms. Use voices like Aria for clear narration or Milo for conversational segments to match the tone of 'To Kill a Mockingbird'.
Confirm that the audio format (MP3, WAV, or OPUS) is compatible with your LMS player. Ensure no clipping or distortion occurs in the output files.
- Check audio clarity and tone.
- Verify format compatibility.
- Ensure watermark presence.
User feedback loops
Gather feedback from beta users to assess listener engagement and comprehension. Use this data to adjust voice selection or speed settings for better user experience.
Iterate on your implementation based on user reports. This helps refine the final product for accessibility compliance and overall satisfaction.
- Collect user feedback.
- Adjust voice settings.
- Refine implementation.
Common Challenges
Product teams integrating TTS into literature-based courses often encounter operational hurdles that disrupt the user experience. Understanding these common pitfalls helps in designing robust playback systems and managing expectations for educational workflows.
Rate limiting
The API enforces a limit of 60 requests per minute per key. If your course generates audio for many chapters simultaneously, you may hit this ceiling. Requests are processed sequentially, so under heavy load, synthesis can queue, delaying audio availability.
- Monitor usage via the dashboard to anticipate limits.
- Implement retry logic with exponential backoff in your LMS.
Text splitting errors
Each request accepts up to 4096 characters. Splitting text arbitrarily can break sentences or cause abrupt audio cuts. You must split intelligently and join the resulting audio segments seamlessly to maintain narrative flow.
- Split at paragraph or sentence boundaries.
- Ensure no character limit is exceeded per request.
Audio sync issues
Since requests are queued, longer texts may experience delays. Ensure your player handles asynchronous audio loading gracefully. Test edge cases where network latency or queueing causes gaps between segments.
Best Practices
Pre-generating audio before course launch avoids queue delays during peak student activity. Since requests are processed sequentially, pre-batching ensures consistent delivery. Split long texts into 4,096-character segments to maintain predictable generation times.
Caching generated audio files reduces redundant API calls and lowers costs. Store the resulting MP3 or WAV files locally and serve them directly. This approach is especially effective for static course content that rarely changes.
Monitor your usage dashboard to track character consumption against your balance. Set alerts to avoid unexpected service interruptions. Regular reviews help optimize voice selection and format choices for your specific educational use case.
Pre-generate audio
Pre-generate audio before course launch avoids queue delays during peak student activity. Since requests are processed sequentially, pre-batching ensures consistent delivery. Split long texts into 4,096-character segments to maintain predictable generation times.
- Batch requests for new modules
- Use consistent voices for series
- Test with short samples first
Cache results
Caching generated audio files reduces redundant API calls and lowers costs. Store the resulting MP3 or WAV files locally and serve them directly. This approach is especially effective for static course content that rarely changes.
- Store MP3/WAV locally
- Invalidate cache on content updates
- Use CDN for global delivery
Monitor usage
Monitor your usage dashboard to track character consumption against your balance. Set alerts to avoid unexpected service interruptions. Regular reviews help optimize voice selection and format choices for your specific educational use case.
- Track characters per lesson
- Review monthly spending
- Adjust voice settings for clarity
Support and Resources
VoiceLoom provides essential resources to help product teams integrate TTS into their online course platforms efficiently. Our documentation covers API endpoints, voice selection, and implementation details.
For direct assistance, support is available via email. We do not offer phone support or live chat, ensuring focused and documented resolutions for your integration needs.
Documentation links
Access our comprehensive guides covering API usage, voice presets, and formatting options. These resources detail how to implement TTS for literature and other educational content.
The docs include ready-to-use cURL examples.
- API Reference
- Voice Guide
- Integration Examples
Email support
Reach our team at [email protected] for technical questions or billing inquiries. We respond promptly to all emails, ensuring you get the help you need without delay.
Our email support is the primary channel for resolving issues related to API keys, rate limits, or audio generation errors.
Community forums
While we do not host a dedicated community forum, our documentation serves as a central knowledge base for product teams building with VoiceLoom. Check our site for updates and best practices.
Conclusion
To integrate TTS into your LMS, start with clear voice selection and precise API setup. By splitting text at 4096 characters and managing formats, you ensure reliable playback for literature like 'To Kill a Mockingbird'.
Summary of steps
We navigated voice selection, technical implementation, and long-text handling to create seamless audio experiences. This structured approach ensures your courses meet accessibility standards without compromising narrative flow.
Final tips
Always set the language code explicitly for non-English texts to avoid guessing errors. Monitor your character usage closely, as pricing is strictly per 1,000 characters, including spaces and punctuation.
Next steps for product teams
Generate your audio segments now using the free trial credit. Test the API integration with your existing course player to validate speed and quality before scaling to full curriculum modules.
- Generate audio segments with the trial credit
- Validate API integration with your course player
- Scale to full curriculum modules
Listen to the 8 voices
Each sample below was generated by this API from the same sentence. Choosing the right female voice for LMS content directly influences learner retention and comprehension.
23 languages
Any voice speaks any of these languages.
