> ## Documentation Index
> Fetch the complete documentation index at: https://mulerouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MiniMax Speech 2.8 HD Text to Speech

> Create a text-to-speech generation task using the speech-2.8-hd model.

## Overview

Generate high-definition speech from text using the MiniMax Speech 2.8 HD model. Speech 2.8 HD delivers:

* **High-definition audio quality** — superior clarity and naturalness
* **Pause tags** — insert precise pauses with `<#x#>` syntax (x = 0.01-99.99 seconds)
* **Interjection tags** — add natural expressions like `(laughs)`, `(sighs)`, `(coughs)`, `(clears throat)`, `(gasps)`, `(sniffs)`, `(groans)`, `(yawns)`
* **Voice settings** — control speed, volume, pitch, and emotion
* **40+ languages** — extensive language support with language boost
* **Audio customization** — configurable format (MP3/PCM/FLAC), sample rate, channel, and bitrate
* **Voice modification** — fine-tune pitch, intensity, and timbre
* **Pronunciation dictionary** — custom pronunciation replacements
* **Loudness normalization** — professional audio level control

## Supported Voice IDs

| No. | Language            | Voice ID                                    | Voice Name                |
| :-- | :------------------ | :------------------------------------------ | :------------------------ |
| 1   | Chinese (Mandarin)  | `male-qn-qingse`                            | Youthful Male             |
| 2   | Chinese (Mandarin)  | `male-qn-jingying`                          | Elite Young Male          |
| 3   | Chinese (Mandarin)  | `male-qn-badao`                             | Dominant Young Male       |
| 4   | Chinese (Mandarin)  | `male-qn-daxuesheng`                        | College Student Male      |
| 5   | Chinese (Mandarin)  | `female-shaonv`                             | Young Girl                |
| 6   | Chinese (Mandarin)  | `female-yujie`                              | Mature Female             |
| 7   | Chinese (Mandarin)  | `female-chengshu`                           | Sophisticated Woman       |
| 8   | Chinese (Mandarin)  | `female-tianmei`                            | Sweet Woman               |
| 9   | Chinese (Mandarin)  | `male-qn-qingse-jingpin`                    | Youthful Male Beta        |
| 10  | Chinese (Mandarin)  | `male-qn-jingying-jingpin`                  | Elite Young Male Beta     |
| 11  | Chinese (Mandarin)  | `male-qn-badao-jingpin`                     | Dominant Young Male Beta  |
| 12  | Chinese (Mandarin)  | `male-qn-daxuesheng-jingpin`                | College Student Male Beta |
| 13  | Chinese (Mandarin)  | `female-shaonv-jingpin`                     | Young Girl Beta           |
| 14  | Chinese (Mandarin)  | `female-yujie-jingpin`                      | Mature Female Beta        |
| 15  | Chinese (Mandarin)  | `female-chengshu-jingpin`                   | Sophisticated Woman Beta  |
| 16  | Chinese (Mandarin)  | `female-tianmei-jingpin`                    | Sweet Woman Beta          |
| 17  | Chinese (Mandarin)  | `clever_boy`                                | Clever Boy                |
| 18  | Chinese (Mandarin)  | `cute_boy`                                  | Cute Boy                  |
| 19  | Chinese (Mandarin)  | `lovely_girl`                               | Lovely Girl               |
| 20  | Chinese (Mandarin)  | `cartoon_pig`                               | Cartoon Pig               |
| 21  | Chinese (Mandarin)  | `bingjiao_didi`                             | Clingy Brother            |
| 22  | Chinese (Mandarin)  | `junlang_nanyou`                            | Handsome Boyfriend        |
| 23  | Chinese (Mandarin)  | `chunzhen_xuedi`                            | Innocent Junior           |
| 24  | Chinese (Mandarin)  | `lengdan_xiongzhang`                        | Cool Senior               |
| 25  | Chinese (Mandarin)  | `badao_shaoye`                              | Bossy Young Master        |
| 26  | Chinese (Mandarin)  | `tianxin_xiaoling`                          | Sweet Ling                |
| 27  | Chinese (Mandarin)  | `qiaopi_mengmei`                            | Playful Cute Girl         |
| 28  | Chinese (Mandarin)  | `wumei_yujie`                               | Charming Mature Woman     |
| 29  | Chinese (Mandarin)  | `diadia_xuemei`                             | Coquettish Junior Girl    |
| 30  | Chinese (Mandarin)  | `danya_xuejie`                              | Elegant Senior Girl       |
| 31  | Chinese (Mandarin)  | `Chinese (Mandarin)_Reliable_Executive`     | Reliable Executive        |
| 32  | Chinese (Mandarin)  | `Chinese (Mandarin)_News_Anchor`            | News Anchor               |
| 33  | Chinese (Mandarin)  | `Chinese (Mandarin)_Mature_Woman`           | Mature Woman              |
| 34  | Chinese (Mandarin)  | `Chinese (Mandarin)_Unrestrained_Young_Man` | Unrestrained Young Man    |
| 35  | Chinese (Mandarin)  | `Arrogant_Miss`                             | Arrogant Miss             |
| 36  | Chinese (Mandarin)  | `Robot_Armor`                               | Robot Armor               |
| 37  | Chinese (Mandarin)  | `Chinese (Mandarin)_Kind-hearted_Antie`     | Kind-hearted Auntie       |
| 38  | Chinese (Mandarin)  | `Chinese (Mandarin)_HK_Flight_Attendant`    | HK Flight Attendant       |
| 39  | Chinese (Mandarin)  | `Chinese (Mandarin)_Humorous_Elder`         | Humorous Elder            |
| 40  | Chinese (Mandarin)  | `Chinese (Mandarin)_Gentleman`              | Gentleman                 |
| 41  | Chinese (Mandarin)  | `Chinese (Mandarin)_Warm_Bestie`            | Warm Bestie               |
| 42  | Chinese (Mandarin)  | `Chinese (Mandarin)_Male_Announcer`         | Male Announcer            |
| 43  | Chinese (Mandarin)  | `Chinese (Mandarin)_Sweet_Lady`             | Sweet Lady                |
| 44  | Chinese (Mandarin)  | `Chinese (Mandarin)_Southern_Young_Man`     | Southern Young Man        |
| 45  | Chinese (Mandarin)  | `Chinese (Mandarin)_Wise_Women`             | Wise Woman                |
| 46  | Chinese (Mandarin)  | `Chinese (Mandarin)_Gentle_Youth`           | Gentle Youth              |
| 47  | Chinese (Mandarin)  | `Chinese (Mandarin)_Warm_Girl`              | Warm Girl                 |
| 48  | Chinese (Mandarin)  | `Chinese (Mandarin)_Kind-hearted_Elder`     | Kind-hearted Elder        |
| 49  | Chinese (Mandarin)  | `Chinese (Mandarin)_Cute_Spirit`            | Cute Spirit               |
| 50  | Chinese (Mandarin)  | `Chinese (Mandarin)_Radio_Host`             | Radio Host                |
| 51  | Chinese (Mandarin)  | `Chinese (Mandarin)_Lyrical_Voice`          | Lyrical Voice             |
| 52  | Chinese (Mandarin)  | `Chinese (Mandarin)_Straightforward_Boy`    | Straightforward Boy       |
| 53  | Chinese (Mandarin)  | `Chinese (Mandarin)_Sincere_Adult`          | Sincere Adult             |
| 54  | Chinese (Mandarin)  | `Chinese (Mandarin)_Gentle_Senior`          | Gentle Senior             |
| 55  | Chinese (Mandarin)  | `Chinese (Mandarin)_Stubborn_Friend`        | Stubborn Friend           |
| 56  | Chinese (Mandarin)  | `Chinese (Mandarin)_Crisp_Girl`             | Crisp Girl                |
| 57  | Chinese (Mandarin)  | `Chinese (Mandarin)_Pure-hearted_Boy`       | Pure-hearted Boy          |
| 58  | Chinese (Mandarin)  | `Chinese (Mandarin)_Soft_Girl`              | Soft Girl                 |
| 59  | Chinese (Cantonese) | `Cantonese_ProfessionalHost（F)`             | Professional Female Host  |
| 60  | Chinese (Cantonese) | `Cantonese_GentleLady`                      | Gentle Lady               |
| 61  | Chinese (Cantonese) | `Cantonese_ProfessionalHost（M)`             | Professional Male Host    |
| 62  | Chinese (Cantonese) | `Cantonese_PlayfulMan`                      | Playful Man               |
| 63  | Chinese (Cantonese) | `Cantonese_CuteGirl`                        | Cute Girl                 |
| 64  | Chinese (Cantonese) | `Cantonese_KindWoman`                       | Kind Woman                |
| 65  | English             | `Santa_Claus`                               | Santa Claus               |
| 66  | English             | `Grinch`                                    | Grinch                    |
| 67  | English             | `Rudolph`                                   | Rudolph                   |
| 68  | English             | `Arnold`                                    | Arnold                    |
| 69  | English             | `Charming_Santa`                            | Charming Santa            |
| 70  | English             | `Charming_Lady`                             | Charming Lady             |
| 71  | English             | `Sweet_Girl`                                | Sweet Girl                |
| 72  | English             | `Cute_Elf`                                  | Cute Elf                  |
| 73  | English             | `Attractive_Girl`                           | Attractive Girl           |
| 74  | English             | `Serene_Woman`                              | Serene Woman              |
| 75  | English             | `English_Trustworthy_Man`                   | Trustworthy Man           |
| 76  | English             | `English_Graceful_Lady`                     | Graceful Lady             |
| 77  | English             | `English_Aussie_Bloke`                      | Aussie Bloke              |
| 78  | English             | `English_Whispering_girl`                   | Whispering Girl           |
| 79  | English             | `English_Diligent_Man`                      | Diligent Man              |
| 80  | English             | `English_Gentle-voiced_man`                 | Gentle-voiced Man         |
| 81  | Japanese            | `Japanese_IntellectualSenior`               | Intellectual Senior       |
| 82  | Japanese            | `Japanese_DecisivePrincess`                 | Decisive Princess         |
| 83  | Japanese            | `Japanese_LoyalKnight`                      | Loyal Knight              |
| 84  | Japanese            | `Japanese_DominantMan`                      | Dominant Man              |
| 85  | Japanese            | `Japanese_SeriousCommander`                 | Serious Commander         |
| 86  | Japanese            | `Japanese_ColdQueen`                        | Cold Queen                |
| 87  | Japanese            | `Japanese_DependableWoman`                  | Dependable Woman          |
| 88  | Japanese            | `Japanese_GentleButler`                     | Gentle Butler             |
| 89  | Japanese            | `Japanese_KindLady`                         | Kind Lady                 |
| 90  | Japanese            | `Japanese_CalmLady`                         | Calm Lady                 |
| 91  | Japanese            | `Japanese_OptimisticYouth`                  | Optimistic Youth          |
| 92  | Japanese            | `Japanese_GenerousIzakayaOwner`             | Generous Izakaya Owner    |
| 93  | Japanese            | `Japanese_SportyStudent`                    | Sporty Student            |
| 94  | Japanese            | `Japanese_InnocentBoy`                      | Innocent Boy              |
| 95  | Japanese            | `Japanese_GracefulMaiden`                   | Graceful Maiden           |
| 96  | Korean              | `Korean_SweetGirl`                          | Sweet Girl                |
| 97  | Korean              | `Korean_CheerfulBoyfriend`                  | Cheerful Boyfriend        |
| 98  | Korean              | `Korean_EnchantingSister`                   | Enchanting Sister         |
| 99  | Korean              | `Korean_ShyGirl`                            | Shy Girl                  |
| 100 | Korean              | `Korean_ReliableSister`                     | Reliable Sister           |
| 101 | Korean              | `Korean_StrictBoss`                         | Strict Boss               |
| 102 | Korean              | `Korean_SassyGirl`                          | Sassy Girl                |
| 103 | Korean              | `Korean_ChildhoodFriendGirl`                | Childhood Friend Girl     |
| 104 | Korean              | `Korean_PlayboyCharmer`                     | Playboy Charmer           |
| 105 | Korean              | `Korean_ElegantPrincess`                    | Elegant Princess          |
| 106 | Korean              | `Korean_BraveFemaleWarrior`                 | Brave Female Warrior      |
| 107 | Korean              | `Korean_BraveYouth`                         | Brave Youth               |
| 108 | Korean              | `Korean_CalmLady`                           | Calm Lady                 |
| 109 | Korean              | `Korean_EnthusiasticTeen`                   | Enthusiastic Teen         |
| 110 | Korean              | `Korean_SoothingLady`                       | Soothing Lady             |
| 111 | Korean              | `Korean_IntellectualSenior`                 | Intellectual Senior       |
| 112 | Korean              | `Korean_LonelyWarrior`                      | Lonely Warrior            |
| 113 | Korean              | `Korean_MatureLady`                         | Mature Lady               |
| 114 | Korean              | `Korean_InnocentBoy`                        | Innocent Boy              |
| 115 | Korean              | `Korean_CharmingSister`                     | Charming Sister           |
| 116 | Korean              | `Korean_AthleticStudent`                    | Athletic Student          |
| 117 | Korean              | `Korean_BraveAdventurer`                    | Brave Adventurer          |
| 118 | Korean              | `Korean_CalmGentleman`                      | Calm Gentleman            |
| 119 | Korean              | `Korean_WiseElf`                            | Wise Elf                  |
| 120 | Korean              | `Korean_CheerfulCoolJunior`                 | Cheerful Cool Junior      |
| 121 | Korean              | `Korean_DecisiveQueen`                      | Decisive Queen            |
| 122 | Korean              | `Korean_ColdYoungMan`                       | Cold Young Man            |
| 123 | Korean              | `Korean_MysteriousGirl`                     | Mysterious Girl           |
| 124 | Korean              | `Korean_QuirkyGirl`                         | Quirky Girl               |
| 125 | Korean              | `Korean_ConsiderateSenior`                  | Considerate Senior        |
| 126 | Korean              | `Korean_CheerfulLittleSister`               | Cheerful Little Sister    |
| 127 | Korean              | `Korean_DominantMan`                        | Dominant Man              |
| 128 | Korean              | `Korean_AirheadedGirl`                      | Airheaded Girl            |
| 129 | Korean              | `Korean_ReliableYouth`                      | Reliable Youth            |
| 130 | Korean              | `Korean_FriendlyBigSister`                  | Friendly Big Sister       |
| 131 | Korean              | `Korean_GentleBoss`                         | Gentle Boss               |
| 132 | Korean              | `Korean_ColdGirl`                           | Cold Girl                 |
| 133 | Korean              | `Korean_HaughtyLady`                        | Haughty Lady              |
| 134 | Korean              | `Korean_CharmingElderSister`                | Charming Elder Sister     |
| 135 | Korean              | `Korean_IntellectualMan`                    | Intellectual Man          |
| 136 | Korean              | `Korean_CaringWoman`                        | Caring Woman              |
| 137 | Korean              | `Korean_WiseTeacher`                        | Wise Teacher              |
| 138 | Korean              | `Korean_ConfidentBoss`                      | Confident Boss            |
| 139 | Korean              | `Korean_AthleticGirl`                       | Athletic Girl             |
| 140 | Korean              | `Korean_PossessiveMan`                      | Possessive Man            |
| 141 | Korean              | `Korean_GentleWoman`                        | Gentle Woman              |
| 142 | Korean              | `Korean_CockyGuy`                           | Cocky Guy                 |
| 143 | Korean              | `Korean_ThoughtfulWoman`                    | Thoughtful Woman          |
| 144 | Korean              | `Korean_OptimisticYouth`                    | Optimistic Youth          |
| 145 | Spanish             | `Spanish_SereneWoman`                       | Serene Woman              |
| 146 | Spanish             | `Spanish_MaturePartner`                     | Mature Partner            |
| 147 | Spanish             | `Spanish_CaptivatingStoryteller`            | Captivating Storyteller   |
| 148 | Spanish             | `Spanish_Narrator`                          | Narrator                  |
| 149 | Spanish             | `Spanish_WiseScholar`                       | Wise Scholar              |
| 150 | Spanish             | `Spanish_Kind-heartedGirl`                  | Kind-hearted Girl         |
| 151 | Spanish             | `Spanish_DeterminedManager`                 | Determined Manager        |
| 152 | Spanish             | `Spanish_BossyLeader`                       | Bossy Leader              |
| 153 | Spanish             | `Spanish_ReservedYoungMan`                  | Reserved Young Man        |
| 154 | Spanish             | `Spanish_ConfidentWoman`                    | Confident Woman           |
| 155 | Portuguese          | `Portuguese_SentimentalLady`                | Sentimental Lady          |
| 156 | Portuguese          | `Portuguese_BossyLeader`                    | Bossy Leader              |
| 157 | Portuguese          | `Portuguese_Wiselady`                       | Wise Lady                 |
| 158 | Portuguese          | `Portuguese_Strong-WilledBoy`               | Strong-willed Boy         |
| 159 | Portuguese          | `Portuguese_Deep-VoicedGentleman`           | Deep-voiced Gentleman     |
| 160 | Portuguese          | `Portuguese_UpsetGirl`                      | Upset Girl                |
| 161 | French              | `French_Male_Speech_New`                    | Level-Headed Man          |
| 162 | French              | `French_Female_News Anchor`                 | Patient Female Presenter  |
| 163 | French              | `French_CasualMan`                          | Casual Man                |
| 164 | French              | `French_MovieLeadFemale`                    | Movie Lead Female         |
| 165 | French              | `French_FemaleAnchor`                       | Female Anchor             |
| 166 | French              | `French_MaleNarrator`                       | Male Narrator             |
| 167 | Indonesian          | `Indonesian_SweetGirl`                      | Sweet Girl                |
| 168 | Indonesian          | `Indonesian_ReservedYoungMan`               | Reserved Young Man        |
| 169 | Indonesian          | `Indonesian_CharmingGirl`                   | Charming Girl             |
| 170 | Indonesian          | `Indonesian_CalmWoman`                      | Calm Woman                |
| 171 | Indonesian          | `Indonesian_ConfidentWoman`                 | Confident Woman           |
| 172 | Indonesian          | `Indonesian_CaringMan`                      | Caring Man                |
| 173 | Indonesian          | `Indonesian_BossyLeader`                    | Bossy Leader              |
| 174 | Indonesian          | `Indonesian_DeterminedBoy`                  | Determined Boy            |
| 175 | Indonesian          | `Indonesian_GentleGirl`                     | Gentle Girl               |
| 176 | German              | `German_FriendlyMan`                        | Friendly Man              |
| 177 | German              | `German_SweetLady`                          | Sweet Lady                |
| 178 | German              | `German_PlayfulMan`                         | Playful Man               |
| 179 | Russian             | `Russian_HandsomeChildhoodFriend`           | Handsome Childhood Friend |
| 180 | Russian             | `Russian_BrightHeroine`                     | Bright Queen              |
| 181 | Russian             | `Russian_AmbitiousWoman`                    | Ambitious Woman           |
| 182 | Russian             | `Russian_ReliableMan`                       | Reliable Man              |
| 183 | Russian             | `Russian_CrazyQueen`                        | Crazy Girl                |
| 184 | Russian             | `Russian_PessimisticGirl`                   | Pessimistic Girl          |
| 185 | Russian             | `Russian_AttractiveGuy`                     | Attractive Guy            |
| 186 | Russian             | `Russian_Bad-temperedBoy`                   | Bad-tempered Boy          |
| 187 | Italian             | `Italian_BraveHeroine`                      | Brave Heroine             |
| 188 | Italian             | `Italian_Narrator`                          | Narrator                  |
| 189 | Italian             | `Italian_WanderingSorcerer`                 | Wandering Sorcerer        |
| 190 | Italian             | `Italian_DiligentLeader`                    | Diligent Leader           |
| 191 | Arabic              | `Arabic_CalmWoman`                          | Calm Woman                |
| 192 | Arabic              | `Arabic_FriendlyGuy`                        | Friendly Guy              |
| 193 | Turkish             | `Turkish_CalmWoman`                         | Calm Woman                |
| 194 | Turkish             | `Turkish_Trustworthyman`                    | Trustworthy Man           |
| 195 | Ukrainian           | `Ukrainian_CalmWoman`                       | Calm Woman                |
| 196 | Ukrainian           | `Ukrainian_WiseScholar`                     | Wise Scholar              |
| 197 | Dutch               | `Dutch_kindhearted_girl`                    | Kind-hearted Girl         |
| 198 | Dutch               | `Dutch_bossy_leader`                        | Bossy Leader              |
| 199 | Vietnamese          | `Vietnamese_kindhearted_girl`               | Kind-hearted Girl         |
| 200 | Thai                | `Thai_male_1_sample8`                       | Serene Man                |
| 201 | Thai                | `Thai_male_2_sample2`                       | Friendly Man              |
| 202 | Thai                | `Thai_female_1_sample1`                     | Confident Woman           |
| 203 | Thai                | `Thai_female_2_sample2`                     | Energetic Woman           |
| 204 | Polish              | `Polish_male_1_sample4`                     | Male Narrator             |
| 205 | Polish              | `Polish_male_2_sample3`                     | Male Anchor               |
| 206 | Polish              | `Polish_female_1_sample1`                   | Calm Woman                |
| 207 | Polish              | `Polish_female_2_sample3`                   | Casual Woman              |
| 208 | Romanian            | `Romanian_male_1_sample2`                   | Reliable Man              |
| 209 | Romanian            | `Romanian_male_2_sample1`                   | Energetic Youth           |
| 210 | Romanian            | `Romanian_female_1_sample4`                 | Optimistic Youth          |
| 211 | Romanian            | `Romanian_female_2_sample1`                 | Gentle Woman              |
| 212 | Greek               | `greek_male_1a_v1`                          | Thoughtful Mentor         |
| 213 | Greek               | `Greek_female_1_sample1`                    | Gentle Lady               |
| 214 | Greek               | `Greek_female_2_sample3`                    | Girl Next Door            |
| 215 | Czech               | `czech_male_1_v1`                           | Assured Presenter         |
| 216 | Czech               | `czech_female_5_v7`                         | Steadfast Narrator        |
| 217 | Czech               | `czech_female_2_v2`                         | Elegant Lady              |
| 218 | Finnish             | `finnish_male_3_v1`                         | Upbeat Man                |
| 219 | Finnish             | `finnish_male_1_v2`                         | Friendly Boy              |
| 220 | Finnish             | `finnish_female_4_v1`                       | Assertive Woman           |
| 221 | Hindi               | `hindi_male_1_v2`                           | Trustworthy Advisor       |
| 222 | Hindi               | `hindi_female_2_v1`                         | Tranquil Woman            |
| 223 | Hindi               | `hindi_female_1_v2`                         | News Anchor               |


