Frequently asked questions
What is a Python TTS module?
It is a cloud text-to-speech API that converts text into audio files. You send a POST request with your text and receive an audio file in return. It works by changing the base URL in the official OpenAI SDKs to our endpoint. This allows educators to automate audio generation for lesson plans using simple Python scripts without managing infrastructure.
How does the Python TTS module differ from browser extensions?
Unlike browser extensions, this is a programmatic API accessed via HTTP requests. It does not rely on browser-specific plugins or extensions. You control the input text, voice selection, and output format directly through code. This makes it ideal for integrating audio generation into custom educational platforms or automated workflows rather than just reading web pages.
Is the Python TTS module suitable for reading long textbooks?
Yes, but you must split texts into parts of up to 4096 characters per request. You can join the resulting audio files to create a complete long-form recording. Typical generation speed is roughly real time, so long texts take a comparable amount of time to generate. Requests are processed sequentially, so high volume may cause queuing.
Can I use the Python TTS module for students with dyslexia?
Yes, the API provides clear, synthetic speech voices like Aria or Nova that can aid reading comprehension. The generated audio files carry an inaudible watermark marking them as synthetic. Input text is used only to produce the audio and is not used for training, ensuring privacy for student materials while providing an accessible reading alternative.
Does the Python TTS module support multiple languages?
It supports 23 languages, including English, Spanish, French, German, Chinese, Japanese, and Arabic. Any voice can speak any of these languages. If the language parameter is omitted, the system guesses the language, defaulting to English for Latin script. You should explicitly set the language for non-English Latin-script text to ensure accuracy.
How much does it cost to use the Python TTS module in a school?
Pricing is $10 per 1 million characters, or $0.01 per 1,000 characters. Spaces and punctuation count toward this total. Failed requests are free, with charges returned in full. There are no monthly plans, seats, or minimum spends. Schools pay only for the characters they actually convert, making it scalable for varying classroom needs.
Is there a free trial for the Python TTS module?
Yes, signing in with Google provides $0.50 of credit, valid for 7 days, which covers about 50,000 characters. Accounts created with email and password start without this trial credit. You can top up using USDT on the TRON network. The balance does not expire, allowing you to test the API before committing to larger volumes.
Do I need to pay for each student's usage separately?
No, you pay for the API key’s usage, not per student. One active key is issued per account. You can generate audio for as many students as you want using the same key. There are no per-seat licenses or additional fees for individual users. You simply manage the character consumption from your account balance.
Can I adjust the speed of the audio in Python?
Yes, you can set the speed parameter between 0.25 and 4.0 in your request. This allows you to slow down audio for younger students or speed it up for advanced readers. The default speed is 1.0. This adjustment is made directly in the JSON body of your API request, offering precise control over playback rate.
What audio formats are supported by the Python TTS module?
The API supports MP3, WAV, OPUS, FLAC, and PCM formats. You specify the desired format in the response_format field of your request. This flexibility allows you to choose between compressed files for easy sharing or lossless formats for high-quality archival. The audio is returned directly in the API response for immediate use in your applications.
How is the quality of the generated audio?
Voices are based on licensed recordings from LibriTTS-R and LibriVox public-domain audiobook readings. Every file carries an inaudible watermark identifying it as synthetic speech. The engine offers two models, tts-1 and tts-1-hd, with the same price. The audio is clear and natural, designed for educational content, though it is distinctly synthetic rather than human-recorded.
Is the Python TTS module reliable for live presentations?
It is designed for generating audio files rather than real-time streaming or WebSocket playback. Requests are processed sequentially, so under load, a request may wait in a queue. Short phrases take a few seconds to generate. For live presentations, you should pre-generate the audio files. The API does not support WebSocket or streaming endpoints for instant playback.
Do I need technical skills to use this module?
Basic programming knowledge is helpful but not strictly required. The API uses a standard JSON format compatible with the OpenAI SDKs. You can use the provided curl examples or simple Python scripts to send requests. The documentation includes ready-to-use curl examples. However, integrating it into custom workflows or handling character splitting requires some technical understanding.
How is my data handled when using the module?
Input text is used only to produce the audio and is not used for training. Generated audio is returned in the response and not stored on our servers. Request metadata, such as time, character count, and status, is kept for billing purposes. We do not store the actual audio files; request metadata is kept for billing.
First request
curl
curl https://api.bet4x.top/v1/audio/speech \
-H "Authorization: Bearer $TTS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tts-1","voice":"aria","input":"Hello from the API.","response_format":"mp3"}' \
--output hello.mp3Why Python for School TTS?
Python’s straightforward syntax allows educators to convert lesson plans into audio without complex infrastructure. By sending text to a single API endpoint, teachers can generate clear narration files that students can access on any device, reducing the friction of distributing new reading materials.
Simple integration for lesson plans
Educators can write simple scripts to transform static text into spoken word. The process requires only a few lines of code, making it accessible for school developers who need to create accessible content quickly without hiring specialized audio engineers.
Automate audio creation for students
Requests are processed sequentially, so generating audio for entire chapters may take longer than minutes depending on the text length and queue load. Instead of manual recording, Python scripts handle the volume, ensuring consistent quality across all materials while freeing up teacher time for instruction.
Support for diverse learning needs
Students with dyslexia or auditory processing differences benefit from on-demand audio. The API supports 23 languages and adjustable speeds, allowing learners to adjust playback to their individual comprehension pace.
Available Voices for Education
VoxEd provides eight voice presets based on licensed recordings from LibriTTS-R and LibriVox. These voices are derived from licensed recordings, ensuring high-quality, consistent audio for educational materials.
Clear narrator voices for reading
Aria offers a warm, clear tone ideal for narrating lesson plans and reading materials. Her voice ensures that text is delivered with clarity, making it easier for students to follow along.
- Aria: Warm, clear narrator
- Luna: Soft, storytelling tone
Calm tones for instructions
Sage provides a calm, instructional voice perfect for delivering step-by-step directions or exam guidelines. Milo’s friendly, conversational style works well for interactive learning modules, keeping students engaged without distraction.
- Sage: Calm, instructional
- Milo: Friendly, conversational
Distinct voices for character roles
For literature or drama lessons, voices like Felix (energetic) and Orion (deep, documentary) add distinction to character roles. This variety helps students differentiate between narrative voices, enhancing the listening experience.
- Felix: Energetic, promo style
- Orion: Deep, documentary style
- Atlas: Neutral, news style
- Nova: Bright, upbeat tone
Supported Languages in Classrooms
VoxEd supports 23 languages, enabling multilingual schools to convert reading materials into audio for diverse student bodies. The API handles major European and Asian languages, ensuring accessibility across different linguistic groups without requiring separate integrations for each region.
23 languages for multilingual schools
We provide support for Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, and Turkish. This range covers the primary languages spoken in many international classrooms.
- Arabic, Chinese, Danish, Dutch, English
- Finnish, French, German, Greek, Hebrew
- Hindi, Italian, Japanese, Korean, Malay
- Norwegian, Polish, Portuguese, Russian, Spanish
- Swahili, Swedish, Turkish
Automatic language detection
The API guesses the language from the script, defaulting to English for Latin text. This simplifies your Python scripts, as you often do not need to specify the language parameter explicitly.
Support for major European and Asian languages
Key languages like English, Spanish, French, German, Japanese, and Korean are fully supported. Note that Vietnamese, Indonesian, Thai, Ukrainian, Romanian, Czech, and Bengali are not currently available. For non-English Latin text, set the language field to ensure accurate synthesis.
Technical Specifications
The API accepts text inputs up to 4,096 characters per request. For longer lesson plans, split the text into chunks and join the resulting audio files. Short phrases may take a few seconds to generate, while longer texts process at roughly real-time speed.
4096 character limit per request
Each API call handles a maximum of 4,096 characters. If your educational material exceeds this length, divide the content into manageable segments. The system processes requests sequentially, so under heavy load, a request might wait in a queue before synthesis begins.
Multiple audio formats (MP3, WAV)
Choose from MP3, WAV, Opus, FLAC, or PCM formats. MP3 and WAV are standard for most learning management systems and classroom devices. The choice of format does not affect the pricing, which remains consistent at $0.01 per 1,000 characters.
Adjustable speed for clarity
Adjust speech speed between 0.25x and 4.0x. Slower speeds enhance comprehension for students with reading difficulties or those learning the language. Faster speeds suit review sessions. The default speed provides a natural pace suitable for most instructional content.
Pricing for Educational Use
VoxEd charges a flat rate of $10 per million characters, making it easy to budget for large-scale classroom projects. Failed requests are refunded in full, ensuring you only pay for successful audio generation.
This transparent model eliminates hidden costs, allowing schools to scale usage without worrying about complex tiered pricing or unexpected overages.
Pay per character, not per minute
Each character counts, including spaces and punctuation. At $0.01 per 1,000 characters, generating a 4,000-character lesson plan costs just $0.04. This predictable cost structure helps educators estimate expenses for entire reading materials or curriculum sets.
Audio length varies by speed and voice, but character count remains the consistent billing metric, simplifying financial planning for departments.
- $10 per 1,000,000 characters
- $0.01 per 1,000 characters
- Spaces and punctuation count
- Failed requests are free
No monthly subscriptions
There are no monthly plans, seats, or minimum spend requirements. You top up your account using USDT on the TRON network, with a minimum deposit of $5. Credits never expire, so unused funds remain available for future semesters.
This pay-as-you-go approach suits schools with fluctuating needs without locking you into long-term contracts.
Free trial for new accounts
Sign up with Google to receive $0.50 in trial credit, valid for seven days. This allows you to generate approximately 50,000 characters to test voice quality and integration before committing to a top-up. Email-based accounts start without trial credit.
The trial provides a risk-free way for teachers and developers to verify that the API meets their specific audio requirements.
Data Privacy for Students
VoxEd prioritizes student data protection by treating input text as a transient asset. When educators submit lesson plans or reading materials, the text is transmitted solely to generate the required audio file. Once the synthesis is complete, the generated audio is returned in the response and not stored on our servers for later retrieval or analysis.
Text used only for generation
The system processes your text exclusively to produce the audio output. There is no secondary use of the content for other purposes, ensuring that the educational material remains confined to its immediate functional use.
No training on input data
Unlike some consumer-grade services, the text you submit is not used to train or improve our underlying machine learning models. Your school’s specific curriculum and reading materials remain your intellectual property, unaffected by our model updates.
Synthetic watermarking
Every audio file generated through our API carries an inaudible watermark. This marks the file as synthetic speech, providing transparency for students and administrators who consume the audio content, distinguishing it from human-recorded lessons.
How It Works
Generating educational audio with VoxEd is a straightforward process that integrates directly into your existing Python workflows. By leveraging standard HTTP requests or the OpenAI SDK, educators and developers can convert lesson plans and reading materials into listenable content with minimal code overhead.
The system handles the heavy lifting of synthesis, ensuring that your audio files are generated quickly and reliably. Whether you are preparing materials for a single class or an entire school district, the API provides a consistent and accessible way to deliver audio content to students.
Send text via Python
Start by installing the official OpenAI Python SDK and pointing it to the VoxEd API base URL: https://api.bet4x.top/v1. Pass your text input (up to 4,096 characters) along with your desired voice preset, such as 'aria' for clear narration or 'sage' for instructional tone.
Include your API key in the authorization header. The request format mirrors standard TTS endpoints, making it easy to adapt existing scripts without learning a new library.
- Use
tts-1ortts-1-hdmodels - Set voice presets like 'aria' or 'nova'
- Specify response format (mp3, wav, opus)
Receive audio file
Upon successful submission, the API returns the audio file directly in the response body. You can save this binary data to a local file or stream it to your application’s audio player.
Failed requests are free, ensuring you are only charged for successful synthesis. The audio file includes an inaudible watermark to mark it as synthetic speech, suitable for educational distribution.
- Direct binary response
- Includes synthetic watermark
- Zero charge on failure
Split long texts easily
For texts exceeding 4,096 characters, split the input into chunks and send them sequentially. Join the resulting audio files programmatically to create a continuous listening experience for students.
This approach ensures high-quality synthesis for each segment while maintaining the integrity of the original lesson plan or reading material.
Comparison with Traditional Methods
Traditional audio creation in schools often relies on teachers recording lessons manually or hiring external voice actors, a process that is both time-consuming and costly for large volumes of content. While human recording offers a personal touch, it requires significant preparation, studio time, and editing effort to achieve a clean final product suitable for student consumption.
Faster than manual recording for short segments
For individual lesson plans or reading passages, generating audio via API takes seconds rather than the minutes or hours required to set up microphones, record, edit, and export files. A typical phrase generates in a few seconds, and long texts process at roughly real-time speed, allowing teachers to convert materials on the fly without waiting for external production cycles.
Consistent voice quality
Human voice actors may experience fatigue or variations in tone across different recording sessions, leading to inconsistent audio quality across a curriculum. Our API delivers uniform clarity and pacing for every request, ensuring that all students receive audio with the same professional standard, whether it is the first paragraph or the last chapter of a textbook.
Scalable for entire schools
Manual recording does not easily scale when entire departments need to convert hundreds of pages of reading materials simultaneously. With a simple Python script, schools can automate the conversion of entire libraries, leveraging multiple voices and languages without needing to coordinate schedules for multiple voice talent. This allows educational institutions to maintain high accessibility standards across all grade levels efficiently.
Get Started with Python
Getting started with VoxEd requires minimal setup, leveraging the familiar OpenAI Python ecosystem. By adjusting a single configuration parameter, educators can integrate text-to-speech directly into their existing lesson preparation workflows without learning a new SDK.
Install the OpenAI SDK
Use pip to install the standard library: pip install openai. This provides the necessary tools to handle JSON requests and audio responses efficiently.
Configure base URL
Set your API key and point the client to our endpoint. Replace base_url with https://api.bet4x.top/v1 to ensure requests route correctly to the VoxEd infrastructure.
- Use your unique
tts-...key from the dashboard. - Ensure the base URL matches
https://api.bet4x.top/v1.
First generation test
Send a short text payload to POST /v1/audio/speech. The API returns an audio file directly, ready for download or immediate playback in your educational materials.
- Start with texts under 4096 characters.
- Choose a voice like 'aria' for clear narration.
Listen to the 8 voices
Each sample below was generated by this API from the same sentence.
23 languages
Any voice speaks any of these languages.