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

# MiniMax Preset Voice List



## OpenAPI

````yaml openapi/en/configs-minimax-preset-voice-id.json GET /v1/configs/minimax-preset-voice-id
openapi: 3.1.0
info:
  title: MiniMax Preset Voice List
  version: '1.0'
servers:
  - url: https://api.aihubmax.com
security:
  - BearerAuth: []
paths:
  /v1/configs/minimax-preset-voice-id:
    get:
      tags:
        - Config Query
      summary: Query MiniMax Preset Voice List
      operationId: configs-minimax-preset-voice-id
      parameters:
        - name: language
          in: query
          required: false
          schema:
            type: string
            enum:
              - zh
              - en
            default: zh
            example: zh
          description: >-
            Language version of the returned data: `zh` (Chinese, default) /
            `en` (English). The `voice_id` is identical between the two
            versions; only the `voice_name` / `language` / `accent` / `gender` /
            `age` / `tag_list` / `description` text switches with the language.
      responses:
        '200':
          description: Query successful — returns an array of preset voices
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MinimaxVoicePreset'
              examples:
                zh_sample:
                  summary: Chinese version (excerpt, 2 entries)
                  value:
                    - id: '298735722549316'
                      voice_id: Afrikaans_female_1_v1
                      voice_name: Outgoing Girl
                      language: 阿非利卡语
                      accent: 标准口音
                      gender: 女
                      age: 青年
                      tag_list:
                        - 广告与预告
                        - 播客与社媒
                        - 企业宣传与旁白
                        - 明亮清脆
                        - 语速轻快
                        - 电台主播感
                      cover_url: >-
                        https://cdn.hailuoai.video/moss/staging/2024-11-21-14/moss-audio/voice_cover//1732170987980918894-207331589840977.png?x-oss-process=image/resize,p_50/format,webp
                      sample_audio: >-
                        https://filecdn.minimax.chat/public/6579ac88-28ed-46a4-b930-eed7602faa1d.mp3
                      description: >-
                        这是一个充满活力的青年女声。其声线明亮清脆且极具穿透力，说话节奏语速轻快、干脆利落。整体风格热情洋溢且具有极强的感染力，自带一种专业的电台主播感，非常适合用于商业广告、社交媒体短视频或快节奏的广播节目等场景。
                    - id: '295'
                      voice_id: Arabic_CalmWoman
                      voice_name: Calm Woman
                      language: 阿拉伯语
                      accent: ''
                      gender: 女
                      age: 中年
                      tag_list: []
                      cover_url: ''
                      sample_audio: >-
                        https://ftres.oss-cn-beijing.aliyuncs.com/aitools/voices/Arabic_CalmWoman_audio.mp3
                      description: ''
                en_sample:
                  summary: English version (excerpt, 2 entries)
                  value:
                    - id: '298712934264945'
                      voice_id: Afrikaans_female_1_v1
                      voice_name: Outgoing Girl
                      language: Afrikaans
                      accent: Standard
                      gender: Female
                      age: Young
                      tag_list:
                        - Commercials & Trailers
                        - Podcasts & Social
                        - Corporate & Narration
                        - Bright
                        - Crisp
                        - Resonant
                      cover_url: >-
                        https://ftapp.oss-cn-beijing.aliyuncs.com/aitools/voices/Afrikaans_female_1_v1_cover.png
                      sample_audio: >-
                        https://ftapp.oss-cn-beijing.aliyuncs.com/aitools/voices/Afrikaans_female_1_v1_audio.mp3
                      description: >-
                        Bright, clean, and strongly projected, with a fast,
                        rhythmic delivery that feels broadcast-ready. Best for
                        news updates, community announcements, station imaging,
                        and promo reads that need an energetic, articulate host
                        sound.
                    - id: '295'
                      voice_id: Arabic_CalmWoman
                      voice_name: Calm Woman
                      language: Arabic
                      accent: ''
                      gender: Female
                      age: Middle-aged
                      tag_list: []
                      cover_url: ''
                      sample_audio: >-
                        https://ftres.oss-cn-beijing.aliyuncs.com/aitools/voices/Arabic_CalmWoman_audio.mp3
                      description: ''
        '400':
          description: Invalid `language` parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: 'Unsupported language ''fr''. Allowed: [''en'', ''zh'']'
                  type: invalid_request_error
                  code: invalid_language
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Config key not registered
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  message: >-
                    Unknown config key 'xxx'. Available keys:
                    ['minimax-preset-voice-id']
                  type: invalid_request_error
                  code: config_not_found
components:
  schemas:
    MinimaxVoicePreset:
      type: object
      description: A single MiniMax preset voice record
      required:
        - id
        - voice_id
        - voice_name
      properties:
        id:
          type: string
          description: >-
            Internal database ID of the voice (numeric string) — for internal
            traceability only; **do not** pass it to speech synthesis requests
          example: '295'
        voice_id:
          type: string
          description: >-
            Voice ID. **This is the value to pass directly into the
            `voice_setting.voice_id` field of speech synthesis requests.**
          example: Arabic_CalmWoman
        voice_name:
          type: string
          description: >-
            Display name of the voice (switches between Chinese / English based
            on `language`)
          example: Calm Woman
        language:
          type: string
          description: >-
            Language the voice belongs to (switches between Chinese / English
            based on `language`, e.g. `Arabic` / `阿拉伯语`, `Chinese (Mandarin)` /
            `中文-普通话`)
          example: Arabic
        accent:
          type: string
          description: >-
            Accent tag (switches between Chinese / English based on `language`,
            e.g. `Standard` / `标准口音`). May be an empty string for some newer
            entries.
          example: Standard
        gender:
          type: string
          description: >-
            Gender (switches between Chinese / English based on `language`, e.g.
            `Male` / `Female` / `Character`, or `男` / `女` / `角色`)
          example: Female
        age:
          type: string
          description: >-
            Age group (switches between Chinese / English based on `language`,
            e.g. `Young` / `Middle-aged` / `Elderly` / `Child`, or `青年` / `中年` /
            `老年` / `儿童`). May be an empty string for some newer entries.
          example: Middle-aged
        tag_list:
          type: array
          items:
            type: string
          description: >-
            Style / scene tag list (switches between Chinese / English based on
            `language`). May be an empty array for some newer entries.
        cover_url:
          type: string
          description: Cover image URL. May be an empty string for some newer entries.
        sample_audio:
          type: string
          description: Sample audio URL (we recommend previewing it before selection)
        description:
          type: string
          description: >-
            Textual description of the voice (switches between Chinese / English
            based on `language`). May be an empty string for some newer entries.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            code:
              type: string
    ErrorResponse401:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              example: Invalid API key
            type:
              type: string
              example: authentication_error
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse401'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        ## All APIs require Bearer Token authentication ##

        Add to request header:

        `Authorization: Bearer YOUR_API_KEY`

````