What is the Text-to-Speech API and How Does It Work?

By TaleTTS API editorial team · Updated 2026-11-18

The TaleTTS API converts written text into natural-sounding audio files via a simple cloud service. By sending a JSON payload, you receive synthesized speech instantly, making it ideal for startups building interactive children’s books and educational apps. This guide explains how to integrate the API into your workflow without managing complex audio infrastructure.

You will learn how the system processes text, selects from eight distinct voices, and supports 23 languages. We cover practical steps for setup, pricing details, and technical constraints like the lack of streaming or SSML. This page is designed for developers who need a reliable, cost-effective way to add high-quality narration to their digital products.

What is the Text-to-Speech API and How Does It Work?

Frequently asked questions

What is a text to speech reader?

It is a cloud API that converts written text into audio files. TaleTTS API accepts text and returns synthesized speech, allowing developers to integrate narration into applications without managing complex audio infrastructure or hardware.

How does TTS convert text to audio?

Send a JSON payload to the /v1/audio/speech endpoint with your text, chosen voice, and language. The service processes the request and returns an audio file in your specified format, such as mp3, wav, opus, flac, or pcm.

Is TTS real-time?

It is not real-time streaming. Synthesis takes time, roughly processing 25 characters per second. Short phrases take a few seconds, while longer texts generate at near real-time speed. Requests are processed sequentially, so high load may cause queue delays.

Can TTS read any text?

It supports 23 languages, including English, Spanish, and Chinese. Any voice can speak any supported language. Text up to 4096 characters per request is accepted. Longer texts must be split into parts and joined. Unsupported languages include Vietnamese, Thai, and Ukrainian.

What are the limitations of TTS?

Input is limited to 4096 characters per request. It does not support SSML, custom voice cloning, or emotion tags. There is no streaming, no official SDK, and no SLA. Rate limits are 60 requests per minute per key. Audio is not stored.

How accurate is TTS pronunciation?

Voices are based on licensed recordings from LibriTTS-R and LibriVox. The system guesses language from script, defaulting to English for Latin text. For non-English Latin text, explicitly set the language parameter to ensure accurate pronunciation across the 23 supported languages.

Can TPS handle special characters?

Yes, standard text input handles special characters within the 4096 character limit. Spaces and punctuation count toward the character limit and pricing. The API processes standard Unicode text to generate natural-sounding audio without requiring special formatting or SSML tags.

Does TTS support emotional tone?

No, it does not support emotion tags. Voices have preset styles like warm, bright, or calm, but you cannot dynamically adjust emotional tone via parameters. Each voice has a fixed character, such as Aria’s warm narration or Felix’s energetic promo style.

What is SSML in TTS?

SSML (Speech Synthesis Markup Language) is not supported by this API. You cannot use SSML tags to control pauses, pitch, or emphasis. Input is plain text, and audio generation relies on the selected voice preset and language code for natural flow.

Can I clone a voice with TTS?

No, custom voice cloning is not offered. You cannot upload your own voice or design a custom voice. The API provides eight fixed presets based on licensed recordings. Voices are static and cannot be modified or cloned by customers.

How much does TTS cost?

Pricing is $10 per 1 million characters, or $0.01 per 1,000 characters. Failed requests are free. A $0.50 free trial is available for Google sign-ups. Top-ups are via USDT on TRON, with no monthly plans or minimum spend required.

Is TTS better than human narration?

It depends on your needs. TTS offers consistent quality, instant generation, and lower costs for large volumes. Human narration may offer more nuance. TaleTTS voices are based on licensed recordings.

Can TTS be used for audiobooks?

Yes, it is well-suited for audiobooks. Voices like Luna offer soft storytelling, while Atlas provides neutral news reading. Text can be split into parts exceeding 4096 characters. Generated audio files are returned directly, making integration into apps straightforward for developers.

Does TTS work offline?

No, it is a cloud API. You must send text to the endpoint to receive audio. There is no offline mode, no local SDK, and no on-premise installation option. An internet connection is required for every synthesis request.

What formats does TTS support?

It supports mp3, wav, opus, flac, and pcm. Specify the desired format in the response_format field. Each generated file carries an inaudible watermark that marks it as synthetic speech. These formats ensure compatibility with most audio players and development environments.

