TTS-Seed โ
This page covers how to call TTS-Seed speech synthesis on MPS. TTS-Seed is plugged into MPS under the engine code tts-s: the APIs, authentication, billing, task queries and storage are all the existing MPS speech-synthesis APIs. You switch to TTS-Seed simply by writing "engine": "tts-s" in the ExtParam extension field, then add emotion, speed and other parameters as needed.
TTS-Seed stands out for having the richest set of emotion / style values: emotion accepts 24 values. Beyond basic emotions such as happy and sad, it includes scenario-specific delivery styles such as storytelling, emotional radio, news, advertising and ASMR whisper.
Voice cloning not supported yet
The TTS-S Engine Integration Guide states explicitly that tts-s does not support cloning yet. Only system voices can be used; get the VoiceId from DescribeVoices.
Choosing between the engines
- Need scenario-specific delivery styles (news, advertising, storytelling, radio, ASMRโฆ) โ this page
- Need per-character timestamps for karaoke-style subtitles โ TTS-ElevenLabs
- Want to describe accent and tone in one natural-language sentence โ TTS-Gemini
- Need cloning + voice design or independent pitch control โ TTS-MiniMax
- Need custom emotion tags, or cloning without creating a voice โ TTS-Fishaudio
The full comparison of all seven engines is in MPS TTS Engines Compared.
APIs and Official References โ
All APIs below belong to MPS "Media AI โ Dubbing APIs". Their official references live under the Tencent Cloud International Media AI โ Dubbing APIs directory.
APIs that support tts-s โ
The TTS-S Engine Integration Guide lists the following 4 APIs as switchable to TTS-Seed via ExtParam.engine:
| API | Purpose | Mode | Official reference |
|---|---|---|---|
TextToSpeech | Short text to speech, returns audio directly | Sync | 1041/82311 |
TextToSpeechAsync | Long text to speech, returns a TaskId | Async | 1041/79693 |
DescribeTextToSpeechAsyncTask | Query async synthesis result (Status / AudioUrl) | Sync | 1041/79696 |
DescribeVoices | Query available voices (including TTS-Seed system voices) | Sync | 1041/79695 |
Other APIs in the same directory โ
| API | Purpose | Works with tts-s | Official reference |
|---|---|---|---|
CloneVoice | Clone a voice from reference audio | โ Explicitly unsupported | 1041/82312 |
DesignVoiceAsync / DescribeDesignTask | Design a new voice from a text description / query the result | โณ Not listed in the guide | 1041/79694 / 1041/79598 |
UpdateVoice / DeleteVoice | Update / delete a cloned or designed voice | โณ Not listed in the guide | 1041/81214 / 1041/81215 |
ChangeVoice | Voice conversion | โณ Not listed in the guide | 1041/83750 |
SyncDubbing | Early all-in-one API (clone or synthesize) | โณ Not listed in the guide | 1041/77775 |
โ = explicitly unsupported in the guide; โณ = not mentioned in the guide โ whether it can be switched to TTS-Seed should be confirmed by an actual call.
Common conventions:
- Version
2019-06-12; endpointmps.intl.tencentcloudapi.comfor the International site (mps.tencentcloudapi.comfor the China site). - Authentication is TC3-HMAC-SHA256 (SecretId / SecretKey) throughout; see Quick Start for signing.
- Rate limit is
20 requests/secondper API.
Comparison with the other engines โ
MPS currently offers seven external TTS engines. The full side-by-side comparison (API coverage, emotion mechanism, audio parameters, cloning, selection guidance) is on the Blog: MPS TTS Engines Compared โ the comparison table is maintained only there, so the engine pages cannot drift apart.
Where tts-s sits: the richest emotion / style enum (24 values, including scenario broadcast styles), and one of only two engines whose sample rate reaches 48000. The trade-off is that cloning is not supported.
Engine Switching: ExtParam.engine โ
The MPS speech-synthesis APIs are engine-agnostic. The ExtParam JSON-string field decides which engine runs the request. tts-s uses two layers:
| Layer | Role | Notes |
|---|---|---|
engine | Select the engine | Always tts-s on this page |
synExt.* | MPS-normalized synthesis parameters | Emotion, sample rate, duration, speed, volume |
Differences from the other engines
The TTS-S Engine Integration Guide lists only the normalized parameters under synExt. It does not list a synExt.engineCustom pass-through layer, nor model / format parameters. If you need these, confirm with an actual call first.
ExtParam is a string in the request, not an object โ the JSON must be escaped and passed as a string (see Call Examples).
Main tts-s Parameters โ
| Parameter | Type | Required | Description |
|---|---|---|---|
engine | String | Yes | Set to tts-s |
synExt | Object | No | Speech-synthesis extension parameters |
synExt.emotion | String | No | Emotion / style of the synthesized speech; see Emotion Values below |
synExt.sampleRate | Integer | No | Sample rate: 8000, 16000, 22050, 24000, 32000, 44100, 48000; default 16000 |
synExt.duration | Float | No | Target audio duration |
synExt.speed | Float | No | Speech rate, range [0.5, 2], default 1.0 |
synExt.vol | Float | No | Volume, range (0, 10], default 1.0 |
Emotion Values โ
synExt.emotion has 24 values, which fall into two groups by purpose:
Basic emotions
| Value | Meaning | Value | Meaning |
|---|---|---|---|
happy | Happy | sad | Sad |
angry | Angry | surprised | Surprised |
fear | Fearful | hate | Disgusted |
excited | Excited | coldness | Cold / detached |
neutral | Neutral | depressed | Depressed |
lovey-dovey | Coquettish | shy | Shy |
comfort | Comforting / encouraging | tension | Roaring / anxious |
tender | Tender |
Scenario-specific delivery styles
| Value | Meaning | Typical use |
|---|---|---|
storytelling | Storytelling / natural narration | Audiobooks, children's stories |
radio | Emotional radio | Late-night radio, emotional programs |
magnetic | Magnetic | Male narration, brand promos |
advertising | Advertising / marketing | Product ads, promotional voice-overs |
vocal-fry | Vocal fry | Distinctive persona voices |
ASMR | Whisper | Sleep aids, ASMR content |
news | News broadcast | News and information |
entertainment | Entertainment gossip | Entertainment news, short-video commentary |
dialect | Dialect | Dialect content |
Confirm two spellings with an actual call
The guide writes vocal fry as vocal - fry (with spaces around the hyphen) and whisper as ASMR (uppercase). This table records them in conventional enum form as vocal-fry and ASMR; if a call returns a parameter error, retry with the guide's original spelling vocal - fry.
Emotions depend on the voice
Different system voices may support different emotion ranges. After finding a voice with DescribeVoices, try a few emotion values on short text before using them at scale.
Voice (VoiceId) โ
For TTS-Seed, VoiceId takes a TTS-Seed voice name directly, e.g. zh_female_vv_uranus_bigtts. Query available voices with DescribeVoices; see Querying System Voices.
Parameter Example โ
A complete ExtParam object (expanded for readability โ escape it to a string when actually sending):
{
"engine": "tts-s",
"synExt": {
"emotion": "happy",
"speed": 0.9
}
}Call Examples โ
Speech synthesis TextToSpeech โ
{
"Text": "ๆจๅฅฝ",
"VoiceId": "zh_female_vv_uranus_bigtts",
"ExtParam": "{\"engine\":\"tts-s\",\"synExt\":{\"emotion\":\"happy\",\"speed\":0.9}}"
}Note that the value of ExtParam is an escaped JSON string, not a nested object.
No spaces around the engine value
The guide's original example writes \"engine\":\" tts-s\" (an extra space before tts-s), which is inconsistent with the parameter table and the other examples โ a typo. This page corrects it to tts-s. Engine codes are matched as exact strings, so a stray space may prevent switching to TTS-Seed.
Async synthesis and query โ
Submit long text with TextToSpeechAsync; ExtParam is written exactly as for the sync API, and a TaskId is returned. Then poll Status with DescribeTextToSpeechAsyncTask and fetch the audio from AudioUrl once it completes.
Querying System Voices โ
Use DescribeVoices (1041/79695) to list available TTS-Seed voices. ExtParam only needs the engine:
{
"engine": "tts-s"
}ExtParam is a JSON string for this API as well. It also supports filtering; common input parameters:
| Parameter | Type | Description |
|---|---|---|
VoiceType | String | system system voices / clone cloned voices / design designed voices / all everything (default) |
Gender | String | male / female / unknown |
Age | String | child / teenager / youth / middle_aged / senior / unknown |
Languages.N | Array of String | Languages |
Labels.N | Array of String | Labels |
PageNum / PageSize | Integer | Pagination; leave PageSize empty to return all matching entries |
Since tts-s does not support cloning, set VoiceType to system to see system voices only.
Limitations and Notes โ
- Cloning not supported yet:
CloneVoicecannot be switched totts-s; only system voices are available. ExtParamis a string: it must be an escaped JSON string in the request; passing an object is rejected as a parameter error.engineis matched exactly: writetts-swith no leading or trailing spaces.- Default sample rate is
16000: for music or high-fidelity scenarios, explicitly raise it to44100or48000. - Volume is a half-open interval
(0, 10]:0is invalid; the minimum must be greater than 0. - No
model/format/engineCustomlisted: the guide gives only the 5synExtparameters above; whether other parameters take effect should be confirmed by an actual call. - โณ-marked APIs are subject to actual calls: the โ / โ / โณ marks on this page follow what the TTS-S Engine Integration Guide lists; an API not listed is not necessarily unavailable.
Related Docs โ
| Doc | Description |
|---|---|
| MPS TTS Engines Compared | Capabilities, parameters and selection guidance across all seven external engines |
| AI Dubbing | Overview of MPS dubbing and built-in engines |
| TTS-ElevenLabs | ElevenLabs engine (tts-l1) on the same APIs, with per-character timestamps |
| TTS-Gemini | Google Gemini-TTS engine (tts-gg) on the same APIs, style controlled by prompt |
| TTS-MiniMax | MiniMax engine (minimax) on the same APIs, with cloning and voice design |
| TTS-Fishaudio | Fish Audio engine (tts-f) on the same APIs, with inline emotion tags and zero-shot cloning |
| TTS-Index | The same APIs on IndexTTS (index-tts): a reference audio URL straight in VoiceId, 8-dimension emotion vector |
| TTS-Seedaudio | The same APIs on Seed Audio (tts-sa): the only engine that generates speech from an image, word-level timestamps |
| Quick Start | Authentication and signing |
| Media AI โ Dubbing APIs | Official API directory |