## OpenAPI

````yaml api-reference/endpoint/minimax/speech-2.8-hd/speech-2.8-hd.yaml POST /vendors/minimax/v1/speech-2.8-hd/text-to-speech/generation
openapi: 3.1.0
info:
  title: MiniMax Speech 2.8 HD API
  description: MiniMax Speech 2.8 HD - High-Definition Text-to-Speech Generation
  version: 2.0.0
servers:
  - url: https://api.mulerouter.ai/
security:
  - bearerAuth: []
paths:
  /vendors/minimax/v1/speech-2.8-hd/text-to-speech/generation:
    post:
      summary: Create Speech Generation Task
      description: Create a text-to-speech generation task using the speech-2.8-hd model.
      operationId: speech_2_8_hd_create
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SpeechGenerationRequest'
            example:
              prompt: >-
                Hello world! Welcome to MiniMax's new text to speech model
                <#0.1#> Speech 2.8 HD (laughs) now available!
              voice_setting:
                voice_id: Wise_Woman
                speed: 1
                vol: 1
                pitch: 0
              output_format: url
      responses:
        '202':
          description: Accepted - Task created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaskCreatedResponse'
              example:
                task_info:
                  id: 8e1e315e-b50d-4334-a231-be7d19a372f4
                  status: pending
                  created_at: '2026-03-03T00:00:00Z'
                  updated_at: '2026-03-03T00:00:00Z'
