Frequently asked questions
What is text to speech in education?
Text-to-speech (TTS) converts written text into audio files via an API. You send text to the endpoint and receive an audio file. This allows educators to provide audio versions of lesson materials, reading passages, and accessibility resources for students who benefit from listening rather than reading.
How does TTS help students with dyslexia?
TTS provides an auditory alternative to reading, reducing cognitive load for students with dyslexia. By converting text to speech, it allows students to follow along with lesson materials independently. The clear, consistent voices support better comprehension.
Can I use TTS for language learning?
Yes, the API supports 23 languages including English, Spanish, French, German, Japanese, and Chinese. You can specify the language code to ensure accurate pronunciation. This allows teachers to create listening exercises, vocabulary drills, and reading comprehension audio tracks for diverse language classrooms efficiently.
Which voices are best for children?
Luna (soft, storytelling) and Nova (bright, upbeat) are suitable for children. Luna works well for reading stories, while Nova suits upbeat instructional content. You can adjust the speed between 0.25 and 4.0 to match the student’s listening pace. These voices are clear and engaging for educational materials.
How do I convert PDF text to audio?
Extract the text from your PDF and send it to the API endpoint. Since the API accepts up to 4096 characters per request, split longer texts into parts. Generate each part separately and join the resulting audio files to create a complete lesson audio track.
Is TTS suitable for all age groups?
Yes, the API serves various age groups by adjusting voice selection and speed. Use calm voices like Sage for older students or Luna for younger children. The adjustable speed (0.25–4.0) allows customization for different listening speeds, making it versatile for elementary to adult education.
Can students generate their own audio?
Students can generate audio if they have an API key. Each account holds one active key. They can send text to the endpoint to receive audio files. This encourages active learning, as students can create audio summaries or read-alouds for their own study materials.
How accurate is the speech synthesis?
The voices are based on licensed recordings from LibriTTS-R and LibriVox. They provide clear, natural-sounding speech. Accuracy depends on the input text; special characters or complex scripts may require language specification. The system guesses language from script but explicit codes ensure precision.
Does TTS work offline?
No, the API is cloud-based. You must send a POST request to the endpoint to receive audio. There is no offline mode or local SDK. Audio files are returned in the response and not stored, so you must save them locally after generation.
Can I control the speed of the audio?
Yes, you can set the speed parameter between 0.25 and 4.0. This allows you to slow down audio for younger students or speed it up for advanced learners. The default speed is 1.0.
What formats are best for mobile devices?
MP3 is widely supported on all mobile devices and offers a good balance of quality and file size. WAV and FLAC offer higher quality but larger files. OPUS and PCM are also available. MP3 is recommended for general classroom use on mobile platforms.
How do I handle special characters in text?
Send the text as UTF-8 in the JSON body. The API handles standard characters well. For complex scripts or non-standard symbols, ensure the text is clean. Spaces and punctuation count as characters in the 4096-character limit, so plan your splits accordingly.
Is the API easy to use for non-tech teachers?
Yes, the endpoint matches the OpenAI speech format. You can use the provided curl example or simple HTTP requests. The documentation includes ready-to-use code snippets. Teachers can generate audio by sending text and receiving an audio file without deep technical knowledge.
Can I use TTS for virtual classrooms?
Yes, generate audio files beforehand or in real-time if latency permits. Upload the audio to your virtual classroom platform. Since requests are processed sequentially, long texts may take time. Plan ahead for live sessions by pre-generating audio for lesson materials.
Understanding Accessibility Needs
Text-to-speech transforms static classroom materials into accessible audio, supporting diverse learning needs without requiring specialized hardware. By converting worksheets, readings, and notes into clear speech, teachers ensure that all students can engage with the same content, regardless of their reading ability or physical constraints.
Visual Impairment Support
Students with visual impairments rely on audio to access curriculum materials independently. TTS provides a consistent, reliable way to convert textbooks and handouts into listenable formats, reducing the dependency on human readers or external assistive devices during class time.
- Converts any digital text into clear audio files
- Works with standard screen readers and TTS outputs
- Ensures equal access to visual-heavy materials
Dyslexia Assistance
For students with dyslexia, reading text can be exhausting and slow. TTS allows them to listen to the material while following along, reinforcing comprehension and reducing cognitive load. This dual-coding approach helps retain information more effectively than reading alone.
- Reduces reading fatigue and strain
- Supports simultaneous listening and reading
- Improves comprehension of complex texts
Auditory Learning Styles
Some students process information best through hearing. TTS caters to these auditory learners by delivering content in a clear, narrative format. This method reinforces lessons through repetition and varied pacing, helping students grasp concepts more naturally.
- Caters to auditory processing preferences
- Reinforces learning through repeated audio exposure
- Allows adjustable speed for better retention
Choosing the Right Voice
Selecting the appropriate voice ensures students can process information without distraction. VocalClass offers distinct presets designed to match different teaching contexts, from warm narration to neutral delivery.
The right choice reduces cognitive load, allowing learners to focus on content rather than struggling to distinguish speech patterns. This is particularly important for students with attention difficulties or auditory processing needs.
Clear Narration for Clarity
For reading comprehension lessons, use Aria or Nova. Aria’s warm, clear tone works well for stories, while Nova’s bright, upbeat style keeps energy high during active reading sessions.
- Use Aria for narrative texts and stories.
- Use Nova for interactive or upbeat reading materials.
- Both voices support natural pause patterns.
Neutral Tone for Focus
For dense instructional content or exam preparation, Atlas or Sage provide minimal distraction. Atlas offers a neutral, news-like delivery ideal for factual material. Sage’s calm, instructional tone is effective for step-by-step instructions or math explanations where clarity is paramount.
These voices avoid emotional inflection that might distract students, ensuring the focus remains on the information itself. This is especially useful for students with sensory sensitivities who may find expressive voices overstimulating.
- Use Atlas for factual or news-style content.
- Use Sage for instructional steps and math.
- Neutral tones reduce auditory distraction.
Pacing and Speed Control
Adjust the speed parameter between 0.25 and 4.0 to match individual student needs. Slower speeds (0.5–0.8) aid students with dyslexia or auditory processing disorders by giving them time to process each word. Faster speeds (1.2–1.5) can help advanced readers keep up with natural conversation pace.
You can also set a specific language code (e.g., 'en') to ensure consistent pronunciation, especially when mixing languages. This prevents the system from guessing incorrectly and disrupting the learning flow.
- Set speed 0.25–4.0 based on student needs.
- Use slower speeds for dyslexia support.
- Set explicit language codes for consistency.
Integrating into Lesson Plans
VocalClass allows educators to convert standard text materials into accessible audio formats quickly. By sending lesson text to the API endpoint, teachers receive ready-to-use audio files that support diverse learning needs without complex software installations.
Converting Text Worksheets
Upload worksheet content directly via the API. The system processes up to 4,096 characters per request, generating MP3 or WAV files (generation takes a few seconds for short phrases). This enables students with visual impairments to listen to reading comprehension tasks during class.
- Supports 23 languages for global classrooms
- Simple JSON payload for easy integration
- Immediate audio delivery for quick distribution
Creating Audiobooks
Split longer texts into manageable segments using the character limit. Generate consistent audio narrations using voices like Aria or Atlas. This creates reliable study aids for students who struggle with reading dense academic texts.
- Voice options for varied narrative styles
- Automatic splitting for long chapters
- Uniform tone across all segments
Language Learning Tools
Use the language parameter to ensure accurate pronunciation for non-native speakers. Generate audio for vocabulary lists or dialogue exercises. Students can listen repeatedly to improve listening skills and mimic natural speech patterns.
- Explicit language code support
- Clear articulation for practice
- Works with existing curriculum texts
Technical Setup for Schools
Setting up VocalClass for classroom use involves minimal configuration. Schools can manage access securely while ensuring students receive consistent audio formats that work across devices.
The technical requirements are straightforward, relying on standard web technologies and simple API calls that educators or IT staff can implement without specialized infrastructure.
API Key Management
Each account generates a single active API key. You can issue a new key at any time, which immediately invalidates the previous one. This ensures that if a key is compromised or a teacher leaves, access is revoked instantly without complex permission trees.
Keys are prefixed with tts- and sent in the Authorization header. Rate limits are set to 60 requests per minute, which is sufficient for standard lesson preparation.
- Issue new keys instantly; old keys stop immediately.
- One key per account simplifies tracking.
- Standard Bearer token authentication.
Simple Code Integration
The API mimics the OpenAI speech endpoint structure. By changing the base_url to https://api.playt999.com/v1, existing OpenAI SDKs work directly. This allows teachers to use familiar libraries or simple HTTP requests to send text and receive audio files.
A typical request involves sending a JSON body with the model, input text, voice, and response_format. The response returns the audio file directly, ready to be played or downloaded.
- Use standard OpenAI SDKs with modified base URL.
- JSON request body structure.
- Direct audio file response.
Browser Compatibility
Generated audio files in MP3 or WAV formats play natively in all modern browsers without additional plugins. (OPUS, FLAC, and PCM are also supported formats). This ensures that audio worksheets and audiobooks load instantly in Chrome, Firefox, Safari, and Edge without requiring students to install extra software.
For dynamic web apps, the audio can be streamed directly to HTML5 <audio> elements. The consistent format support simplifies integration into existing learning management systems or custom classroom websites.
- Native support in major browsers.
- No plugins required for MP3/WAV.
- Supports HTML5 audio standards.
Monitoring Usage and Costs
Transparent billing is essential for classroom budgets. VocalClass charges $10 per million characters, making costs predictable. Failed requests are free, so you only pay for successful audio generation.
Tracking Character Usage
Monitor your dashboard to see exactly how many characters you have used. Each request counts spaces and punctuation. This helps you plan long texts by splitting them into 4096-character parts.
- Check balance via the API key page
- Count spaces as characters
- Split long texts for efficiency
Budgeting for Classes
With a flat rate of $0.01 per 1,000 characters, you can estimate costs before generating audio. Use the free trial credit to test volume without spending your main balance.
- Estimate costs per lesson
- Use trial credit for testing
- No hidden fees or subscriptions
Free Trial Utilization
Sign in with Google to receive $0.50 in trial credit, valid for 7 days. This allows approximately 50,000 characters of audio generation, perfect for testing voice quality and integration speed.
- Google sign-in required
- 7-day validity period
- No credit card needed
Data Privacy Considerations
Educators must ensure student privacy when generating audio from classroom texts. VocalClass processes input text solely to produce the audio file and does not use it for training models. The generated audio is returned in the response and is not stored on our servers, minimizing data retention risks.
This approach keeps student-specific content transient. You retain full control over the generated files, deciding where they are saved or shared with students.
Student Data Protection
Text input is used exclusively for synthesis and discarded after delivery. No personal student identifiers are required by the API, allowing you to anonymize texts before sending them. This ensures that even if logs are reviewed, they contain only technical metadata like character count and timestamp, not the educational content itself.
- Input text is not used for training.
- Metadata kept only for billing.
- No PII required by the API.
No Audio Storage
Generated audio files are streamed directly to your application or browser and are not archived by VocalClass. This means we do not hold copies of your lesson recordings, reducing liability and storage dependencies. You manage the lifecycle of the audio files entirely within your own classroom management system.
- Audio returned in response.
- Not stored on our servers.
- You control the files.
Text Usage Policy
Since text is not retained for model improvement, you can confidently upload proprietary worksheets or sensitive student essays. The only data preserved is request metadata (time, characters, status) necessary for accurate billing and rate limit management. This transparent policy ensures that your educational materials remain private and secure throughout the generation process.
- Text used only for synthesis.
- Metadata kept for billing.
- Proprietary content remains private.