Can TTS handle multiple languages?

Yes, it supports 23 languages including Arabic, Chinese, French, German, Japanese, and Spanish. Any voice can speak any supported language. If language is unset, it guesses from the script. Explicitly setting the language ensures accuracy for non-English Latin text.

Is TTS accessible?

Yes, it converts text to audio, aiding accessibility. It supports multiple languages and formats like mp3 and wav. The API is simple to integrate, allowing apps to provide audio narration for users who prefer listening over reading text content.

How do I integrate TTS into my app?

Send a POST request to https://api.playpg699.com/v1/audio/speech with your API key in the Authorization header. Include the text, voice, and language in the JSON body. Use the OpenAI SDK by changing the base URL, or use plain HTTP.

Definition

Sound wave illustration for: Definition

The TaleTTS API is a cloud-based service that converts written text into natural-sounding audio files. It is designed for startups creating interactive children's books and educational content, allowing developers to generate high-quality narration with a single API call without managing complex audio infrastructure.

Cloud-based conversion

The service runs entirely in the cloud, eliminating the need for local hardware. You send text via a standard HTTP request, and the processing happens on our servers, returning a ready-to-use audio file.

Text input to audio output

You provide the script as plain text, and the API returns an audio file in formats like MP3, WAV, or FLAC. It handles the synthesis engine, so you focus on content rather than audio engineering.

API-driven automation

Integration is automated through a simple JSON endpoint compatible with the OpenAI SDK. This allows you to programmatically generate voiceovers for your app or web platform, scaling production from a few stories to thousands without manual effort.

How it works

Sound wave illustration for: How it works

Sending text to the TaleTTS API converts written content into natural-sounding audio. The process begins with a simple JSON request containing your text, selected voice, and desired audio format. This single call automates narration generation, allowing you to integrate high-quality voiceovers directly into children’s books or educational apps without managing complex audio infrastructure.

JSON request body

Construct a POST request to the speech endpoint with a JSON body. Include the text input (up to 4096 characters), the chosen model (tts-1 or tts-1-hd), and the specific voice preset like 'aria' or 'nova'. You can also specify the response format (mp3, wav, etc.) and adjust the speaking speed between 0.25 and 4.0.

  • Use standard JSON structure compatible with OpenAI SDKs
  • Include model, input, voice, and response_format fields
  • Authenticate with a Bearer token in the header

Audio file generation

The API processes your text using licensed voice recordings to synthesize speech. For longer texts exceeding 4096 characters, the system automatically splits the content into smaller parts, generates audio for each segment, and joins them seamlessly. This ensures continuous narration for full children’s stories or educational modules without manual chunking.

Instant response

Once the request is processed, you receive an audio file directly in the response. Short phrases typically generate within a few seconds, while longer texts take roughly one second per 25 characters of text. Failed requests incur no charge, and you can download the resulting file immediately for use in your application.

How it works

Use cases

Sound wave illustration for: Use cases

Turn written stories into engaging audio narrations with a single API call. This capability allows startups to instantly convert text scripts into natural-sounding audio files, enabling the creation of interactive children's books and educational content without managing complex audio infrastructure.

Developers can integrate high-quality voiceovers directly into apps, ensuring consistent character voices across episodes. The API handles the heavy lifting of synthesis, letting teams focus on content creation rather than audio engineering.

Children's books

Generate consistent narration for digital storybooks using preset voices like Aria or Luna. These voices offer warm, clear tones suitable for reading fairy tales and short stories to young audiences.

Each request converts up to 4,096 characters of text into an audio file, allowing for modular story segments that can be played sequentially in a child-friendly interface.

  • Ideal for digital storybooks and read-along apps
  • Consistent character voices across multiple chapters
  • Supports multiple languages for global reach

Educational content

Create audio versions of textbooks, lesson plans, or vocabulary lists. The API’s neutral and instructional voices, such as Sage or Atlas, provide clear narration for learning materials.

Developers can adjust speed between 0.25 and 4.0 to match different learning paces, ensuring accessibility for diverse student needs without additional production costs.

  • Audio textbooks and lesson narrations
  • Adjustable playback speed for learning
  • Multi-language support for global education

Accessibility tools