components:
  schemas:
    SpeechGenerationRequest:
      type: object
      required:
        - prompt
      properties:
        prompt:
          type: string
          minLength: 1
          maxLength: 10000
          description: >
            Text to convert to speech. Use `<#x#>` for pauses (x = 0.01-99.99
            seconds). Supports interjection tags: `(laughs)`, `(sighs)`,
            `(coughs)`, `(clears throat)`, `(gasps)`, `(sniffs)`, `(groans)`,
            `(yawns)`.
        voice_setting:
          $ref: '#/components/schemas/VoiceSetting'
          description: Voice configuration settings (optional, defaults to Wise_Woman).
        audio_setting:
          anyOf:
            - $ref: '#/components/schemas/AudioSetting'
            - type: 'null'
          description: Audio configuration settings.
        language_boost:
          anyOf:
            - type: string
              enum:
                - 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
                - Slovak
                - Swedish
                - Croatian
                - Hungarian
                - Norwegian
                - Slovenian
                - Catalan
                - Nynorsk
                - Afrikaans
                - auto
            - type: 'null'
          description: Enhance recognition of specified languages and dialects.
        output_format:
          type: string
          enum:
            - url
            - hex
          default: hex
          description: 'Format of the output content (non-streaming only). Default: hex.'
        pronunciation_dict:
          anyOf:
            - $ref: '#/components/schemas/PronunciationDict'
            - type: 'null'
          description: Custom pronunciation dictionary for text replacement.
        normalization_setting:
          anyOf:
            - $ref: '#/components/schemas/LoudnessNormalizationSetting'
            - type: 'null'
          description: Loudness normalization settings for the audio.
        voice_modify:
          anyOf:
            - $ref: '#/components/schemas/VoiceModify'
            - type: 'null'
          description: Voice modification settings to adjust pitch, intensity, and timbre.
    TaskCreatedResponse:
      type: object
      properties:
        task_info:
          $ref: '#/components/schemas/TaskInfoCreated'
    VoiceSetting:
      type: object
      properties:
        voice_id:
          type: string
          description: >-
            Voice ID for synthesis. Examples - Chinese: male-qn-qingse,
            female-shaonv, female-yujie; English: Charming_Lady,
            English_Trustworthy_Man, English_Graceful_Lady. See the Supported
            Voice IDs section in the overview for the full list.
        speed:
          type: number
          minimum: 0.5
          maximum: 2
          default: 1
          description: Speech speed, range [0.5, 2.0].
        vol:
          type: number
          minimum: 0.01
          maximum: 10
          default: 1
          description: Volume, range [0, 10].
        pitch:
          type: integer
          minimum: -12
          maximum: 12
          default: 0
          description: Voice pitch, range [-12, 12].
        emotion:
          anyOf:
            - type: string
              enum:
                - happy
                - sad
                - angry
                - fearful
                - disgusted
                - surprised
                - neutral
            - type: 'null'
          description: Emotion of the generated speech.
        english_normalization:
          type: boolean
          default: false
          description: >-
            Enables English text normalization to improve number reading
            performance.
    AudioSetting:
      type: object
      properties:
        format:
          type: string
          enum:
            - mp3
            - pcm
            - flac
          default: mp3
          description: Audio format.
        sample_rate:
          type: integer
          enum:
            - 8000
            - 16000
            - 22050
            - 24000
            - 32000
            - 44100
          default: 32000
          description: Sample rate of generated audio (Hz).
        channel:
          type: integer
          enum:
            - 1
            - 2
          default: 1
          description: Number of audio channels (1=mono, 2=stereo).
        bitrate:
          type: integer
          enum:
            - 32000
            - 64000
            - 128000
            - 256000
          default: 128000
          description: Bitrate of generated audio (bps).
    PronunciationDict:
      type: object
      properties:
        tone_list:
          type: array
          items:
            type: string
          description: >-
            List of pronunciation replacements in format
            ['text/(pronunciation)', ...].
    LoudnessNormalizationSetting:
      type: object
      properties:
        enabled:
          type: boolean
          default: true
          description: Enable loudness normalization for the audio.
        target_loudness:
          type: number
          minimum: -70
          maximum: -10
          default: -18
          description: Target loudness in LUFS.
        target_range:
          type: number
          minimum: 0
          maximum: 20
          default: 8
          description: Target loudness range in LU.
        target_peak:
          type: number
          minimum: -3
          maximum: 0
          default: -0.5
          description: Target peak level in dBTP.
    VoiceModify:
      type: object
      properties:
        pitch:
          type: integer
          minimum: -100
          maximum: 100
          default: 0
          description: 'Pitch adjustment. Range: -100 to 100.'
        intensity:
          type: integer
          minimum: -100
          maximum: 100
          default: 0
          description: 'Intensity/energy of the voice. Range: -100 to 100.'
        timbre:
          type: integer
          minimum: -100
          maximum: 100
          default: 0
          description: 'Timbre adjustment. Range: -100 to 100.'
    TaskInfoCreated:
      type: object
      required:
        - id
        - status
        - created_at
        - updated_at
      properties:
        id:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - pending
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````