Common Challenges and Solutions
Educators often encounter technical hurdles when integrating TTS into daily workflows. Long texts require splitting, rate limits can pause generation during peak hours, and app errors need clear handling to avoid disrupting lessons.
These challenges are manageable with straightforward adjustments. By understanding the API’s constraints, teachers can ensure smooth audio delivery for students without technical interruptions.
Handling Long Texts
The API accepts up to 4096 characters per request. For longer worksheets or stories, split the text into parts, generate each audio file, and join them sequentially.
This ensures consistent quality and avoids truncation. Use simple code to automate the splitting and merging process for efficiency.
- Split text into 4096-character chunks
- Generate audio for each chunk
- Merge audio files sequentially
Managing Rate Limits
Each API key allows 60 requests per minute. During peak usage, such as preparing materials for a whole class, requests may queue.
Plan ahead by generating audio files during off-peak hours or distributing requests over time to avoid delays.
- Limit: 60 requests/minute per key
- Requests queue under load
- Generate content during off-peak hours
Error Handling in Apps
If synthesis fails, the charge is returned in full. Implement retry logic with exponential backoff to handle temporary failures gracefully.
Check response status codes to identify issues like invalid characters or network errors. Provide clear feedback to users if generation fails.
- Retry failed requests with backoff
- Check response status codes
- Display user-friendly error messages
Best Practices for Educators
Consistency reduces cognitive load, so select one voice per curriculum unit rather than switching randomly between presets like Aria and Felix. This helps students focus on content rather than adjusting to new vocal tones or pacing styles during reading tasks.
Consistent Voice Selection
Stick to a single voice for a specific module. For example, use Sage for instructional texts and Luna for storytelling. This uniformity allows students with visual impairments or dyslexia to recognize the audio style quickly, improving comprehension and reducing fatigue during long lessons.
- Assign one voice per topic unit
- Avoid mixing narration styles in single assignments
- Use neutral tones like Atlas for factual data
Testing Audio Quality
Always preview generated audio before distributing it to students. Check for clarity at your intended playback speed, ensuring the 0.25–4.0 range suits the audience. Short phrases may take a few seconds to generate, so plan your lesson timing accordingly to avoid delays during live demonstrations.
Verify that the selected format (mp3, wav, or opus) plays correctly on school devices. Since requests are processed sequentially, test long texts by splitting them to ensure seamless joining of audio parts without gaps or distortion.
Student Feedback Loops
Gather feedback on which voice aids their understanding best. Ask students if the speed feels natural or if certain tones cause distraction. Use this input to refine your voice selection for future units, ensuring the audio supports rather than hinders accessibility.
Regularly check usage metrics to see if specific audio files are re-listened to more often, indicating high value or difficulty. Adjust your materials based on these patterns to keep content engaging and accessible for all learning styles.
Support and Resources
VocalClass provides dedicated support to help educators integrate TTS smoothly into their teaching workflow. If you encounter issues with API keys, voice selection, or billing, our team is ready to assist via email. We focus on practical solutions for classroom needs, ensuring you can generate audio for your lessons without unnecessary delays.
Accessing the right resources is key to efficient implementation. Our documentation offers clear guides for educators, covering everything from basic integration to managing character limits.
Email Support Contact
For direct assistance, contact our support team at [email protected]. We handle queries related to API usage, account management, and technical issues. Please include your API key prefix and a description of the problem in your email for faster resolution.
- Response time: within 24 hours on business days
- No phone number or live chat available
- Email is the only support channel
Documentation Access
Our documentation at https://playt999.com/docs/ provides step-by-step instructions tailored for educators. It covers API endpoints, voice options, and code examples in Python and JavaScript. You can also find troubleshooting guides for common integration issues.
The docs include specific sections on accessibility features, such as speed control and language settings, to help you create inclusive audio materials for diverse student needs.
- Clear API reference
- Code examples for popular languages
- Accessibility-specific guides
Community Guides
Explore community resources shared by other educators to see how others are using VocalClass in their classrooms. These guides offer practical tips on lesson planning, voice selection, and managing audio files for students.
Stay informed about best practices for integrating TTS into your teaching methodology.
- Practical lesson plan examples
- Voice selection tips
- Newsletter for updates
Future-Proofing Your Tools
As your digital resources grow, the API handles increasing request volumes without requiring infrastructure changes. Simply split long texts into 4096-character segments to maintain steady generation speeds and avoid queue delays during peak usage.
Support diverse classrooms with 23 languages, ensuring every student hears content in their native tongue. Use the optional language parameter to guarantee accuracy for non-English Latin-script texts, preventing misinterpretation of phonetic cues.
Scalable API Usage
The API processes requests sequentially, so plan for longer texts by splitting them into chunks of 4096 characters. This approach ensures consistent audio quality and prevents bottlenecks during high-demand periods like exam season.
- Split long texts into 4096-character segments
- Monitor rate limits (60 req/min)
- Process requests sequentially for stability
Multi-Language Support
Access 23 languages including English, Spanish, Chinese, and Arabic. Specify the ISO language code to ensure correct pronunciation, especially for non-English texts in Latin script that might otherwise default to English.
- 23 supported languages
- Explicit language coding for accuracy
- No need for separate voices per language
Format Flexibility
Choose from MP3, WAV, OPUS, FLAC, or PCM formats. Select MP3 for web integration or WAV for high-quality offline playback in classrooms without reliable internet connections.
- MP3, WAV, OPUS, FLAC, PCM
- Optimize for web or offline use
- Standard compatibility with all players
Conclusion and Next Steps
VocalClass provides a reliable, straightforward way to make classroom materials accessible without complex infrastructure. By focusing on clear audio generation and transparent pricing, educators can support diverse learning needs efficiently.
Start with Free Trial
Begin by signing up with Google to receive $0.50 in free credit. This allows you to generate approximately 50,000 characters of audio to test quality and workflow without any financial commitment.
Explore Voice Options
Review the eight available voices to find a fit for your content. Clear narrators like Aria or neutral tones like Atlas work well for reading assignments, while warmer voices may suit storytelling sessions.
Integrate Gradually
Start by converting a single worksheet or short text. Once the API integration is stable, expand to full lesson plans or language learning materials, ensuring consistent pacing and format compatibility across your digital resources.
Listen to the 8 voices
Each sample below was generated by this API from the same sentence. Effective teaching strategies empower educators to adapt dynamically to diverse classroom needs and foster meaningful student engagement.
23 languages
Any voice speaks any of these languages.