Convert text content into speech for visually impaired users or those who prefer auditory learning. The API supports 23 languages, including Spanish, French, and German, ensuring broad accessibility.

Generated audio files are returned in the response, allowing conversion of user-generated content or static articles into listenable formats within the application.

  • Support for 23 languages
  • Real-time text-to-speech conversion
  • Enhanced accessibility for diverse users

Benefits

Sound wave illustration for: Benefits

The API eliminates expensive voice actor fees and studio rental costs. You pay only for what you use: $0.01 per 1,000 characters, with no monthly subscriptions or minimum spends. Failed requests are refunded, ensuring you never pay for wasted compute time.

Our cloud infrastructure handles scaling automatically. Whether you generate audio for one children's book or thousands of educational modules, the system processes requests sequentially without requiring you to manage servers or handle load spikes during peak creation periods.

Cost-effective production

Eliminate recurring voice actor fees and studio rental costs. Pay only for actual usage at $0.01 per 1,000 characters, with no monthly subscriptions or minimum spends. Failed requests are refunded in full, ensuring you never pay for wasted compute time.

  • No monthly subscriptions
  • Pay per character
  • Refunds for failures

Scalable infrastructure

The cloud handles scaling automatically. Process requests sequentially without managing servers. Ideal for startups growing from single titles to extensive educational libraries without infrastructure overhead.

  • No server management
  • Automatic scaling
  • Cloud-native

Consistent voice quality

Maintain uniform narration across your entire catalog. Choose from eight distinct preset voices, ensuring every story or lesson sounds professional and cohesive, regardless of volume or production date.

  • 8 preset voices
  • Uniform tone
  • Professional quality

Technical details

Sound wave illustration for: Technical details

The TaleTTS API accepts standard JSON payloads via POST requests, allowing seamless integration into existing workflows. By updating the base URL to https://api.playpg699.com/v1, developers can leverage the official OpenAI SDKs without rewriting their code, ensuring a familiar experience for engineering teams already accustomed to that ecosystem.

This compatibility extends to authentication and request structures, minimizing development time. The API processes text inputs and returns generated audio files directly in the response, enabling straightforward automation for generating narration in children's books or educational modules without complex middleware.

OpenAI SDK compatibility

The API mirrors the request shape of the OpenAI speech endpoint. This means you can use the official OpenAI SDKs by simply changing the base_url to https://api.playpg699.com/v1 and using your specific API key. This reduces boilerplate code and accelerates integration for startups already using Python or Node.js clients.

Authentication is handled via the Authorization: Bearer header, ensuring secure and standard access control. The consistent structure allows for easy switching between models like tts-1 and tts-1-hd without altering the core request logic.

  • Compatible with official OpenAI SDKs (Python, Node.js, etc.)
  • Standard JSON request body structure
  • Simple base URL configuration change

Multiple audio formats

Developers can choose from five response formats: mp3, wav, opus, flac, and pcm. This flexibility allows you to optimize file sizes for web delivery (mp3, opus) or preserve high-fidelity audio for educational archives (wav, flac).

Each format serves different use cases, from lightweight mobile app delivery to high-quality publishing standards. The API returns the audio file directly in the response.

  • mp3, wav, opus, flac, pcm
  • Optimize for web or high-quality storage
  • Direct response delivery

Character limits

Each request supports up to 4096 characters of input text. For longer children's stories or educational scripts, you must split the text into chunks of this size and join the resulting audio files.

The API processes requests sequentially, so longer texts may take time to generate. Typically, generation speed is roughly real-time (25 characters per second), ensuring predictable latency for most content lengths.

Failed requests are free, ensuring you only pay for successful audio generation. This helps in debugging integration issues without wasting budget.

  • 4096 characters max per request
  • Split and join for longer content
  • Real-time generation speed (~25 chars/sec)

Voices available

Sound wave illustration for: Voices available

The API provides eight distinct voice presets designed for clear, natural narration. These voices are generated from licensed recordings, ensuring high audio quality suitable for children's books and educational content.

Each voice offers a specific tonal character, allowing developers to match the narrative style of their stories precisely. The selection covers a range of emotional tones without requiring complex configuration.

8 preset voices

Select from eight distinct voices: Aria, Nova, Luna, Sage, Felix, Milo, Atlas, and Orion.

