This API supports synchronous text-to-speech generation with a maximum of 10,000 characters per request. Supports 100+ system voices and cloned voices; supports volume, pitch, speed, and output format customization; supports proportional voice mixing and fixed interval time control; supports multiple audio specifications and formats including: mp3, pcm, flac, wav, with streaming output support.After submitting a long text speech synthesis request, please note that the returned URL is valid for 24 hours from the time it is generated. Please download the content in time.
Suitable for short sentence generation, voice chat, online social scenarios with low latency, but text length limit is less than 10,000 characters. For long text, it is recommended to use Async Text-to-Speech.
The text to be synthesized, length limit less than 10,000 characters. Use newline characters for paragraph breaks. (To control pause duration in speech, add <#x#> between characters, where x is in seconds, supporting 0.01-99.99 with up to two decimal places). Supports custom time intervals between text segments to achieve custom speech pause durations. Note that text intervals must be set between two text segments that can be vocalized, and multiple consecutive time intervals cannot be set.
The voice ID for the request. Either this or timbre_weights is required.Supports both system voices (ID) and cloned voices (ID). The system voice IDs are as follows:
Youthful Male Voice: male-qn-qingse
Elite Young Male Voice: male-qn-jingying
Assertive Young Male Voice: male-qn-badao
College Male Voice: male-qn-daxuesheng
Young Female Voice: female-shaonv
Mature Female Voice (Confident): female-yujie
Mature Female Voice: female-chengshu
Sweet Female Voice: female-tianmei
Male Presenter: presenter_male
Female Presenter: presenter_female
Male Audiobook 1: audiobook_male_1
Male Audiobook 2: audiobook_male_2
Female Audiobook 1: audiobook_female_1
Female Audiobook 2: audiobook_female_2
Youthful Male Voice-beta: male-qn-qingse-jingpin
Elite Young Male Voice-beta: male-qn-jingying-jingpin
Assertive Young Male Voice-beta: male-qn-badao-jingpin
College Male Voice-beta: male-qn-daxuesheng-jingpin
This parameter enables English text normalization, which can improve performance in number reading scenarios but slightly increases latency. If not provided, defaults to false.
Possible values: [32000, 64000, 128000, 256000]The bitrate of the generated audio. Optional, Default: 128000. This parameter only applies to mp3 format audio.
Replace characters, symbols, and their corresponding pronunciations that require special annotation.Replace pronunciation (adjust tone/replace with other character pronunciation), format as follows:["yan-shao-fei/(yan4)(shao3)(fei1)","da-fei/(da2)(fei1)","omg/oh my god"]Tones are represented by numbers: 1st tone (high level) is 1, 2nd tone (rising) is 2, 3rd tone (dipping) is 3, 4th tone (falling) is 4, neutral tone is 5.
Range [1, 100]Weight, must be provided together with voice_id. Supports mixing up to 4 voices. Values must be integers; a higher proportion for a single voice results in a synthesized voice more similar to that voice.
When this parameter is set to True, the last chunk in streaming will not contain the concatenated complete audio hex data. Default: False, meaning the last chunk contains the concatenated complete audio hex data.
Enhances recognition of specified minority languages and dialects. When set, it can improve speech performance for the specified language/dialect. If the language type is unclear, you can select βautoβ and the model will automatically determine the language type. Supported values:'Chinese', 'Chinese,Yue', 'English', 'Arabic', 'Russian', 'Spanish', 'French', 'Portuguese', 'German', 'Turkish', 'Dutch', 'Ukrainian', 'Vietnamese', 'Indonesian', 'Japanese', 'Italian', 'Korean', 'Thai', 'Polish', 'Romanian', 'Greek', 'Czech', 'Finnish', 'Hindi', 'Bulgarian', 'Danish', 'Hebrew', 'Malay', 'Persian', 'Slovak', 'Swedish', 'Croatian', 'Filipino', 'Hungarian', 'Norwegian', 'Slovenian', 'Catalan', 'Nynorsk', 'Tamil', 'Afrikaans', 'auto'
Parameter that controls the output format. Possible values: url, hex. Default: hex. This parameter only takes effect in non-streaming scenarios; streaming scenarios only support hex output. The returned URL is valid for 24 hours.
Intensity adjustment (powerful/soft), range [-100, 100]. Values closer to -100 produce a more powerful sound; values closer to 100 produce a softer sound.
The synthesized audio segment, hex-encoded, generated in the format defined by the input (audio_setting.format) (mp3/pcm/flac). The return format is determined by output_format; when stream is true, only hex format is supported.