Frequently asked questions
What is a Python TTS library?
A Python TTS library is a software package that allows you to send text to a cloud API and receive an audio file. For LMS workflows, it enables automated conversion of course materials into speech. You can integrate it easily using standard HTTP requests or the OpenAI SDK, adapting the base URL to our endpoint for seamless programmatic audio generation.
How does TTS differ from human narration?
Generated audio carries an inaudible watermark marking it as synthetic speech. While voices are based on licensed recordings from LibriTTS-R and LibriVox, they lack the nuanced emotion and variation of human narrators. The engine generates audio at roughly real-time speed, processing requests sequentially, which means latency may vary under load compared to pre-recorded human tracks.
Which is better for LMS: MP3 or WAV?
MP3 offers smaller file sizes, ideal for efficient bandwidth usage in learning management systems. WAV provides uncompressed quality. Both formats are supported alongside Opus, FLAC, and PCM. Choose MP3 for standard web delivery to save storage and load times, or WAV if your LMS requires lossless audio for specific playback environments.
Can I use the OpenAI SDK with this API?
Yes. The API endpoint matches the OpenAI speech endpoint shape. You can use the official OpenAI SDK by changing the base_url to https://api.788t.info/v1 and providing your site-specific key. This allows you to leverage existing Python code and SDK features without rewriting your integration logic for a custom client.
How many characters can I send per request?
You can send up to 4096 characters per request. For longer course materials, split the text into parts of this size and join the resulting audio files. Spaces and punctuation count toward the character limit. This ensures consistent processing speed and allows you to manage audio chunking within your LMS integration logic.
What languages are supported?
We support 23 languages, including English, Spanish, German, French, Chinese, Japanese, and Arabic. Any voice can speak any supported language. If you do not set the language field, it guesses from the script, defaulting to English for Latin text. Vietnamese, Indonesian, Thai, and Ukrainian are not supported.
Are the voices realistic or robotic?
Voices are based on licensed recordings from LibriTTS-R and LibriVox public-domain audiobooks. They sound natural but carry an inaudible watermark indicating synthetic speech. They do not have emotion tags or custom voice cloning. The tone is clear and consistent, suitable for instructional content, but lacks the variability of human performance.
Do I need to pay monthly?
No. There are no monthly plans, subscriptions, or minimum spends. You pay $0.01 per 1,000 characters. You top up your balance using USDT on the TRON network. Your balance does not expire, and you only pay for the characters you generate. Failed requests are free.
Is my course content used for training?
No. 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. We keep request metadata like time and status for billing purposes, but your specific course content remains private and is not part of any training dataset.
What happens if a request fails?
If synthesis fails, the charge is returned in full. You are not billed for failed requests. This ensures you only pay for successfully generated audio files. You can retry the request or split the text further if the failure was due to input constraints or temporary queue delays.
Can I clone my own voice?
No. We do not offer custom voice cloning for customers, nor do you upload your own voice. You choose from 8 preset voices based on licensed recordings. Custom voice design or cloning features are not part of this API. If you need a specific voice, you must select from the available presets.
Is there an SLA for uptime?
No. We do not provide an SLA, uptime guarantee, or enterprise contract. Requests are processed sequentially, so under load, a request may wait in a queue. Typical speed is roughly real time, but latency can vary. We do not offer on-premise installs or data-center choices to guarantee specific availability.
How do I top up my balance?
Top up using USDT on the TRON network (TRC-20). The minimum amount is $5. Credits are added automatically within minutes after the transfer. We do not accept cards, PayPal, or invoices. You can manage your balance and view usage details on your account dashboard after signing in.
Who are the voices based on?
Voices are based on licensed recordings from LibriTTS-R (CC BY 4.0) and LibriVox public-domain audiobook readings. This provides a foundation of clear, narrated speech. The eight presets (like Aria, Nova, Felix) are derived from these sources, offering distinct tones suitable for educational content without requiring human narration for every course.
First request
curl
curl https://api.788t.info/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.mp3How it works
LectioLab converts text into audio files via a simple HTTP POST request. You send your course material as JSON, and the API returns an audio file ready for your LMS.
The service uses a standard request shape compatible with the OpenAI SDKs. This allows seamless integration into existing Python workflows without learning a new protocol.
Send text, receive audio
Send a string of up to 4096 characters to the /v1/audio/speech endpoint. The system processes the text and returns an audio file in your chosen format (mp3, wav, opus, flac, pcm). Long texts should be split into parts and joined later.
Standard JSON format
The API accepts a JSON body with fields for model, input, voice, and response_format. This structure is consistent and predictable, making it easy to parse responses in Python using standard libraries or requests.
- Use
tts-1ortts-1-hdfor the model - Specify voice from 8 presets
- Set speed between 0.25 and 4.0
OpenAI SDK compatible
The endpoint mirrors the OpenAI speech API. You can use the official OpenAI Python SDK by changing the base_url to https://api.788t.info/v1 and providing your LectioLab key. This reduces integration time for developers already familiar with the OpenAI ecosystem.
Voices and languages
Generate consistent audio for your course materials using eight distinct voice presets, ranging from warm narrators to deep documentary styles. Each voice is based on licensed recordings from LibriTTS-R (CC BY 4.0) and LibriVox public-domain audiobook readings.
8 preset voices
Select from female voices like Aria (warm narrator) and Nova (bright, upbeat), or male options such as Felix (energetic) and Atlas (neutral news). These presets cover instructional, storytelling, and conversational tones suitable for various teaching styles.
- Aria: Warm, clear narrator
- Nova: Bright, upbeat
- Luna: Soft, storytelling
- Sage: Calm, instructional
- Felix: Energetic, promo
- Milo: Friendly, conversational
- Atlas: Neutral, news
- Orion: Deep, documentary
23 supported languages
Support your global student base with audio in 23 languages, including English, Spanish, German, Japanese, and Arabic. The API handles diverse linguistic requirements for international courses without needing separate voice models for each region.
- Arabic, Chinese, Danish, Dutch
- English, Finnish, French, German
- Greek, Hebrew, Hindi, Italian
- Japanese, Korean, Malay, Norwegian
- Polish, Portuguese, Russian, Spanish
- Swahili, Swedish, Turkish
Language detection
The API automatically guesses the language based on the text script, defaulting to English for Latin text. For non-English Latin-script content, explicitly set the language parameter to ensure accurate synthesis and avoid mispronunciation.
Use cases for LMS
LectioLab enables teachers to convert static course materials into accessible audio files. By sending text via our standard API, educators can generate MP3 or WAV files that integrate seamlessly into Learning Management Systems, supporting diverse learning styles without manual recording.
Audio versions of PDFs
Convert lecture notes and reading materials into audio. Use Python scripts to process text up to 4096 characters, splitting longer documents as needed. The resulting audio files are ready for direct embedding in LMS modules.
- Supports PDF extraction workflows
- Handles text splitting automatically
- Generates standard MP3/WAV files
Accessible course content
Provide inclusive resources for students with dyslexia or visual impairments. Generate clear narration using preset voices like Aria or Milo. Ensure compliance with accessibility standards by offering audio alternatives to text-heavy course pages.
- Clear narration for diverse needs
- Multiple voice presets available
- Easy integration with LMS
Automated announcements
Create timely audio announcements for course updates. Trigger API calls from your LMS to generate voice messages for deadlines or reminders. Use the speed parameter to adjust pacing for quick updates or detailed explanations.
- Automate routine notifications
- Adjustable speech speed
- Integrates with LMS triggers
Technical specs
The API follows the standard OpenAI JSON schema, allowing direct integration using existing OpenAI Python SDKs by simply adjusting the base_url to https://api.788t.info/v1. This eliminates the need for a proprietary library, enabling immediate deployment within your LMS backend or course generation scripts.
Authentication relies on a single active API key per account. You can regenerate this key at any time via the dashboard, ensuring that the previous key becomes invalid immediately upon issuance. This simplifies credential management across multiple teaching assistants or automated grading scripts.
Python library integration
Leverage the official OpenAI Python client by setting base_url to https://api.788t.info/v1. Pass your tts-... key in the Authorization header. The request body mirrors the standard speech endpoint, supporting model, input, voice, response_format, and optional speed parameters.
This compatibility means you can swap the base URL in existing scripts without rewriting request logic. Use standard JSON serialization to send text and receive binary audio data directly in your Python environment.
- Compatible with official OpenAI Python SDKs
- Standard JSON request body
- No custom client required
Rate limits (60 req/min)
Each API key is limited to 60 requests per minute. New accounts without a top-up start with a lower limit of 10 requests per minute. This ensures fair usage across the shared infrastructure while allowing steady generation for course materials.
Requests are processed sequentially. Under load, your synthesis job may wait in a queue before processing begins. Plan your batch sizes accordingly to avoid throttling during peak teaching hours.
- 60 requests per minute per key
- 10 req/min for new accounts without top-up
- Sequential processing with potential queueing
Character limits (4096)
Each API request accepts a maximum of 4096 characters for the input field. For longer course lectures or textbook chapters, split the text into chunks of this size and concatenate the resulting audio files in your script.
Spaces and punctuation count toward the character limit. A typical long text generates audio at roughly real-time speed, taking about 25 characters of text per second of audio. Short phrases may take a few seconds to process.
- Max 4096 characters per request
- Split long texts manually or via script
- Spaces and punctuation count as characters
Pricing model
LectioLab charges $0.01 per 1,000 characters, with spaces and punctuation counted. Failed requests are refunded in full. A free trial provides $0.50 credit (50,000 characters) valid for 7 days upon Google sign-in.
This model eliminates recurring costs. You only pay for what you generate, making it ideal for variable course production schedules. Balances do not expire, allowing you to store credits for future semesters.
Pay per character
The standard rate is $10 per 1 million characters. This flat rate applies to both tts-1 and tts-1-hd models, ensuring consistent budgeting for your audio content.
Each request processes up to 4096 characters. Longer texts are split and joined seamlessly, so you pay only for the actual character count used in successful synthesis.
- $0.01 per 1,000 characters
- Failed requests are free
- No hidden fees per format
No monthly fees
There are no subscriptions, seats, or minimum spends. You can stop using the API at any time without penalty. This structure suits educators who generate audio sporadically or only during specific course launches.
Accounts start without trial credit if created with email/password. Google sign-in provides immediate access to the $0.50 trial balance for testing integration.
- No monthly subscriptions
- No minimum spend
- No seat limits
USDT top-up
Top-ups are processed via USDT on the TRON network (TRC-20). The minimum deposit is $5, and balances are credited automatically within minutes of the transfer.
We do not support credit cards, PayPal, or invoices with VAT. This streamlined method keeps overhead low and ensures your API key remains active instantly.
Balances never expire, allowing you to accumulate funds for bulk audio generation needs across multiple courses or departments.
- USDT (TRC-20) only
- Minimum $5 top-up
- Automatic credit within minutes
Audio formats
LectioLab supports four standard audio formats to suit different LMS constraints and quality requirements. Each format balances file size, compatibility, and bit depth to ensure reliable playback across various student devices and learning management systems.
Select the format that best matches your course delivery pipeline. MP3 is a standard format for web delivery, while lossless options preserve maximum fidelity for archival or high-end educational materials.
MP3 for web
MP3 is a common format for LMS integrations due to its universal browser support and small file size. It provides sufficient clarity for speech synthesis while minimizing bandwidth usage for students on mobile networks or slow connections.
- Universal playback support in all major browsers and LMS players
- Optimized file size for efficient streaming and downloads
- Ideal for standard course narration and audio announcements
WAV for high quality
WAV offers uncompressed audio suitable for archival purposes or professional audio editing workflows. Use this format when you need to preserve the exact output of the synthesis engine without any lossy compression artifacts.
- Lossless quality preserving all synthesized audio details
- Ideal for post-production editing or voice-over workflows
- Standard compatibility with most audio editing software
Opus and FLAC options
Opus provides excellent compression efficiency with good quality, suitable for modern web apps. FLAC offers lossless compression, reducing file size while maintaining audio integrity.
- Opus: efficient compression for modern web applications
- FLAC: lossless compression for balanced storage and quality
- Both formats support high-quality audio delivery
Data privacy
Input text is used exclusively for synthesizing the requested audio file and is not retained for training future models. This ensures your course materials remain private and are not repurposed to improve the engine’s general capabilities.
Generated audio files are returned directly in the API response and are not stored on our servers after delivery. We retain only request metadata—such as timestamp, character count, and status—for billing and debugging purposes.
No training on input
Your source texts are processed solely to generate the audio output for that specific request. They are not added to our training datasets, ensuring that your unique course content remains distinct from the model’s base data.
No storage of audio
Audio files are streamed back to your client and are not persisted in our storage systems. Once the response is delivered, the audio data is gone from our infrastructure, reducing your compliance burden for temporary media.
Metadata for billing
We store minimal metadata including the request time, character count, and status to accurately calculate charges and troubleshoot issues. This data is used strictly for billing verification and does not include the content of your text.
Getting started
Create an account using your Google credentials to receive immediate trial credit. This allows you to test the API without entering payment details first. The process takes seconds and grants access to the dashboard.
Sign up with Google
Visit the /get-api-key/ page and click the Google sign-in button. You will receive $0.50 in trial credit valid for 7 days. This covers approximately 50,000 characters of generated audio.
- Instant access via Google OAuth
- $0.50 trial credit included
- No credit card required initially
Get API key
Your unique API key appears on the dashboard immediately after sign-in. Copy this key to use in your HTTP headers as Authorization: Bearer <key>. You can regenerate it at any time.
- Single active key per account
- Regenerate anytime via dashboard
- Starts with
tts-prefix
First request example
Use the OpenAI Python SDK or standard HTTP libraries. Point the base URL to https://api.788t.info/v1. Send a POST request to /audio/speech with your text and desired voice.
- Base URL: https://api.788t.info/v1
- Endpoint: POST /v1/audio/speech
- Supports standard OpenAI SDKs
Support
We offer email support for technical inquiries and billing questions. There is no phone line or live chat, so expect a reply within one business day.
Email support
Contact us for API issues or account problems. We handle all support via email to keep communication clear and documented.
Documentation
Our docs cover integration with the OpenAI Python SDK, rate limits, and voice parameters. Check /docs/ for code snippets and curl examples.
Community
Share LMS integration tips and Python scripts with other educators. We do not host forums; use our contact page to share resources.
Listen to the 8 voices
Each sample below was generated by this API from the same sentence. We retain only request metadata—timestamp, character count, and status—for billing and operational purposes.
23 languages
Any voice speaks any of these languages.