Aria offers a warm, clear narrator style. Nova provides a bright, upbeat tone. Luna delivers soft storytelling, while Sage brings a calm, instructional voice.

Felix is energetic and ideal for promos. Milo sounds friendly and conversational. Atlas remains neutral for news-like content, and Orion offers a deep, documentary style.

  • 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

Gender diversity

The library includes four female and four male voices, providing balanced options for diverse characters in interactive stories.

This variety allows creators to assign specific voices to different characters without needing multiple subscriptions or complex voice management.

Tone variety

Voices range from soft and storytelling to energetic and news-like, covering most narrative needs for educational audio.

All voices speak all 23 supported languages, ensuring consistent tone quality regardless of the language used in the text input.

Languages supported

Sound wave illustration for: Languages supported

The TaleTTS API supports 23 specific languages, covering major global markets and niche regions. Voices are versatile; any of the 8 preset voices can speak any supported language with natural intonation. This flexibility allows startups to produce consistent narration across diverse educational content without managing multiple voice models.

The API handles language selection intelligently but requires precision for accurate results. Understanding how detection works ensures your children’s books and audio lessons sound authentic in the target market.

23 languages

We support Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, and Turkish. Unsupported languages include Vietnamese, Indonesian, Thai, Ukrainian, Romanian, Czech, and Bengali.

  • Arabic, Chinese, Danish, Dutch, English, Finnish, French, German, Greek, Hebrew, Hindi, Italian, Japanese, Korean, Malay, Norwegian, Polish, Portuguese, Russian, Spanish, Swahili, Swedish, Turkish

Automatic detection

If you omit the language field, the system guesses the language from the script. Latin-script text defaults to English. This works well for standard English text but may fail for other Latin-based languages.

Manual language setting

For non-English Latin-script text, always set the language parameter to the ISO code. This ensures the correct pronunciation and accent, critical for accurate educational narration.

Languages supported

Pricing model

Sound wave illustration for: Pricing model

TaleTTS API uses a straightforward pay-per-character model, charging $10 for every million characters processed, which equals $0.01 per 1,000 characters. Spaces and punctuation count toward this total. Failed requests incur no charge, ensuring you only pay for successful audio generation.

This structure eliminates financial risk for startups building interactive children's books or educational content. You scale usage up or down without worrying about fixed overhead, paying only for the narration your users actually consume.

Pay per character

The cost is precisely $0.01 per 1,000 characters, including spaces and punctuation. With a limit of 4096 characters per request, you can split longer texts and join the resulting audio files seamlessly.

Longer texts are processed in parts, maintaining consistent pricing regardless of the final audio length. Failed requests are free, so you never pay for errors.

  • $10 per 1 million characters
  • $0.01 per 1,000 characters
  • Spaces and punctuation count
  • Failed requests are free

No monthly fees

There are no subscriptions, seats, or minimum spend requirements. You simply top up your balance and use the API as needed. This model suits startups that may have variable narration demands.

Balances do not expire, allowing you to store credits for future projects. Payments are made via USDT on the TRON network, with automatic crediting within minutes.

Free trial available

New accounts signed in with Google receive $0.50 in credit, valid for 7 days, which covers approximately 50,000 characters. Email-based accounts start without trial credit.

This allows developers to test integration and voice quality before committing funds. No credit card is required to start testing the API.

Integration

Sound wave illustration for: Integration

The TaleTTS API integrates directly into your startup’s workflow with minimal configuration. By pointing your existing OpenAI SDK client to our base URL, you can begin generating narration in minutes without rewriting your core logic or managing complex audio infrastructure.

This approach allows developers to focus on content creation rather than backend audio processing, ensuring consistent voice quality across all interactive children's books and educational platforms.

Easy API setup

Start by signing up and retrieving your API key. Update your SDK’s base URL to https://api.playpg699.com/v1 and send a POST request to /v1/audio/speech. The system handles the rest, returning an audio file instantly.

This standard integration means you can use familiar tools and libraries, reducing the learning curve for your development team.

  • - Send a single POST request with text and voice parameters
  • - Receive an audio file (mp3, wav, opus, flac, or pcm) in the response
  • - Use standard HTTP headers for authentication with your Bearer token

