> ## Documentation Index
> Fetch the complete documentation index at: https://www.carrothub.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.carrothub.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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.