Skip to documentation
Browse documentation

USE CASES

Put voice to work in your product.

The API provides voices, short-text synthesis and downloadable audio. These eight workflows show what you can build now, and what your application needs to add.

The shared capabilities

  • Synthesis languages: English, Chinese, German, Japanese, French, Spanish, Korean, Portuguese, Russian, Italian.
  • Choose a library voice or create a private voice from an authorized recording. First-time references prepare automatically; subsequent requests reuse the voice ID.
  • MP3 / WAV, with up to 500 normalized characters per queued task. Immediate speech requests accept up to 120.
  • MP3 supports speed 0.5–2. English can optionally return word or measured word-group timestamps; other languages currently return audio only.
  • Download successful results within 24 hours and store them in your own application when longer retention is needed. Usage and regional data rules still apply.

Check all current limits

Eight workflows you can build

Reading & audio content

Turn article excerpts, newsletters and story passages into audio your readers can save and replay.

How to integrate

Submit one short passage per job. For English, optionally request timestamps to drive word or word-group highlighting.

What your app needs to handle

Extract document text, split long articles and manage the playlist in your app. Alignment can be unavailable; keep ordinary playback as a fallback.

Related API guide

Language learning & lessons

Give vocabulary cards, example sentences and short lessons a consistent voice, with reusable audio for practice.

How to integrate

Provide the lesson text and matching language. MP3 supports speed from 0.5 to 2; save each generated example with its learning card.

What your app needs to handle

Pronunciation scoring, speech recognition and phoneme dictionaries are not provided. Review teaching materials before publication.

Related API guide

Video & advertising voiceovers

Generate narration for short videos, product explainers and campaign scripts. Take the finished audio into your editor.

How to integrate

Choose a voice in the console, reuse its regional ID and submit each script as a job. Retrieve the audio file when it completes.

What your app needs to handle

Video editing, lip sync, music and sound effects remain in your production tools. Style tags describe a voice; they are not emotion controls.

Related API guide

Product guidance & notifications

Use one recognizable voice for onboarding, guided steps, accessibility prompts and spoken notifications.

How to integrate

Generate common messages ahead of time, retain the files in your app and play them when the relevant event occurs.

What your app needs to handle

This is audio generation, not push delivery or telephony. No real-time response or safety-critical alert latency is guaranteed.

Related API guide

Multilingual localization

Turn localized scripts into speech for different audiences while reusing your chosen voice.

How to integrate

Supply text already written in a supported language and send its language code. Confirm voice support and keep its ID in the selected region.

What your app needs to handle

The API does not translate or infer language from the website locale. The console can help detect text language; ambiguous or mixed text may need an explicit choice.

Related API guide

Character lines & brand voices

Give game characters, story roles or a brand a recurring voice. Produce each role’s lines with its own voice ID.

How to integrate

Choose catalog voices or create an authorized private voice. Keep a role-to-voice map and generate each line separately.

What your app needs to handle

Dialogue ordering, pauses and audio assembly belong in your app. Native multi-speaker generation and text-to-voice design are not provided.

Related API guide

Spoken AI answers

Add spoken output to an existing text assistant or knowledge-base application.

How to integrate

Generate the answer with your own system, split it into supported text lengths and submit speech jobs. Play completed files.

What your app needs to handle

The service supplies TTS only, not an LLM, microphone input, turn detection or interruptible real-time conversation.

Related API guide

Content workflow automation

Add a repeatable audio-production step to a CMS, course builder or internal publishing tool.

How to integrate

Create short jobs within workspace limits, persist job IDs, poll with backoff and download results before retention expires.

What your app needs to handle

Batch scheduling, storage and publishing are your application’s responsibility. There is no native unlimited bulk or long-book endpoint.

Related API guide

A reusable integration pattern

  1. Choose a voice in the console and keep its regional voice ID. Use the same account and workspace in your application.
  2. Prepare the text, its matching language and the audio format. Keep text language separate from the page locale and the sample’s language.
  3. Submit a short job with a stable Idempotency-Key. Save the job ID, poll with backoff, and handle preparation or capacity waits.
  4. After success, download the audio and connect it to your player, editor or publishing pipeline. An identical successful retry does not create another generation charge.

Node.js and Python clients

Not native capabilities in this release

Emotion instructions, laughter or sound-effect tags, pronunciation dictionaries, text-to-voice design, multi-speaker projects, automatic translation and video dubbing are not exposed API capabilities. Voice-library style tags are descriptive filters, not request parameters.

Real-time conversations, interruptible playback, public streaming and native long-form or unlimited batch generation are not available in the current public release. Pre-generate time-sensitive audio; do not assume a latency SLA.

Use only voices and content you are authorized to use. A supported integration pattern is not a guarantee that every voice will fit every language or production style; audition the actual output.