Developer-friendly

The API uses a JSON body structure identical to the OpenAI speech endpoint. This compatibility allows you to use official OpenAI SDKs by simply changing the base URL, making migration or adoption seamless for existing developers.

Requests are processed sequentially, ensuring predictable billing based on character count, with failed requests refunded automatically.

Standard endpoints

Use GET /v1/voices to retrieve available presets and languages, and GET /v1/models to confirm engine options. The primary endpoint POST /v1/audio/speech accepts text up to 4096 characters, supporting speeds from 0.25x to 4.0x.

For longer texts, split the input into chunks, generate each segment, and join the audio files programmatically to create continuous narration for your stories.

Data privacy

Sound wave illustration for: Data privacy

Your data integrity is maintained through strict processing rules. We prioritize privacy by ensuring that the text you send for synthesis is used exclusively to generate the requested audio file. It is not retained or utilized to train our underlying models, keeping your creative content distinct from our training datasets.

Input not used for training

The source text enters our engine solely to produce the audio output for that specific request. Once the audio is generated and returned to you, the input text is not archived for model improvement purposes, ensuring your stories and educational materials remain private to your usage.

No audio storage

Generated audio files are delivered directly in the API response and are not permanently stored on our servers. This minimizes data retention risks, as we do not keep copies of your narrated children's books or educational content after the transfer is complete.

Secure transmission

All data exchanges between your application and our API occur over secure connections. This ensures that your text inputs and resulting audio files are transmitted safely, protecting your content during the brief window of processing.

Limitations

Sound wave illustration for: Limitations

While the API delivers high-quality narration efficiently, it operates on a request-response model rather than a streaming architecture. This means you receive the complete audio file only after synthesis finishes, which may introduce slight latency for very short phrases compared to real-time streaming solutions.

No streaming support

Audio is returned as a finished file, not a continuous stream. This requires waiting for generation to complete before playback can begin.

No SSML support

The API does not support Speech Synthesis Markup Language (SSML). You cannot control pacing, emphasis, or pronunciation via XML tags. Adjust speed using the speed parameter instead.

No voice cloning

Custom voice cloning is not offered. You must choose from the eight preset voices. Each voice is based on licensed recordings, ensuring legal clarity but limiting unique brand-specific voice creation.

Limitations

Support

Sound wave illustration for: Support

We provide support exclusively via email, ensuring your queries are handled with care and precision. There is no phone number or live chat to navigate; just send us a message and receive a thoughtful response from our team.

Our documentation is structured to help you integrate quickly, offering clear guides and reference materials. We also share community resources where developers discuss common use cases and troubleshooting tips for children's audio content.

Email support only

All customer inquiries are managed through email. This allows for detailed, asynchronous communication without the wait times of phone lines. You can reach us at [email protected] for any technical or billing questions.

  • Direct email access
  • No phone support

Documentation

Our docs cover every endpoint, from voice selection to character limits. You will find ready-to-use code examples and curl commands to start generating audio immediately.

  • API reference
  • Integration guides

Community resources

Connect with other developers building educational audio tools. Share insights on handling long texts or optimizing voice selection for children's stories.

  • Developer forums
  • Use case discussions

Listen to the 8 voices

Each sample below was generated by this API from the same sentence. Craft enchanting digital fairy tales that ignite imaginations and inspire the next generation of dreamers.

Avatar of the voice aria
ariafemale
Avatar of the voice nova
novafemale
Avatar of the voice luna
lunafemale
Avatar of the voice sage
sagefemale
Avatar of the voice felix
felixmale
Avatar of the voice milo
milomale
Avatar of the voice atlas
atlasmale
Avatar of the voice orion
orionmale

23 languages

Any voice speaks any of these languages.

Sources and further reading

  1. Wikipedia
  2. Creative Commons Attribution 4.0
  3. ISO 639 language codes
  4. Node.js documentation
  5. FFmpeg documentation
  6. LibriTTS-R corpus (OpenSLR 141)
  7. curl documentation
  8. LibriTTS-R paper (arXiv 2305.18802)
  9. IETF RFC 7845: Ogg Opus
  10. openai-python on GitHub
  11. W3C WAI: making audio and video accessible
  12. TRON developer hub: TRC-20

More on this site